视频模型 · 字节跳动
Seedance 2.5 Flash API
Seedance 2.5 Flash 是字节跳动 Seedance 2.5 视频模型中偏重速度与成本的版本,在 TokenRa 上的模型 ID 为 seedance-2.5-flash。支持文本和参考图输入,输出带音轨的视频;请求格式与 Seedance 2.5 Pro 相同,并额外支持 480p 输出。
- 模型 ID
seedance-2.5-flash- 输入
- 文本、参考图
- 输出
- 480p 或 720p 视频
- 调用方式
- 异步任务
- 价格
- $6.522 / 100 万 token
- 面向 AI 代理
- llms.txt 指南
Capabilities
能力与接口
视频生成是异步的:先创建任务,再轮询结果。请求体与 Seedance 2.5 Pro 完全一致,两个版本之间切换只需改 model 字段。2026-11-16 实测的一次 2.5 Flash 任务约 2 分钟完成;2.5 Pro 的 4–5 秒 720p 视频约需 5 分钟。
POSThttps://tokenra.io/v1/video/generations已实测
创建任务,立即返回
task_id。GEThttps://tokenra.io/v1/video/generations/{task_id}已实测
查询任务;
data.status 为 SUCCESS 时,视频链接在 data.result_url。单价是固定的:不论 480p 还是 720p,均为 $6.522 / 100 万视频 token。token 数随分辨率和时长增长,因此同一段视频选 720p 仍比 480p 贵。价格细节见模型介绍页。
Modes
生成场景
A. 文生视频
输出设置直接写在请求顶层。下面的示例请求 480p,这是仅 Flash 支持的输出档位。
{
"model": "seedance-2.5-flash",
"prompt": "雨夜霓虹街道上漂流的纸船,电影感特写镜头",
"resolution": "480p",
"ratio": "9:16",
"duration": 4,
"generate_audio": false
}B. 参考图生视频
images 中的图片会作为参考图(reference_image)传给模型,常用于固定人物、产品或包装的样貌。需要特定比例和时长时请显式传入,不要依赖默认值。
{
"model": "seedance-2.5-flash",
"prompt": "标志卡片缓慢推近,一道柔光从画面上扫过",
"images": ["https://example.com/logo-card.png"],
"resolution": "720p"
}Request
请求参数
输出设置写在请求顶层
Seedance 2.5 Flash 从请求顶层读取
resolution、ratio、duration 和 generate_audio,与 Seedance 2.0 从 metadata 读取的方式相反。| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | seedance-2.5-flash |
prompt | string | 是 | 画面、动作与镜头描述。使用 content 且其中包含 text 项时可省略。 |
resolution | string | 是 | 480p 或 720p,写在请求顶层,不传会被拒绝。Seedance 2.5 系列中仅 Flash 提供 480p;需要 1080p 请用 Seedance 2.5 Pro。同时决定任务消耗的 token 数。 |
ratio | string | 否 | 画面比例,如 16:9、9:16。 |
duration | integer | 否 | 视频时长(秒),默认 5。 |
generate_audio | boolean | 否 | 是否生成音轨,默认开启;传 false 得到无声视频。 |
images | string[] | 否 | 参考图链接数组,见 B 模式。 |
content | array | 否 | 文本与图片素材,格式与 Seedance 2.5 Pro 相同,可代替 prompt 和 images。 |
TokenRa 上不支持的用法
metadata会被忽略。实测只在metadata中传resolution时,请求被拒绝,错误码为invalid_resolution。- 不支持视频和音频参考:
video_url、audio_url素材会报错unsupported content type。 - 只有上表中的字段会发送给模型,
seed、watermark、return_last_frame、callback_url等其他字段会被直接丢弃,不会报错。
Response
响应格式
创建任务的响应
{
"id": "task_RxuCqxISrGGv04KFM4xStexL4PW60sCC",
"task_id": "task_RxuCqxISrGGv04KFM4xStexL4PW60sCC",
"object": "video",
"model": "seedance-2.5-flash",
"status": "queued",
"progress": 0,
"created_at": 1794831017
}查询任务的响应
{
"code": "success",
"message": "",
"data": {
"task_id": "task_RxuCqxISrGGv04KFM4xStexL4PW60sCC",
"action": "generate",
"status": "SUCCESS",
"fail_reason": "",
"result_url": "https://example.com/output.mp4",
"submit_time": 1794831017,
"start_time": 1794831028,
"finish_time": 1794831147,
"progress": "100%",
"data": {
"id": "cgt-20261116201017-upxtp",
"object": "video.generation",
"status": "completed",
"data": [{"url": "https://example.com/output.mp4"}],
"usage": {"total_tokens": 108900, "completion_tokens": 108900}
}
}
}data.data 是上游返回的原始任务信息,不会回显分辨率、比例和时长;usage.total_tokens 是计费用的视频 token 数。上例的实测任务消耗 108,900 个 token。
| data.status | 含义 |
|---|---|
NOT_START / SUBMITTED / QUEUED | 已受理,等待开始。 |
IN_PROGRESS | 生成中。 |
SUCCESS | 完成,下载 result_url。 |
FAILURE | 失败,原因见 fail_reason,预扣费用会退回。 |
Errors
错误与限制
该模型的参数错误
| HTTP | code | message | 原因 |
|---|---|---|---|
400 | invalid_resolution | resolution must be 480p, 720p or 1080p | 未传 resolution、传了 message 所列以外的值,或只写在 metadata 里。 |
400 | invalid_request | prompt is required | 没有 prompt,content 中也没有 text 项。 |
500 | build_request_failed | unsupported content type: video_url | content 中有 text、image_url 以外的素材类型。 |
常见错误
| HTTP | error.code | 含义 | 处理建议 |
|---|---|---|---|
401 | — | API Key 缺失、错误或已删除,message 为 Invalid token。 | 检查 Authorization: Bearer 请求头,并在控制台核对 Key。 |
400 | — | 请求体不是合法 JSON。 | 修正 JSON,并带上 Content-Type: application/json。 |
500 | invalid_request | 缺少必填字段,例如未传 messages。 | 按 message 补全字段,重试无效。 |
403 | insufficient_user_quota | 账户余额或套餐额度不足。 | 在控制台充值后重试。 |
503 | model_not_found | 模型 ID 不存在,或你的分组下没有可用渠道。 | 在模型列表或 GET /v1/models 中核对模型 ID。 |
429 | — | 请求过于频繁。 | 指数退避后重试。 |
5xx | — | 上游服务商出错或超时。 | 稍后重试几次;持续出错时保留 request id 联系支持。 |
使用限制与说明
- 建议每 10–15 秒查询一次。2026-11-16 实测的 2.5 Flash 任务约 2 分钟完成,实际耗时取决于排队情况和分辨率。
result_url是临时链接,请自行下载保存。- 480p 与 720p 单价相同,均为 $6.522 / 100 万视频 token,按
usage.total_tokens结算。需要 1080p 输出请用 Seedance 2.5 Pro(artsdance-2-5-pro-260801)。实时价格见模型广场。