技能介绍

要解决什么问题

在 Agent 里做 Seedance 2.0 视频生成时，常见坑是：只调了「创建任务」就结束、参数越界导致计费与效果不可控、真人参考素材未走审核就直接传 URL，以及失败后静默重试把成本叠上去。本技能把流程固定为：先校验 → 异步创建 → 轮询查询 → 返回终态（success / failed / timeout），并约束 duration、resolution、business_url 与模型名的对应关系。

技能如何工作

参数确认：若用户未明确 modelName、resolution、ratio、duration，会先确认再调用（影响价格与成片效果）。
模型与路由：seedance2.0 / seedance2.0-fast / seedance2.0-mini 会归一到 KVideo2.0 系列，并匹配 business_url（如 Fast → volcengine/ai/20/i2v-fast）。
任务类型：modelType 默认 auto——纯文本为 text2video；有图参考为 img2video；多模态参考为 mixVideo；首尾帧为 frame2video；不确定时会先问用户。
真人素材：需先通过 seedance2.0-face-review 拿到 asset_id，调用时把参考 URL 写成 asset://{id}，而不是裸 ID。
API 流程：POST /api/v1/user_task/asyncCreateWithCost 取任务 ID，再用 GET /api/v1/user_task/get/passAuth/{id} 轮询，解析 task_status、service_output.videoUrl / failReason、cost。
安全与密钥：x-api-key 从环境变量或 ~/.config/seedance2.0/.env 读取，回复中不得泄露完整 key。

适用边界与注意点

适合：文生/图生/混合输入视频、需要 MP4 链接 与任务状态、已具备审核通过的 asset_id。
不适合：纯静态图、OCR/字幕/文档解析、本地剪辑拼接。
禁止自动重试创建：创建失败、任务失败或超时只汇报原因与建议，必须征得用户同意后才能用相同参数再提交。
固定项：cost_type=3，duration 仅 [4,15]，resolution 仅 480p / 720p。历史别名 Kvideo2.0、2.0-fast 等与当前 seedance2.0 系列为同一套接口命名，沟通时优先用 seedance 写法避免歧义。