Seedance 2.5 Video

Seedance 2.5 使用异步视频任务接口：先创建任务，再轮询查询状态和最终视频地址。统一接口模型名称为 doubao-seedance-2.5。

如需使用 Pro/Fast 2.0 模型，请查看独立的 Seedance 2.0 文档。

接口地址

能力	方法	路径
创建视频任务（兼容官方）	POST	/api/v3/contents/generations/tasks
查询视频任务（兼容官方）	GET	/api/v3/contents/generations/tasks/{task_id}
创建视频任务	POST	/v1/video/generations
查询视频任务	GET	/v1/video/generations/{task_id}
创建异步图片审核任务	POST	/v1/images/moderations/tasks
查询异步图片审核任务	GET	/v1/images/moderations/tasks/{task_id}

参数与能力

参数	说明
model	统一接口和官方兼容接口均传 doubao-seedance-2.5
content	支持 text、image_url、video_url、audio_url
duration	4 到 30 秒，或 -1 表示智能时长
resolution	480p、720p
ratio	adaptive、21:9、16:9、4:3、1:1、3:4、9:16
generate_audio	是否生成同步音频
watermark	是否添加水印

content 元素格式

content 是数组，每个元素通过 type 指定输入类型。图片、视频和音频的 URL 必须放在对应的 { "url": "..." } 对象中，不能直接传字符串。

type	必填字段	可选 role	说明
text	text	无	文本提示词；多段文本按顺序作为输入
image_url	image_url.url	reference_image、first_frame、last_frame	参考图、首帧或尾帧；经过异步审核的图片应使用审核结果中的 asset_url
video_url	video_url.url	reference_video	参考视频；未传 role 时按参考视频处理
audio_url	audio_url.url	reference_audio	参考音频；未传 role 时按参考音频处理

[
  { "type": "text", "text": "描述希望生成的视频" },
  { "type": "image_url", "role": "reference_image", "image_url": { "url": "asset://reviewed-image-id" } },
  { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/reference.mp4" } },
  { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/reference.mp3" } }
]

常用组合包括纯文本、文本 + 图片、文本 + 视频、文本 + 音频，以及图片、视频、音频的多模态组合。不能只传音频；content 至少要包含 text、image_url 或 video_url 之一。

最多接受 30 张参考图片、10 个参考视频和 10 段参考音频。参考音频不能单独作为唯一输入；可与文本、图片或视频组合，例如“文本 + 音频”。首帧或首尾帧任务使用 ratio: "adaptive"。

文生视频

curl -X POST https://cubicspace.cn/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.5",
    "content": [{
      "type": "text",
      "text": "电影感航拍镜头，一座未来城市在日出时逐渐苏醒"
    }],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

创建成功返回 task_xxx，初始状态为 queued。

异步图片审核

图生视频使用需要入库的参考图片时，先创建异步审核任务。同一个视频生成请求使用的所有图片必须放在同一个审核任务的 images 数组中。

curl -X POST https://cubicspace.cn/v1/images/moderations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.5",
    "images": [
      "https://example.com/person.png",
      "https://example.com/product.png"
    ],
    "client_request_id": "seedance-25-batch-001"
  }'

创建接口立即返回 amt_xxx。查询审核结果：

curl https://cubicspace.cn/v1/images/moderations/tasks/amt_xxx \
  -H "Authorization: Bearer YOUR_API_KEY"

建议每 2 到 5 秒查询一次。处理中状态为 queued、running；终态为 succeeded、partial_succeeded、failed、expired。只有图片项状态为 approved 时，才能把其 asset_url 用于视频生成。

图生视频

{
  "model": "doubao-seedance-2.5",
  "content": [
    { "type": "text", "text": "保持图片 1 的人物外观，在阳光明媚的草地上与小狗互动" },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": { "url": "asset://reviewed-person-asset-id" }
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9"
}

首尾帧

{
  "model": "doubao-seedance-2.5",
  "content": [
    { "type": "text", "text": "从图片 1 平滑过渡到图片 2，保持主体和运镜连贯" },
    { "type": "image_url", "role": "first_frame", "image_url": { "url": "asset://first-frame-id" } },
    { "type": "image_url", "role": "last_frame", "image_url": { "url": "asset://last-frame-id" } }
  ],
  "duration": 8,
  "resolution": "720p",
  "ratio": "adaptive"
}

文本和音频参考

{
  "model": "doubao-seedance-2.5",
  "content": [
    { "type": "text", "text": "跟随音频 1 的节奏生成一段电影感舞蹈视频" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/reference.wav" } }
  ],
  "duration": 10,
  "resolution": "720p",
  "ratio": "16:9"
}

仅传 audio_url 会被拒绝；使用参考音频时，至少同时提供非空文本、图片或视频之一。

官方兼容接口

已有官方调用方可直接使用：

POST /api/v3/contents/generations/tasks
GET /api/v3/contents/generations/tasks/{task_id}

请求体统一使用模型名 doubao-seedance-2.5，响应为无外层包装的官方兼容对象。

查询任务

curl https://cubicspace.cn/v1/video/generations/task_xxx \
  -H "Authorization: Bearer YOUR_API_KEY"

必须使用创建任务返回的公开 task_xxx，并携带创建任务时使用的同一枚 API Key。成功时从 data.result_url 读取视频地址；data.usage.completion_tokens 和 data.usage.total_tokens 是任务完成后的最终有效 Token 数。

阶段	状态
处理中	NOT_START、SUBMITTED、QUEUED、IN_PROGRESS
成功	SUCCESS
失败	FAILURE

图片、视频和音频 URL 必须能由平台服务端直接下载。视频结果地址可能有有效期，请及时下载保存。