Skip to main content
PowerTokens 完整支持 Seedance 2.0 系列视频生成模型,提供两种接入方式:
  1. 完全兼容 Seedance 2.0 官方接口:如果你已在使用字节官方 API,只需更换 Base URL 和 API Key 即可无缝迁移,零改造成本。详见本文档「官方兼容接口」章节
  2. OpenAI 风格接口:统一的 POST /v1/videos 端点,与平台其他模型保持一致的调用体验
Base URL: 两种接口共用同一个 Base URL:https://api.powertokens.ai
本文档同时覆盖两种接口。 官方兼容接口在前半部分,OpenAI 风格接口在「OpenAI 风格接口」章节。
重要前提: 无论使用哪种接口,所有图片、视频、音频素材必须先通过资产库上传并获取 asset_id,然后在请求中直接使用 asset_id。详见「素材准备」章节。

前置准备

在调用 Seedance 2.0 接口之前,请完成以下步骤:
  1. 注册登录:注册并登录 powertokens.ai
  2. 获取 API Key:进入 API Keys 管理页面,创建新的 Key,复制并妥善保存
  3. 充值:进入 充值页面,购买 Credits(视频生成按量计费,需要账户有余额)
  4. 开通资产库:进入 资产库页面,阅读并同意《素材库用户协议》(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 字段均支持以下三种格式:

示例:图生视频(使用 asset_id)

示例:多模态参考生视频(参考图 + 参考视频 + 参考音频)

示例:查询任务状态

示例:查询任务列表

示例:取消/删除任务

官方兼容接口 vs OpenAI 风格接口

两种接口的生成效果完全一致,选择适合你的即可。

OpenAI 风格接口

统一的 POST /v1/videos 端点,与平台其他模型保持一致的调用体验。

可用模型

两个模型共享相同的接口结构和参数,区别在于生成速度和最大分辨率。

支持的生成模式


素材准备(必读)

Seedance 2.0 的所有媒体素材(图片、视频、音频)必须先通过资产库上传获取 asset_id,不能直接传入外部 URL。

流程

只需两步,拿到 asset_id 即可直接用于 Seedance 请求:
拿到 asset_id 后就可以直接用了! 无论哪种接口,都通过 "url": "asset://你的asset_id" 格式传入素材,无需再查询素材详情获取 URL。

示例:准备一张起始帧图片

详细的资产库使用说明请参考 资产库快速上手

请求参数说明

所有生成模式共用 POST /v1/videos 端点,通过 media 数组中的不同 type 组合来区分模式。

公共参数

media 类型


使用示例

1. 文生视频(标准版 API 文档 · Fast 版

2. 图生视频(标准版 API 文档 · Fast 版

asset://XXXX 中的 XXXX 为通过资产库上传后获得的资产 ID。

3. 首尾帧生视频(标准版 API 文档 · Fast 版

4. 多模态参考生视频(标准版 API 文档 · Fast 版

可以同时传入参考图、参考视频、参考音频中的一种或多种:

查询任务状态(API 文档

提交生成请求后会返回 task_id,视频生成是异步的,需要轮询查询状态。 接口: GET /v1/videos/{task_id}

任务状态说明

成功响应示例

注意: 视频 URL 有效期为 14 天,请及时下载保存。仅可查询最近 7 天内的任务。

完整工作流 — Python

从素材上传到视频生成的完整示例:

两个模型版本对比


接口速查表

官方兼容接口

Base URL: https://api.powertokens.ai

创建任务 — POST /byteplus/api/v3/contents/generations/tasksAPI 文档

查询任务 — GET /byteplus/api/v3/contents/generations/tasks/{id}API 文档

任务列表 — GET /byteplus/api/v3/contents/generations/tasksAPI 文档

取消/删除任务 — 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/uploadAPI 文档
获取资产 ID — GET /v1/asset/jobs/get-asset-idAPI 文档
此接口不需要鉴权。拿到 asset_id 后即可直接用于 Seedance 请求。

完整 API 参考文档请访问 docs.powertokens.ai