图片视频漫剧AI全能生成工坊

概述

清绘画板·文生视频与文生图

Skill 根目录

记为 <SKILL_ROOT>：本 SKILL.md 所在目录。若该路径是目录联接或符号链接，解析到真实目录后再用。不要把某台机器的绝对路径写进本文。

• Windows 解释器：<SKILL_ROOT>.venvScriptspython.exe
• macOS / Linux 解释器：<SKILL_ROOT>/.venv/bin/python
• 配置：<SKILL_ROOT>/settings.json（Windows 可用反斜杠）
• 密钥：同目录私有 .env（勿输出到聊天）

下文命令里的解释器与 --settings 都按上面解析后再执行。工作目录可以是当前 Cursor 工作区，不必先 cd 到 Skill 根目录。

使用原则

本 Skill 用于真实文生视频 / 文生图任务。

执行过程中优先直接完成用户请求，不向用户展示环境检查、依赖安装、镜像切换、临时文件、内部重试等实现细节。

只有在环境准备最终失败、需要浏览器授权、需要私密输入 API Key、额度不足、任务无法继续恢复或必须由用户介入时，才向用户说明。

不要将 API Key、授权码、OAuth code、签名下载地址中的敏感参数或其他凭证输出到聊天、日志或普通结果文件中。API Key 仅允许保存在 Skill 根目录的私有 .env 中；逐任务授权码仅随对应任务保存在本地状态数据库中。

对接说明见同目录 INTEGRATION.md。真实模式必须通过 --settings 指定上述 settings.json。

环境准备

执行任务前静默检查并准备运行环境。整个 Skill 必须使用同一个项目本地隔离环境。

要求：

• Python 3.13+
• 项目根目录下使用 .venv
• httpx
• pydantic 2

缺少 .venv 或依赖时允许自动准备。优先 uv，否则 pip；镜像顺序：清华 → 阿里 → 华为。

虚拟环境解释器：

• macOS / Linux：.venv/bin/python
• Windows：.venvScriptspython.exe

统一通过：

<SKILL_ROOT>/.venv/bin/python -m scripts

Windows 将解释器换成 <SKILL_ROOT>.venvScriptspython.exe。

凭证配置

真实任务前检查 API Key。缺失或无效时提供：

1. 浏览器授权并自动配置（推荐）
2. 通过私密输入方式填写已有 API Key
3. 取消

<解释器> -m scripts --login --settings <SKILL_ROOT>/settings.json

或：

<解释器> -m scripts --configure-key --settings <SKILL_ROOT>/settings.json

浏览器登录使用画板专属 Native OAuth 客户端 xiaoban-draw（能力 skill-xiaoban-draw），地址以 settings.json 为准（生产模板见 settings.example.json）：

• 授权页：https://www.qingfengyq.com/oauth/authorize
• API / OAuth 换票：https://www.qingfengyq.com/api/v1

换取的是账号级 API Key，写入 Skill 根目录私有 .env。也可用 --configure-key 手动填入已有 Key。

管理端对应关系

管理端该工具绑定超时请调到足够大（建议 ≥ 600000ms），否则会 504。

若文生图工具 ID 或路径与默认值不同，只需改 settings.json 的 image 段，无需改代码。

执行任务

在本次会话第一次开始真实生成之前，先向用户明确说明一次：

提示词将提交到清风进行处理；若启用逐任务授权会预占对应额度。

参数取值范围（唯一权威，校验以此为准）

下列名称须精确匹配（大小写、连字符）。不在表内的模型名、或不属于该模型允许的分辨率/时长，一律视为非法。

视频模型

图片模型

时长单位为秒；用户说「10s / 10秒」按整数秒解析。分辨率写法须与表内一致（如 720p、2K，不要写成 720、2k 而不规范化——可先规范化再校验：2k→2K，720P→720p）。

参数确认（强制，生成前必须做）

在调用任何真实生成命令（--backend real）之前，必须先把本次参数发给用户确认；未得到明确确认前禁止开跑（不要边问边生成）。

1. 从 settings.json 的 coze_content_defaults 取默认值；若默认值不在上表合法组合内，则改用该模式的安全默认：
   • 视频：Seedance-2.0-mini + 720p + 4
   • 图片：QingHui-image2.5 + 2K
2. 若用户话里已指定模型 / 分辨率 / 时长，用用户值覆盖，再做合法性校验。
3. 展示确认清单时，必须附带「可选模型列表」（及当前所选模型下的可选分辨率；视频再附时长范围），方便用户改选。
4. 询问「确认按此参数生成？还可直接说要换的模型/分辨率/时长」。
5. 用户回复确认后，再用最终参数拼 CLI；若只改了参数，更新清单（仍带可选列表）再确认一次（用户明确说「直接按我说的生成」可跳过二次确认）。
6. 参数不匹配时禁止生成：明确指出哪一项非法、该模型允许的取值，并请用户重选；不要擅自改成别的合法值后直接开跑（除非用户说「帮我改成合法的」）。
7. 批量任务：对每个任务分别确认，或一次列出全部任务参数请用户一并确认。

校验规则（Agent 必须执行）：

• 模型名必须在上表中。
• 分辨率必须属于该模型的可选分辨率集合。
• 视频时长必须为整数，且落在该模型的时长闭区间内。
• 图片任务不得接收 --time；视频任务必须确认时长。

非法提示示例：

