Skip to content

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.0Exchange Token 的 Seedance 2.0 通用别名不需要兼容原厂模型 ID 的新接入
seedance-2.0-fastfast 版,优先延迟与成本已开通 fast 池的账号

模型是否可用取决于账号配置。接入时请使用已为你的账号开通的精确模型名。

视频任务接口

接口方法说明
/api/v3/contents/generations/tasksPOST创建视频生成任务
/api/v3/contents/generations/tasks/{id}GET查询单个任务

资产接口

接口方法说明
/open/CreateAssetGroupPOST创建素材组
/open/CreateAssetPOST通过公网 URL 创建素材
/open/GetAssetPOST查询素材预处理状态
/open/DeleteAssetPOST删除素材,并立即让素材不可用

快速接入流程

  1. 先确定账号已开通的模型名。如果需要兼容国内 Seedance 2.0 原厂模型 ID,使用 doubao-seedance-2-0-260128
  2. 如果你的图片、视频或音频会被反复使用,先创建素材并等待 Status = "Active"
  3. 通过 /api/v3/contents/generations/tasks 提交视频任务。
  4. 轮询 /api/v3/contents/generations/tasks/{id},直到任务进入 succeededfailed

接入提示

  • 推荐鉴权头:Authorization: Bearer <YOUR_API_KEY>
  • Base URL 示例:https://api.exchangetoken.ai
  • 模型名会参与路由选择。国内兼容池和海外兼容池建议使用不同的对外模型名,不建议混用。
  • 结果 URL 具备时效性,生成成功后建议尽快保存
  • GET /api/v3/contents/generations/tasksDELETE /api/v3/contents/generations/tasks/{id} 当前不属于正式 public 契约

下一步