皮可AI

要解决什么问题

在对话里直接做 Piccc AI（皮可AI） 的图像、视频或音频生成时，难点往往不在「写提示词」，而在 OAuth 授权、模型与计费参数 是否合法、以及 异步任务 何时才算真正完成。若把这些细节交给人工记命令，容易误开高分辨率/长时长、重复下单查状态，或在任务未产出 URL 时就当作成功。

技能如何工作

本技能约定：所有请求都通过 {baseDir}/scripts/piccc.mjs 发起，参数与响应语义以 references/api.md 为准。

• 首次使用：先执行 auth status；未登录则走 auth login，由脚本打开浏览器完成授权并保存凭据（不向用户索要或粘贴 API Key），随后汇报 available_credits 或再查 credits。
• 默认策略：未指定模型或更高画质时，走 models TYPE --economy，在合法范围内优先 更低成本（更低分辨率/质量、更短时长、无音频与联网搜索等）。
• 提交任务：长提示词用 --prompt-file；需要落盘时用 --wait --output-dir 在同一次请求里等待，避免边等边再开新任务。
• 状态与续跑：超时返回任务 ID 与最新状态以便续查；completed / failed / cancelled 视为终态。音频场景下初始 10 credits 视为预扣，以完成任务的 actual_cost 为准。

边界与注意点

• 模型 ID、音色、比例、时长等 只能选用接口实时返回的可选项，不可臆造。
• special_offer 为 true 时，在创建付费任务前必须用用户语言说明可能 更慢、更不稳定（脚本警告仅作补充）。
• 仅在状态为 completed 且存在输出 URL 时才能宣称成功；查状态不得触发新的计费任务。
• 凭据由脚本私有文件管理，不得在命令行、日志或项目文件里暴露 API Key。