参数不合法：模型 Seedance-2.0-mini 仅支持分辨率 720p，不支持 1080p。
该模型可选：分辨率 720p；时长 4–15 秒。
请重新选择后再确认。

文生图 / 图生图 — 必须确认：模型、分辨率

确认话术示例（须含可选模型列表）：

即将生成图片，请确认参数：
- 提示词：……
- 模型：QingHui-image2.5
- 分辨率：2K

可选模型与分辨率：
- QingHui-image2.5：1K / 2K / 4K
- QingHui-image2：2K / 4K
- Seedream5.0-pro：2K / 4K
- Seedream5.0：2K / 4K
- Seedream4.5：2K / 4K
- QingHui-banana.2：1K / 2K / 4K

回复「确认」继续，或直接说要改的模型/分辨率。

文生视频 — 必须确认：模型、分辨率、时长

确认话术示例（须含可选模型列表）：

即将生成视频，请确认参数：
- 提示词：……
- 模型：Seedance-2.0-mini
- 分辨率：720p
- 时长：4 秒

可选模型与限制：
- Seedance-2.5：480p/720p/1080p，时长 4–30 秒
- Seedance-2.0：720p/1080p，时长 4–15 秒
- Seedance-2.0-mini：720p，时长 4–15 秒
- Seedance-2.0-fast：720p，时长 4–15 秒

回复「确认」继续，或直接说要改的模型/分辨率/时长。

确认后的 CLI 必须显式带上已确认的 --model / --resolution（视频再加 --time），且三者必须已通过上表校验。

工作目录

默认：

<当前工作区>/文生视频结果/

或文生图时使用：

<当前工作区>/文生图结果/

作为 --work-dir。最终产物示例：

文生视频结果/
├── skill_state.sqlite3
└── 一只在月球上骑自行车的猫/
    ├── prompt.txt
    └── video.mp4

下列命令中的 <解释器> 与 <SKILL_ROOT> 按上文「Skill 根目录」解析；--work-dir 必须落在当前 Cursor 工作区内。仅在完成「参数确认」且用户同意后执行。

文生视频

<解释器> -m scripts "一只在月球上骑自行车的猫" --mode video --model Seedance-2.0-mini --resolution 720p --time 4 --backend real --settings <SKILL_ROOT>/settings.json --work-dir "<当前工作区>/文生视频结果"

用户如果说「用 Seedance-2.5 生成小狗跳舞视频」「时长 8 秒」之类：先校验合法、写入确认清单（含可选模型表），用户确认后再落到 CLI（不要只把参数写进提示词）：

<解释器> -m scripts "小狗跳舞" --mode video --model Seedance-2.5 --resolution 720p --time 8 --backend real --settings <SKILL_ROOT>/settings.json --work-dir "<当前工作区>/文生视频结果"

可选覆盖：--model / --time / --resolution / --size / --model-quality（覆盖 settings.json 里对应默认值）。

文生图

<解释器> -m scripts "赛博朋克风格的城市夜景海报" --mode image --model QingHui-image2.5 --resolution 2K --backend real --settings <SKILL_ROOT>/settings.json --work-dir "<当前工作区>/文生图结果"

图生图

同样先确认模型与分辨率，再执行：

<解释器> -m scripts "换成水彩风格" --mode image --model QingHui-image2.5 --resolution 2K --backend real --settings <SKILL_ROOT>/settings.json --work-dir "<当前工作区>/文生图结果" --image-url "https://example.com/ref.jpg"

Coze additional_messages.content 为业务 JSON 字符串（含 question / model / image 等）；pattern 暂不传。

批量

[
  {"prompt": "小狗跳舞", "mode": "video", "model": "Seedance-2.0-mini", "resolution": "720p", "time": 8},
  {"prompt": "水彩风山间小屋", "mode": "image", "model": "QingHui-image2.5", "resolution": "2K"}
]

<解释器> -m scripts --prompts-json prompts.json --backend real --settings <SKILL_ROOT>/settings.json --work-dir "<当前工作区>/媒体生成结果"

启动后保持进程运行直到任务结束。已有远端任务 ID 后，不得因参考耗时到了就重新创建任务。

恢复任务

<解释器> -m scripts --resume BATCH_ID --backend real --settings <SKILL_ROOT>/settings.json --work-dir "<当前工作区>/文生视频结果"

原则与录音 Skill 相同：已有远端任务只继续查询；不重复授权、不重复创建。

额度不足（HTTP 402）

skill-auth/issue 返回 402 表示计费/余额问题（如 PLATFORM_BILLING_BALANCE_NOT_ENOUGH、规则未上架），不是浏览器 OAuth 登录失败。

• 浏览器授权弹窗：仅在没有 API Key、或 Key 无效（401）时出现（--login）
• 402：向用户提示前往 清风官网 充值 / 确认该 Skill 已上架计费，完成后回复「已充值」再恢复

不要把 402 当成「再弹一次授权网页」。不要自动打开充值页或轮询付款。

结果交付

只汇报：

• 成功 / 失败 / 待恢复数量
• 每个成功任务的媒体路径（视频或图片）
• 需要用户介入时的下一步

不要展示环境安装、SQLite、内部状态码等细节。

安全与恢复原则

• 不在普通聊天中收集 API Key
• 不输出秘密凭证
• 不通过重复提交解决未知状态
• 有远端任务 ID 时只继续查询原任务
• 只有后端明确失败终态才判失败
• 最终 work-dir 必须位于当前工作区内部