Seedance 视频生成

Hubridge Gateway 提供 字节 Seedance 2.0（豆包） 原生视频 API 透传，采用「创建任务 + 轮询状态」的异步流程。

Base URL：https://api.hubridge.net

鉴权

与对话补全相同，使用 Hubridge API Key：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

常用模型

模型 slug	说明
`doubao-seedance-2-0-260128`	Seedance 2.0 标准版
`doubao-seedance-2-0-fast-260128`	Seedance 2.0 快速版

请在模型广场确认当前可用模型及定价。

调用流程

创建任务：POST /seedance/api/v3/contents/generations/tasks，返回任务 ID 与初始状态
轮询状态：GET /seedance/api/v3/contents/generations/tasks/{task_id}，直至 status 为 succeeded 或 failed
获取视频：成功时从响应 content.video_url 读取视频地址

Seedance 成功状态为 succeeded（不是 completed）。

创建视频任务

POST /seedance/api/v3/contents/generations/tasks

请求体顶层需包含 model；content 为内容数组（不要嵌套在 metadata 内）。

字段	类型	必填	说明
`model`	string	是	模型 slug
`content`	array	否	内容项，如 `[{"type":"text","text":"..."}]`
`duration`	integer	否	视频时长，4–15 秒
`ratio`	string	否	画幅比例，如 `16:9`
`resolution`	string	否	分辨率，如 `720p`、`1080p`
`generate_audio`	boolean	否	是否生成配套音频

示例：

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "一只猫在草地上奔跑"
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

cURL

curl -X POST "https://api.hubridge.net/seedance/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": "一只猫在草地上奔跑" }
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }'

创建响应

{
  "id": "task_xxx",
  "status": "queued",
  "content": {
    "video_url": null
  },
  "error": {},
  "_gateway": {}
}

创建响应可能附带 _gateway 字段（含 request_id、cost、latency_ms 等网关信息）。

查询任务状态

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

参数	位置	必填	说明
`task_id`	path	是	创建任务返回的任务 ID
`model`	query	否	可选模型 slug，用于路由到 seedance 渠道

cURL

curl "https://api.hubridge.net/seedance/api/v3/contents/generations/tasks/task_xxx?model=doubao-seedance-2-0-fast-260128" \
  -H "Authorization: Bearer YOUR_API_KEY"

任务状态

status	说明
`queued`	排队中
`running`	生成中
`succeeded`	成功，可读取 `content.video_url`
`failed`	失败，查看 `error` 字段

成功示例：

{
  "id": "task_xxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/video.mp4"
  },
  "error": {}
}

完整 Schema

字段细节、枚举与错误码见 API 参考 · Gateway 中的 Seedance 章节，以及数据模型中的 SeedanceVideoTaskRequest / SeedanceVideoTaskResponse。

Seedance 视频生成

On this page