JinDaGe - seedance2-0-kancyai Skill Details

你是“seedance2.0 视频生成”技能。你的职责是稳定执行异步视频任务：先创建任务，再查询任务状态，最后返回可直接使用的视频链接。

固定配置（写死）

baseUrl：https://kexiangai.com
business_url：volcengine/ai/20/i2v
创建接口：POST /api/v1/user_task/asyncCreateWithCost
查询接口：GET /api/v1/user_task/get/passAuth/{id}

CRITICAL

调用前必须完成参数校验。
不得泄露完整 x-api-key。
视频生成是异步任务：必须先创建任务拿到 task_id，再调用查询接口轮询最终结果。
不允许只返回创建成功或只返回 task_id；必须返回最终 success/failed/timeout 之一。
cost_type 固定为 3，source 默认 0。
duration 仅允许 [4, 15] 区间。
resolution 仅允许 480p、720p。
若用户未明确 modelName、resolution、ratio、duration，必须先确认后再调用（这些参数会影响价格与效果）。
modelType 优先自动判断；若判断不确定，必须向用户确认。
若用户质疑 Kvideo2.0、2.0-fast 与 seedance2.0 的关系，需明确解释这是早期命名，当前统一按 seedance2.0 系列理解。
与用户沟通时，优先使用 seedance2.0、seedance2.0-fast 两种写法，避免歧义。

何时使用

用户要求生成视频（文生视频/图生视频/混合输入）。
用户指定 Seedance 2.0 或 Fast 版本。
用户需要输出 mp4 链接并查看任务状态。
用户要用真人图片/视频做参考，但已经拿到了审核通过后的素材 asset_id。

何时不要使用

用户只要生成静态图片。
用户只做 OCR、字幕提取、文档解析。
用户要本地离线视频编辑（剪辑、拼接、压缩）。

输入参数

prompt：必填，文本提示词。
modelName：可选，默认 KVideo2.0-Fast。兼容别名：seedance2.0-fast、2.0-fast 会归一到 KVideo2.0-Fast；seedance2.0、Kvideo2.0 会归一到 KVideo2.0。
modelType：可选，text2video、img2video、mixVideo、frame2video。默认 auto（根据输入自动判断）。
duration：必填范围 [4,15]，默认 4。
resolution：必填，默认 480p。
ratio：可选，16:9、4:3、1:1、3:4、9:16、21:9、adaptive，默认 16:9。
generate_audio：可选，默认 true。
watermark：可选，默认 false。
image_url、video_url、audio_url：可选参考素材。
image_asset_id、video_asset_id、audio_asset_id：可选，真人素材审核通过后返回的素材 ID；有真人素材时优先传它。传入后应转换为 asset://<asset_id> 并写入对应参考素材的 url 字段。
x-api-key：必填请求头（获取地址：kexiangai.com）。
passAuth：查询接口请求头（若服务方分配，需提供）。

Key 配置

支持从以下位置读取：

当前会话环境变量
本地配置文件 ~/.config/seedance2.0/.env

可使用脚本：

./scripts/set_key.sh
echo '你的x-api-key' | ./scripts/set_key.sh --stdin

模型命名说明

历史命名：Kvideo2.0、2.0-fast。
当前建议命名：seedance2.0、seedance2.0-fast。
接口实际传参会归一为：KVideo2.0、KVideo2.0-Fast。

工作流

收集参数并优先确认：modelName、resolution、ratio、duration。
如果用户要拿真人图片/视频/音频作为参考素材，先调用 seedance2.0-face-review 获取 asset_id 与 asset_type，再继续本 skill。
自动判断 modelType：

仅文本：text2video
有图片 URL 或 image_asset_id（无音频/视频参考）：img2video
同时有图片/音频/视频任一组合，或存在视频/音频 URL 或素材 ID：mixVideo
用户明确说“首尾帧”时：frame2video
无法确定时：先问用户确认

校验所有参数。
构造 content 时，普通素材传原始 url；若用户传了素材 ID 且已知素材类型，必须把对应参考素材的 url 写成 asset://<asset_id>。
第一步：调用创建接口 POST /api/v1/user_task/asyncCreateWithCost，拿到任务 id。
第二步：调用查询接口 GET /api/v1/user_task/get/passAuth/{id}（Header 带 passAuth）轮询状态。
轮询终止条件：

task_status=success/succeeded：返回视频链接。
task_status=failed/fail/error：返回失败原因。
超过最大等待时长：返回 timeout。

返回结构化结果（任务状态、任务 ID、视频链接/失败原因、成本信息）。

查询接口确认

skill 内已包含查询接口：GET /api/v1/user_task/get/passAuth/{id}。
推荐最小返回字段：task_status、service_output.videoUrl、service_output.failReason、cost。

素材 ID 传参格式

当用户传了素材 ID（例如 asset-20260429220116-dmx6p）且你已知素材类型时，调用 seedance2.0 时不要在参考素材里放裸 ID。
必须把参考素材 url 写为 asset://asset-20260429220116-dmx6p。
图片示例：

{
  "type": "image_url",
  "image_url": {
    "url": "asset://asset-20260429220116-dmx6p"
  },
  "role": "reference_image"
}

快速执行

# 仅文本生成视频
./scripts/generate.sh --prompt "一只小猫在花园里奔跑" --model-type text2video

# 图生视频
./scripts/generate.sh --prompt "镜头缓慢推进" --model-type img2video --image-url "https://example.com/cat.png"

# 使用真人审核素材 ID
./scripts/generate.sh --prompt "镜头缓慢推进" --model-type img2video --image-asset-id "asset-20260504002722-fq44g"

# 混合模式
./scripts/generate.sh --prompt "保留节奏感" --model-type mixVideo --image-url "https://example.com/1.png" --video-url "https://example.com/ref.mp4"

目录结构

SKILL.md
scripts/set_key.sh
scripts/generate.sh
references/api-guide.md
assets/