字节（Seedance）
字节（Seedance）在 视频生成 分类下作为独立厂商子树组织。
建议先阅读本指南理解 Seedance 的工作流，再接入具体接口。
接口调用面
| 调用面 | Base URL | 用途 |
|---|---|---|
| 任务接口 | https://video.unigateway.ai | 创建和查询异步视频生成任务 |
| 素材接口 | https://api.unigateway.ai | 管理资产组和可复用素材 |
推荐调用流程
- 先用
POST /api/v3/contents/generations/tasks发起异步生成任务。 - 再用
GET /api/v3/contents/generations/tasks/{id}轮询状态并获取结果。 - 如果工作流需要复用参考素材、品牌资产或供应商素材库，再接入素材库相关接口。
接口布局
| 流程阶段 | 主接口 | 用途 |
|---|---|---|
| 创建任务 | POST /api/v3/contents/generations/tasks | 发起异步生成任务 |
| 查询任务 | GET /api/v3/contents/generations/tasks/{id} | 查询任务状态并获取最终结果 |
| 素材库 | POST /api/v3/contents/generations/asset-groups、POST /api/v3/contents/generations/assets、POST /api/v3/contents/generations/assets/list、DELETE /api/v3/contents/generations/assets/{id} | 管理可复用资产和资产组 |
任务生命周期
| 状态 | 含义 | 建议动作 |
|---|---|---|
queued | 已接收，尚未开始处理 | 继续按短退避轮询 |
running | 生成处理中 | 持续轮询，不要盲目重复创建任务 |
succeeded | 最终结果已就绪 | 读取结果 URL 和 usage，并落自己的任务记录 |
failed | 上游或参数校验失败 | 查看错误字段，再决定是否重试 |
expired | 任务或结果窗口已过期 | 仍需结果时重新提交新任务 |
cancelled | 任务在成功前被终止 | 视为终态，再决定是否重新发起 |
上线检查清单
- 先确认当前走的是视频调用面还是核心 API 调用面。
- 先用最小创建请求跑通一次完整的查询闭环。
- 基础流程成功后，再增加 ratio、duration、audio 等可选字段。
- 上生产前补齐重试和队列退避逻辑。
说明
- Seedance 采用“创建任务 -> 查询任务”的异步模型，而不是单次同步生成调用。
- 任务接口与素材接口位于不同 UniGateway 域名，接入前请先确认对应接口的 Base URL。