API
CLUB

Seedance 视频

异步视频任务。提交后得到任务 ID,轮询状态,完成后下载作品。按任务实际消耗的 Token 结算。

可用模型

选择模型,下方示例和参数会切换为该模型。

Seedance-2.0

异步视频任务 · Seedance · POST /v1/tasks/doubao

请求示例
curl -X POST 'https://code.exgravity.ai/v1/tasks/doubao' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "Seedance-2.0",
  "prompt": "一只橘猫坐在窗边,柔和的午后阳光,电影质感",
  "seconds": 5,
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false
  }
}'

请求参数

字段说明
seconds视频秒数,4–15 秒。
metadata.resolution480p / 720p / 1080p / 4k
metadata.ratio16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive
metadata.generate_audio布尔值,是否生成音频。
metadata.content多模态内容数组。文字用 text,图片用 image_url,视频用 video_url,音频用 audio_url。

参考素材

参考视频使用 {"type":"video_url","video_url":{"url":"https://..."},"role":"reference_video"}。提供 content 时请把文字也放入数组。

带参考素材的请求
curl -X POST 'https://code.exgravity.ai/v1/tasks/doubao' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "Seedance-2.0",
  "prompt": "一只橘猫坐在窗边,柔和的午后阳光,电影质感",
  "seconds": 5,
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "content": [
      {
        "type": "text",
        "text": "一只橘猫坐在窗边,柔和的午后阳光,电影质感"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://your-domain.example/reference.png"
        },
        "role": "reference_image"
      }
    ]
  }
}'

提交结果与任务

提交成功后读取 data.task_id,再查询任务状态并获取作品。

提交响应
{
  "code": "success",
  "data": {
    "task_id": "task_xxx"
  }
}

保存 data.task_id,然后按「异步任务与作品」轮询状态并下载作品。