Seedance
Exchange Token 上的 Seedance 接入建议拆成两条工作流理解:
- 视频生成:创建和查询异步视频任务
- 素材资产:准备可复用媒体,并在请求中通过
asset://<ASSET_ID>引用
这个页面只做总览入口。真正接入时,建议按你的场景继续进入下面两个明细页。
推荐阅读路径
如果你只需要发起视频生成或查询任务,先看 Video API。
如果你需要复用图片、视频、音频素材,再去发起 Seedance 请求,先看 Asset API。
我应该看哪一页?
| 你的目标 | 推荐阅读 |
|---|---|
| 创建文生视频、图生视频或多模态 Seedance 任务 | Seedance Video API |
| 上传可复用素材,并等待素材进入可用状态 | Seedance Asset API |
| 先快速理解整体接入流程 | 留在本页 |
对外模型与核心接口
对外模型名
| 模型 | 说明 | 推荐场景 |
|---|---|---|
doubao-seedance-2-0-260128 | 国内 Seedance 2.0 兼容入口 | 已经使用豆包 / Seedance 原厂模型 ID 的客户 |
seedance-2.0 | Exchange Token 的 Seedance 2.0 通用别名 | 不需要兼容原厂模型 ID 的新接入 |
seedance-2.0-fast | fast 版,优先延迟与成本 | 已开通 fast 池的账号 |
模型是否可用取决于账号配置。接入时请使用已为你的账号开通的精确模型名。
视频任务接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/v3/contents/generations/tasks | POST | 创建视频生成任务 |
/api/v3/contents/generations/tasks/{id} | GET | 查询单个任务 |
资产接口
| 接口 | 方法 | 说明 |
|---|---|---|
/open/CreateAssetGroup | POST | 创建素材组 |
/open/CreateAsset | POST | 通过公网 URL 创建素材 |
/open/GetAsset | POST | 查询素材预处理状态 |
/open/DeleteAsset | POST | 删除素材,并立即让素材不可用 |
快速接入流程
- 先确定账号已开通的模型名。如果需要兼容国内 Seedance 2.0 原厂模型 ID,使用
doubao-seedance-2-0-260128。 - 如果你的图片、视频或音频会被反复使用,先创建素材并等待
Status = "Active"。 - 通过
/api/v3/contents/generations/tasks提交视频任务。 - 轮询
/api/v3/contents/generations/tasks/{id},直到任务进入succeeded或failed。
接入提示
- 推荐鉴权头:
Authorization: Bearer <YOUR_API_KEY> - Base URL 示例:
https://api.exchangetoken.ai - 模型名会参与路由选择。国内兼容池和海外兼容池建议使用不同的对外模型名,不建议混用。
- 结果 URL 具备时效性,生成成功后建议尽快保存
GET /api/v3/contents/generations/tasks和DELETE /api/v3/contents/generations/tasks/{id}当前不属于正式 public 契约
