TK Dance · 接入文档

快速接入

POST /api/v3/contents/generations/tasksGET /api/v3/contents/generations/tasks/{id}

curl https://video.example.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "video-test",
  "content": [
    {
      "type": "text",
      "text": "a paper crane unfolding"
    }
  ]
}'

{
  "id": "task_xxx"
}

提交、轮询、取片

提交:POST /api/v3/contents/generations/tasks,返回任务号。尺寸、分辨率档、收费模式都写在请求里,不用换模型名。
轮询:GET /api/v3/contents/generations/tasks/{id},直到状态终结。不支持回调。
状态:queued / running 继续轮询;succeeded 从 content.video_url 下载成片;failed 看 error.message。
失败与内容审核拒绝都会自动退款;内容审核拒绝是终态,请改提示词后重发。

content 条目与 role

三种场景互斥:图生视频 / 首尾帧 / 多模态参考。

提示词(必带一条)
首帧(图生视频;单图可省略 role)
尾帧(与 first_frame 成对)
参考图(多模态参考;张数上限见下方规格表)
参考视频(仅 URL)
参考音频(须搭配参考图或参考视频)

家族与规格

登录后显示完整规格。

登录