- 完全兼容 Seedance 2.0 官方接口:如果你已在使用字节官方 API,只需更换 Base URL 和 API Key 即可无缝迁移,零改造成本。详见本文档「官方兼容接口」章节
- OpenAI 风格接口:统一的
POST /v1/videos端点,与平台其他模型保持一致的调用体验
Base URL: 两种接口共用同一个 Base URL:https://api.powertokens.ai
本文档同时覆盖两种接口。 官方兼容接口在前半部分,OpenAI 风格接口在「OpenAI 风格接口」章节。
重要前提: 无论使用哪种接口,所有图片、视频、音频素材必须先通过资产库上传并获取asset_id,然后在请求中直接使用asset_id。详见「素材准备」章节。
前置准备
在调用 Seedance 2.0 接口之前,请完成以下步骤:- 注册登录:注册并登录 powertokens.ai
- 获取 API Key:进入 API Keys 管理页面,创建新的 Key,复制并妥善保存
- 充值:进入 充值页面,购买 Credits(视频生成按量计费,需要账户有余额)
- 开通资产库:进入 资产库页面,阅读并同意《素材库用户协议》(Seedance 2.0 的所有素材必须通过资产库上传)
鉴权方式
所有请求通过 HTTP Header 鉴权:官方兼容接口
PowerTokens 完全兼容 Seedance 官方 API,请求体、参数名、响应结构与字节官方一致。如果你已在使用字节官方 API,只需替换 Base URL 和 API Key 即可迁移。从字节官方迁移
Base URL
两种接口共用同一个 Base URL:https://api.powertokens.ai,区别在于请求路径不同。
接口列表
素材传入方式
官方兼容接口中,素材通过asset://<ASSET_ID> 格式传入 url 字段:
url 字段均支持以下三种格式:
| 格式 | 示例 | 说明 |
|---|---|---|
| 素材 ID(推荐) | asset://XXXX | 通过资产库上传获得的 asset_id |
| 公网 URL | https://example.com/img.jpg | 公开可访问的文件地址 |
| Base64 编码 | data:image/png;base64,aHR0... | 本地文件转 Base64(大文件不推荐) |
示例:图生视频(使用 asset_id)
示例:多模态参考生视频(参考图 + 参考视频 + 参考音频)
示例:查询任务状态
示例:查询任务列表
示例:取消/删除任务
官方兼容接口 vs OpenAI 风格接口
| 维度 | 官方兼容接口 | OpenAI 风格接口 |
|---|---|---|
| Base URL | https://api.powertokens.ai(相同) | https://api.powertokens.ai(相同) |
| 创建任务 | POST /byteplus/api/v3/contents/generations/tasks | POST /v1/videos |
| 素材传入 | "url": "asset://XXXX"(相同) | "url": "asset://XXXX"(相同) |
| 查询任务 | GET /byteplus/api/v3/.../tasks/{id} | GET /v1/videos/{task_id} |
| 任务列表 | GET /byteplus/api/v3/.../tasks | 不支持 |
| 取消/删除任务 | DELETE /byteplus/api/v3/.../tasks/{id} | 不支持 |
| 参数结构 | 与字节官方一致(content 数组) | OpenAI 风格(media 数组) |
| 适用场景 | 从字节官方迁移,需要任务列表/取消等高级功能 | 统一调用平台多种模型 |
两种接口的生成效果完全一致,选择适合你的即可。
OpenAI 风格接口
统一的POST /v1/videos 端点,与平台其他模型保持一致的调用体验。
可用模型
| 模型 | 模型 ID | 特点 |
|---|---|---|
| Seedance 2.0 | dreamina-seedance-2-0-260128 | 高质量,支持 1080p(图生视频/首尾帧/多模态参考场景) |
| Seedance 2.0 Fast | dreamina-seedance-2-0-fast-260128 | 快速生成,最高 720p |
支持的生成模式
素材准备(必读)
Seedance 2.0 的所有媒体素材(图片、视频、音频)必须先通过资产库上传获取asset_id,不能直接传入外部 URL。
流程
只需两步,拿到asset_id 即可直接用于 Seedance 请求:
| 步骤 | 接口 | 输入 | 输出 | 鉴权 |
|---|---|---|---|---|
| ① 上传素材 | POST /v1/asset/upload | 文件 | task_id | 需要 |
| ② 轮询获取资产 ID | GET /v1/asset/jobs/get-asset-id | task_id | asset_id | 不需要 |
拿到asset_id后就可以直接用了! 无论哪种接口,都通过"url": "asset://你的asset_id"格式传入素材,无需再查询素材详情获取 URL。
示例:准备一张起始帧图片
详细的资产库使用说明请参考 资产库快速上手。
请求参数说明
所有生成模式共用POST /v1/videos 端点,通过 media 数组中的不同 type 组合来区分模式。
公共参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | — | 模型 ID |
media | array | 是 | — | 多模态输入数组,见下方 media 类型表 |
seconds | string | 否 | "5" | 视频时长(秒),"4" 至 "15" 或 "-1"(智能选择) |
size | string | 否 | "720p" | 分辨率:480p / 720p(标准版图生视频/首尾帧/多模态参考还支持 1080p) |
ratio | string | 否 | 见说明 | 画面比例:16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive。文生视频默认 16:9,图生视频默认 adaptive |
seed | integer | 否 | -1 | 随机种子,范围 [-1, 4294967295] |
watermark | boolean | 否 | false | 是否添加水印 |
generate_audio | boolean | 否 | true | 是否生成同步音效(2.0 系列专属功能) |
return_last_frame | boolean | 否 | false | 是否返回最后一帧图片 |
safety_identifier | string | 否 | — | 终端用户唯一标识,用于合规检测,不超过 64 字符 |
media 类型
| type | 说明 | 必需字段 |
|---|---|---|
text | 文本提示词 | text |
first_frame | 起始帧图片 | asset_id(通过资产库上传获得) |
last_frame | 结束帧图片 | asset_id(通过资产库上传获得) |
reference_image | 参考图片 | asset_id(通过资产库上传获得) |
reference_video | 参考视频 | asset_id(通过资产库上传获得) |
reference_audio | 参考音频 | asset_id(通过资产库上传获得) |
使用示例
1. 文生视频(标准版 API 文档 · Fast 版)
2. 图生视频(标准版 API 文档 · Fast 版)
asset://XXXX 中的 XXXX 为通过资产库上传后获得的资产 ID。
3. 首尾帧生视频(标准版 API 文档 · Fast 版)
4. 多模态参考生视频(标准版 API 文档 · Fast 版)
可以同时传入参考图、参考视频、参考音频中的一种或多种:查询任务状态(API 文档)
提交生成请求后会返回task_id,视频生成是异步的,需要轮询查询状态。
接口: GET /v1/videos/{task_id}
任务状态说明
| 状态 | 含义 |
|---|---|
queued | 排队中 |
running | 生成中 |
succeeded | 生成成功 |
failed | 生成失败 |
cancelled | 已取消(仅排队中的任务可取消,24h 后自动删除) |
expired | 已超时 |
成功响应示例
注意: 视频 URL 有效期为 14 天,请及时下载保存。仅可查询最近 7 天内的任务。
完整工作流 — Python
从素材上传到视频生成的完整示例:两个模型版本对比
| 维度 | Seedance 2.0 | Seedance 2.0 Fast |
|---|---|---|
| 模型 ID | dreamina-seedance-2-0-260128 | dreamina-seedance-2-0-fast-260128 |
| 生成速度 | 标准 | 更快 |
| 最大分辨率 | 1080p(图生视频/首尾帧/多模态参考) | 720p |
| 文生视频分辨率 | 720p | 720p |
| 时长范围 | 4–15 秒 或 -1(智能选择) | 4–15 秒 或 -1(智能选择) |
| 音频同步 | 支持 | 支持 |
| 多模态参考 | 支持 | 支持 |
接口速查表
官方兼容接口
Base URL: https://api.powertokens.ai
创建任务 — POST /byteplus/api/v3/contents/generations/tasks(API 文档)
查询任务 — GET /byteplus/api/v3/contents/generations/tasks/{id}(API 文档)
任务列表 — GET /byteplus/api/v3/contents/generations/tasks(API 文档)
取消/删除任务 — DELETE /byteplus/api/v3/contents/generations/tasks/{id}(API 文档)
OpenAI 风格接口
Base URL: https://api.powertokens.ai
生成模式 — POST /v1/videos
文生视频(标准版 · Fast)
图生视频(标准版 · Fast)
首尾帧生视频(标准版 · Fast)
多模态参考生视频(标准版 · Fast)
Fast 版请将模型 ID 替换为 dreamina-seedance-2-0-fast-260128。
任务查询 — GET /v1/videos/{task_id}(API 文档)
素材准备(资产库)
上传素材 — POST /v1/asset/upload(API 文档)
获取资产 ID — GET /v1/asset/jobs/get-asset-id(API 文档)
此接口不需要鉴权。拿到 asset_id 后即可直接用于 Seedance 请求。
完整 API 参考文档请访问 docs.powertokens.ai