Seedance 2.0 视频生成 API

概述

本接口为 Seedance 2.0 视频生成能力，请求/响应形态与主流视频生成 API 对齐，便于已有 SDK 或调用方快速接入。

• 视频生成为异步任务：先创建任务，再轮询查询结果。
• 支持文生视频、图生视频、多模态参考生视频。
• 创建成功后返回任务 ID，初始状态为 queued；生成完成后通过查询接口获取 content.video_url。

鉴权方式

使用 Bearer Token 鉴权，在请求头中携带平台分配的 ApiKey：

{
  "code": "AuthenticationError",
  "message": "authentication failed: missing Authorization header",
  "type": "Unauthorized",
  "request_id": "7f9a72b7476bc7838a470c3df57258da"
}

公共说明

• Base URL：https://sd.yanyunai.com
• Content-Type：application/json

下文 {BASE_URL} 即代表上述 Base URL。

响应格式

成功：直接返回业务 JSON 对象（不含外层包装）。

失败：返回扁平错误对象：

1. 创建视频生成任务

创建 Seedance 2.0 视频生成任务。模型会依据传入的 content 及参数生成视频，完成后通过查询接口获取结果。

请求参数

请求示例

文生视频（fast 型号，默认）

curl -X POST "https://sd.yanyunai.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      { "type": "text", "text": "海浪拍打礁石，黄昏的阳光洒在海面上，镜头缓缓推进" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

多模态参考（pro 型号）

curl -X POST "https://sd.yanyunai.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      { "type": "text", "text": "让画面中的人物挥手微笑" },
      { "type": "image_url", "image_url": { "url": "https://example.com/first.png" }, "role": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image" }
    ],
    "resolution": "1080p",
    "ratio": "9:16",
    "duration": 5
  }'

响应参数

响应示例

{
  "id": "cgt-20260528xxxxxx-abcde",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued",
  "created_at": 1748400000
}

2. 查询视频生成任务

查询视频生成任务的状态；任务成功时返回生成视频的 URL。

路径参数

请求示例

curl "https://sd.yanyunai.com/api/v3/contents/generations/tasks/cgt-20260528xxxxxx-abcde" \
  -H "Authorization: Bearer your-api-key"

响应参数

status 取值

响应示例

任务运行中

{
  "id": "cgt-20260528xxxxxx-abcde",
  "model": "doubao-seedance-2-0-260128",
  "status": "running",
  "created_at": 1748400000,
  "updated_at": 1748400060
}

任务成功

{
  "id": "cgt-20260528xxxxxx-abcde",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://.../output.mp4",
    "persistent_video_url": "https://.../persistent/output.mp4"
  },
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "usage": { "completion_tokens": 123456, "total_tokens": 123456 },
  "created_at": 1748400000,
  "updated_at": 1748400300
}

任务失败

{
  "id": "cgt-20260528xxxxxx-abcde",
  "status": "failed",
  "error": { "code": "OutputVideoSensitiveContentDetected", "message": "..." }
}

content 数组元素

每个元素通过 type 指定类型：

可选字段 role（素材角色）：

使用限制

错误码说明

鉴权与访问

参数校验（HTTP 400）

内容安全（HTTP 400）

限流与服务端

注意事项

1. 鉴权：使用 Authorization: Bearer <your-api-key>。
2. model 字段：使用 Model ID doubao-seedance-2-0-260128（Seedance 2.0）或 doubao-seedance-2-0-fast-260128（Seedance 2.0 fast）。
3. 异步轮询：创建后请轮询查询接口，建议间隔 ≥ 30 秒；视频生成通常需 1-3 分钟。过于频繁的轮询会被限流（429）。
4. 任务 ID：请保存创建接口返回的 id，查询时使用同一路径参数。
5. 视频 URL：content.video_url 约 24h 有效，请在此期间下载；如需长期保存，请在 24h 内自行下载转存到你方存储。content.persistent_video_url 为转存持久地址，但可能有数分钟延迟、刚成功时不一定可用，请优先使用 video_url。