Doubao Seedance 2.x 视频生成

功能概览

本页用于说明 Doubao Seedance 2.x 视频生成 的核心能力、调用入口和接入要点，帮助开发者快速判断适用场景并完成集成。

适用场景

• 产品原型验证：快速接入模型能力，验证内容生成、理解或编辑流程。
• 生产业务接入：用于批量任务、自动化工作流和多模型组合调用。
• 能力迁移适配：适合从原有模型或 SDK 平滑切换到爱虾AI统一接口。

接入建议

• 优先确认模型名称、请求路径和响应字段，再接入具体业务流程。
• 对异步任务、媒体生成和长耗时请求，建议在业务侧加入重试与状态轮询。
• 上线前建议准备日志追踪、错误处理和内容安全校验，便于稳定运行。

模型与网关限制

请求中推荐使用左列的平台模型名。网关会根据已配置的上游模型转发请求。fast 和 mini 传入 1080p 或 4k 会返回 400。

火山方舟官方可能提供更长时长或更多参数组合；以本接口的 4-15 秒限制为准。

鉴权与异步结算

所有请求均使用 Bearer 鉴权：

Authorization: Bearer <API_KEY>
Content-Type: application/json

官方兼容接口

官方兼容创建路径：

POST https://api.yisu-api.com/api/v3/contents/generations/tasks

查询、列表和取消路径：

GET    https://api.yisu-api.com/api/v3/contents/generations/tasks/{task_id}
GET    https://api.yisu-api.com/api/v3/contents/generations/tasks?page_num=1&page_size=20
DELETE https://api.yisu-api.com/api/v3/contents/generations/tasks/{task_id}

官方兼容接口透传火山方舟的任务结构。使用官方的 content 格式时，可使用文本、参考图片、参考视频、参考音频等输入。

文生视频

curl "https://api.yisu-api.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "清晨的海岸公路，镜头缓慢向前推进，电影感自然光。"
      }
    ],
    "ratio": "16:9",
    "duration": 4,
    "resolution": "480p",
    "generate_audio": false,
    "watermark": false
  }'

图生视频

curl "https://api.yisu-api.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "让参考图中的产品缓慢旋转，背景光影轻微流动。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/product.png"
        },
        "role": "reference_image"
      }
    ],
    "ratio": "1:1",
    "duration": 4,
    "resolution": "480p",
    "generate_audio": false
  }'

参考视频和音频分别使用 video_url、audio_url，并设置 role 为 reference_video、reference_audio。可用的数量与任务类型以火山方舟官方文档为准。

创建响应示例

{
  "id": "cgt-xxxxxxxxxxxxxxxx",
  "model": "doubao-seedance-2-5-260628",
  "status": "queued",
  "created_at": 1780000000
}

任务状态通常为 queued、running、succeeded、failed、cancelled 或 expired。成功响应的 content.video_url 是视频地址。

查询任务

curl "https://api.yisu-api.com/api/v3/contents/generations/tasks/cgt-xxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer <API_KEY>"

任务未完成时继续轮询。建议每 5-10 秒查询一次，避免高频轮询。

OpenAI Videos API 兼容接口

OpenAI 兼容路径：

POST   https://api.yisu-api.com/v1/videos
GET    https://api.yisu-api.com/v1/videos/{video_id}
GET    https://api.yisu-api.com/v1/videos/{video_id}/content
GET    https://api.yisu-api.com/v1/videos
DELETE https://api.yisu-api.com/v1/videos/{video_id}

该接口兼容 OpenAI 的路径、任务对象与视频下载方式，但 Seedance 的核心生成参数仍使用 ratio、duration、resolution。不要用 seconds 代替 duration，也不要只传 size 期待其转换为上游分辨率。

文生视频

curl "https://api.yisu-api.com/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "雨后城市街道，霓虹灯在积水中倒映，镜头缓慢平移。",
    "ratio": "16:9",
    "duration": 4,
    "resolution": "480p",
    "generate_audio": false,
    "watermark": false
  }'

图生视频

OpenAI 兼容写法可用顶层 image 或 images。网关会转换为上游的 content.image_url 结构。

curl "https://api.yisu-api.com/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-mini",
    "prompt": "让参考图中的人物回头看向镜头，保持人物外观一致。",
    "images": [
      "https://example.com/person.png"
    ],
    "ratio": "9:16",
    "duration": 4,
    "resolution": "480p",
    "generate_audio": false
  }'

也可传递 video / videos、audio / audios，分别转换为参考视频和参考音频。需要使用首尾帧、编辑、延长或其他完整官方能力时，建议仍在 /v1/videos 路径直接传递官方 content 数组。

OpenAI 兼容响应

创建或查询时，网关将上游任务对象转换为以下格式，并在 upstream_response 中保留原始任务响应：

{
  "id": "cgt-xxxxxxxxxxxxxxxx",
  "object": "video",
  "created": 1780000000,
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "queued",
  "content": null,
  "error": null,
  "upstream_response": {}
}

状态映射如下：

下载视频

任务状态为 completed 后，可由兼容下载接口直接获取 MP4：

curl "https://api.yisu-api.com/v1/videos/cgt-xxxxxxxxxxxxxxxx/content" \
  -H "Authorization: Bearer <API_KEY>" \
  --output output.mp4

若任务尚未产生视频，接口返回 HTTP 409 及任务信息。

参数说明

常见错误