原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

Doubao-Seedance-2.0

bytedance/doubao-seedance-2-0
异步任务：POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果（POST 发送后 request_id 自动填入 GET）。

BASE URLhttps://router.shengsuanyun.com/api

认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页

Doubao-Seedance-2.0-fast

Doubao-Seedance-1.5-pro

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/tasks/generations豆包视频生成-异步

异步任务：POST 提交后返回 request_id，再用 GET /v1/tasks/generations/{request_id} 轮询结果。

请求体

application/json

字段类型说明

content必填

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："text" · "image_url" · "video_url" · "audio_url" · "draft_task"

allOf · 1

any

allOf · 2

any

allOf · 3

any

allOf · 4

any

allOf · 5

any

callback_url string

return_last_frame boolean

service_tier

string

可选值："default" · "flex"

execution_expires_after integer

generate_audio boolean

draft boolean

tools

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："web_search"

safety_identifier string

resolution

string

可选值："480p" · "720p" · "1080p"

ratio

string

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "keep_ratio" · "adaptive"

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-0

anyOf · 1

文生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：仅传入文本提示词 | 特殊限制：ratio / duration 无特殊限制

字段类型说明

content必填

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："text" · "image_url" · "video_url" · "audio_url" · "draft_task"

allOf · 1

any

allOf · 2

any

allOf · 3

any

allOf · 4

any

allOf · 5

any

callback_url string

return_last_frame boolean

service_tier

string

可选值："default" · "flex"

execution_expires_after integer

generate_audio boolean

draft boolean

tools

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："web_search"

safety_identifier string

resolution

string

可选值："480p" · "720p" · "1080p"

ratio

string

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "keep_ratio" · "adaptive"

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-0

anyOf · 2

首帧图生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content.role 设置为 first_frame | 特殊限制：ratio 必须为 adaptive

字段类型说明

content必填

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："text" · "image_url" · "video_url" · "audio_url" · "draft_task"

allOf · 1

any

allOf · 2

any

allOf · 3

any

allOf · 4

any

allOf · 5

any

callback_url string

return_last_frame boolean

service_tier

string

可选值："default" · "flex"

execution_expires_after integer

generate_audio boolean

draft boolean

tools

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："web_search"

safety_identifier string

resolution

string

可选值："480p" · "720p" · "1080p"

ratio

string

当前模式下仅支持 adaptive。

可选值："adaptive"

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-0

anyOf · 3

首尾帧图生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content.role 分别设置为 first_frame 和 last_frame | 特殊限制：ratio 必须为 adaptive

字段类型说明

content必填

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："text" · "image_url" · "video_url" · "audio_url" · "draft_task"

allOf · 1

any

allOf · 2

any

allOf · 3

any

allOf · 4

any

allOf · 5

any

callback_url string

return_last_frame boolean

service_tier

string

可选值："default" · "flex"

execution_expires_after integer

generate_audio boolean

draft boolean

tools

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："web_search"

safety_identifier string

resolution

string

可选值："480p" · "720p" · "1080p"

ratio

string

当前模式下仅支持 adaptive。

可选值："adaptive"

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-0

anyOf · 4

参考图生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content 中至少包含一个 role 为 reference_image 的参考素材 | 特殊限制：ratio / duration 无特殊限制

字段类型说明

content必填

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："text" · "image_url" · "video_url" · "audio_url" · "draft_task"

allOf · 1

any

allOf · 2

any

allOf · 3

any

allOf · 4

any

allOf · 5

any

callback_url string

return_last_frame boolean

service_tier

string

可选值："default" · "flex"

execution_expires_after integer

generate_audio boolean

draft boolean

tools

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："web_search"

safety_identifier string

resolution

string

可选值："480p" · "720p" · "1080p"

ratio

string

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "keep_ratio" · "adaptive"

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-0

anyOf · 5

参考视频生视频异步任务：通过 content 数组组合 text / image_url / video_url 等，role 指定素材角色。触发条件：content 中至少包含一个 role 为 reference_video 的参考素材 | 特殊限制：ratio / duration 无特殊限制

字段类型说明

content必填

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："text" · "image_url" · "video_url" · "audio_url" · "draft_task"

allOf · 1

any

allOf · 2

any

allOf · 3

any

allOf · 4

any

allOf · 5

any

callback_url string

return_last_frame boolean

service_tier

string

可选值："default" · "flex"

execution_expires_after integer

generate_audio boolean

draft boolean

tools

array

展开结构

array

数组元素

字段	类型	说明
`type`必填	string	可选值："web_search"

safety_identifier string

resolution

string

可选值："480p" · "720p" · "1080p"

ratio

string

可选值："16:9" · "4:3" · "1:1" · "3:4" · "9:16" · "21:9" · "keep_ratio" · "adaptive"

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

model必填 string 路由模型，本页固定为 bytedance/doubao-seedance-2-0

{
  "camera_fixed": false,
  "content": [
    {
      "text": "风吹动树叶沙沙作响",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://shengsuanyun.oss-cn-shanghai.aliyuncs.com/example/modelinfo/306/input_0.jpg"
      },
      "role": "first_frame",
      "type": "image_url"
    }
  ],
  "draft": false,
  "duration": 4,
  "generate_audio": true,
  "model": "bytedance/doubao-seedance-2-0",
  "ratio": "16:9",
  "resolution": "720p",
  "return_last_frame": false,
  "seed": 1122334,
  "tools": [],
  "watermark": false
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "camera_fixed": false,
  "content": [
    {
      "text": "风吹动树叶沙沙作响",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://shengsuanyun.oss-cn-shanghai.aliyuncs.com/example/modelinfo/306/input_0.jpg"
      },
      "role": "first_frame",
      "type": "image_url"
    }
  ],
  "draft": false,
  "duration": 4,
  "generate_audio": true,
  "model": "bytedance/doubao-seedance-2-0",
  "ratio": "16:9",
  "resolution": "720p",
  "return_last_frame": false,
  "seed": 1122334,
  "tools": [],
  "watermark": false
}'

响应

200 提交成功，返回 request_id / task_id

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "PENDING",
    "progress": "0%"
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误

GET/v1/tasks/generations/{request_id}查询异步任务状态与产物

通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL（image_urls / video_urls / audio_urls / file_urls / text）。下方「在线测试」填入 request_id 即可发送查询；若上方 POST 已发送成功，request_id 会自动填入。

请求参数

参数	位置 / 类型	说明
`request_id`必填	path / string	POST /v1/tasks/generations 返回的请求 ID

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 任务状态与产物

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "COMPLETED",
    "progress": "100%",
    "data": {
      "url": [
        "https://oss.shengsuanyun.com/example/output.mp4"
      ]
    }
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误