火山方舟视频 · Seedance

方舟视频 · Seedance 系列

适用 modelKey

modelKey代际
doubao-seedance-1.5-pro1.5
doubao-seedance-1.0-pro1.0 pro
doubao-seedance-1.0-pro-fast1.0 pro fast
doubao-seedance-2.02.0
doubao-seedance-2.0-fast2.0 fast

命名说明:上表为 JELLYTOKEN modelKey,可能不同于火山方舟官方 Model ID;调用时以控制台 / GET /api/ai/models 返回为准。


推荐接入

平台异步任务 API(视频)

示例(文生视频)

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "doubao-seedance-2.0",
    "callbackId": "seedance-001",
    "videoParams": {
      "prompt": "无人机掠过雪山,电影感",
      "duration": 5,
      "resolution": "720p",
      "aspectRatio": "16:9"
    }
  }')
echo "$TASK"

TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

status=completed 时从 resultUrlPublic 取视频地址。建议每 2~5 秒轮询,或使用 Webhook 回调

平台入参

字段说明
videoParams.prompt提示词
videoParams.firstFrame / lastFrame首尾帧
videoParams.refImages多模态参考(Seedance 2.0)
videoParams.duration时长;Seedance 2.0 可传 -1 使用智能时长
videoParams.resolution720p1080p
videoParams.aspectRatio映射到方舟 ratio,如 16:99:16adaptive
videoParams.extraParamsJson平台已支持的 Seedance 特有字段,如参考视频、参考音频、工具配置

完整字段见 平台异步任务 API(视频)

首帧/首尾帧(firstFrame / lastFrame)与多模态参考(refImagesextraParamsJson.refVideosextraParamsJson.refAudios)属于不同生成模式,建议不要在同一次请求中混用。

平台字段映射

extraParamsJson 必须是 JSON 字符串;当前平台会解析为对象后按模型能力映射:

字段映射说明默认值 / 约束
videoParams.prompt生成 content[].type=text必填(除非使用 draft_id
videoParams.firstFrame / lastFrame生成 content[].role=first_frame / last_frame与多模态参考互斥
videoParams.refImagesSeedance 2.0 多模态参考图最多 9 张;与首尾帧互斥
extraParamsJson.refVideosSeedance 2.0 参考视频最多 3 个;与首尾帧互斥
extraParamsJson.refAudiosSeedance 2.0 参考音频最多 3 段;需同时有参考图或视频
videoParams.duration映射到方舟 durationSeedance 2.0 可传 -1(智能时长)
videoParams.aspectRatio映射到方舟 ratio16:99:16adaptive
extraParamsJson.draft_id映射为方舟 draft_task使用草稿时可不传 prompt
extraParamsJson.generate_audio映射到方舟同名字段默认 true
extraParamsJson.return_last_frame映射到方舟同名字段默认 false
extraParamsJson.tools映射到方舟同名字段仅保留 web_search(Seedance 2.0)
extraParamsJson.watermark映射到方舟同名字段默认 false

平台出参

查单 status=completed 时从 resultUrlPublic 取视频 URL;Webhook 见 Webhook 回调

厂商全量参数

原生接口兼容

火山方舟原生接口兼容(视频)