视频模型 · 字节跳动
Seedance 2.5 Flash API 价格与调用方式
Seedance 2.5 Flash 是字节跳动 Seedance 2.5 视频模型的快速档,在 TokenRa 上以异步任务方式调用。输入文本或参考图,返回一段带音轨的视频;分辨率写在请求顶层,可选 480p 或 720p,按视频 token 计费。
- 480p
- $6.522每百万视频 tokens
- 720p
- $6.522每百万视频 tokens
- 计费口径
- 按 tokens以 usage.total_tokens 为准
- 模型 ID
seedance-2.5-flash- 提供方
- 字节跳动 ByteDance
- 输入
- 文本、参考图
- 输出
- 480p / 720p 视频
- 调用方式
- 异步任务
- 音轨
- 默认开启
Overview
它是什么
Flash 是 Seedance 2.5 一代里偏重速度与成本的档位。它和 2.5 Pro 共用同一套请求格式:resolution、ratio、duration、generate_audio 全部写在 JSON 顶层,而不是像 2.0 那样塞进 metadata。这一点是 2.5 与 2.0 最容易踩错的地方——两种请求体不能互换。
生成走异步任务:先 POST 创建任务拿到 task_id,再轮询查询接口,等 data.status 变成 SUCCESS 后从 data.result_url 取回视频。作为参照,2.5 Pro 实测一段 4 到 5 秒的 720p 视频大约需要 5 分钟。
- 想用同一套代码在快速档和旗舰档之间切换,只需改
model字段。 - 需要参考图固定角色或包装外观时,用
images数组传图片链接。 - 对画幅、时长有明确要求时,显式传
ratio和duration,不要依赖默认值。
Pricing
价格
TokenRa 上按视频 token 计费,单价的档位由 resolution 决定。响应里 usage.total_tokens 就是这次要结算的视频 token 数,它随分辨率和时长一起涨——同一段时长,720p 的 token 数明显高于 480p。
| 分辨率 | 输入价格 | 输出价格 | 说明 |
|---|---|---|---|
480p | $6.522 / 百万 tokens | $6.522 / 百万 tokens | 日常批量生成首选 |
720p | $6.522 / 百万 tokens | $6.522 / 百万 tokens | 成片交付、有画质要求时用 |
实时价格以模型广场为准,本页数字与广场保持一致;如果两者不一致,这是本次发版的错误,请以广场为准并告知我们修正。
Integration
怎么调用
task_id;视频不会在这一步返回。data.status 为 SUCCESS 时,视频链接在 data.result_url。文生视频
输出设置直接写在顶层:
curl -X POST https://tokenra.io/v1/video/generations \
-H "Authorization: Bearer $TOKENRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"prompt": "雨夜霓虹街道上漂流的纸船,电影感特写镜头",
"resolution": "720p",
"ratio": "9:16",
"duration": 4,
"generate_audio": true
}'
参考图生视频
images 里的图片会作为参考图传给模型,常用于固定角色、产品或包装的外观:
curl -X POST https://tokenra.io/v1/video/generations \
-H "Authorization: Bearer $TOKENRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"prompt": "标志卡片缓慢推近,一道柔光从画面上扫过",
"images": ["https://example.com/logo-card.png"],
"resolution": "720p"
}'
轮询结果
curl https://tokenra.io/v1/video/generations/task_FUhA4FK80TV1p70mpHlyZXCxeHR0dPPa \
-H "Authorization: Bearer $TOKENRA_API_KEY"
建议每 10 到 15 秒查询一次,不要写成紧凑循环。返回里 data.status 依次可能是 QUEUED、IN_PROGRESS、SUCCESS 或 FAILURE;失败时原因在 fail_reason,预扣费用会退回。
Request
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 本页用 seedance-2.5-flash。 |
prompt | string | 是 | 画面、动作与镜头描述;用 content 且其中含 text 项时可省略。 |
resolution | string | 是 | 顶部字段,可选 480p 或 720p;同时决定计费档位。写进 metadata 会被拒绝。 |
ratio | string | 否 | 画面比例,如 16:9、9:16。 |
duration | integer | 否 | 视频时长(秒),不传时取默认值。 |
generate_audio | boolean | 否 | 是否生成音轨,默认开启;传 false 得到无声视频。 |
images | string[] | 否 | 参考图链接数组。 |
content | array | 否 | 逐项控制素材,可代替 prompt 与 images。 |
metadata 会被忽略,只在 metadata 里传 resolution 会返回 invalid_resolution。视频与音频参考(video_url、audio_url)会报 unsupported content type;seed、watermark、callback_url 等字段会被直接丢弃且不报错,别指望它们生效。Errors
常见错误
| HTTP | 错误信息 | 原因与处理 |
|---|---|---|
| 400 | invalid_resolution | 没传 resolution、传了 480p/720p 以外的值,或只写进了 metadata。改到顶层重发。 |
| 400 | prompt is required | 没有 prompt,content 里也没有 text 项。 |
| 401 | Invalid token | API Key 缺失、错误或已删除;检查 Authorization: Bearer 请求头。 |
| 403 | insufficient_user_quota | 余额或套餐额度不足,充值后重试。 |
| 429 | — | 请求过于频繁,指数退避后重试。 |
| 503 | model_not_found | 模型 ID 不存在,或当前分组下没有可用渠道;用 GET /v1/models 核对。 |
Comparison
和 2.5 Pro、2.0 Fast 的区别
| 2.5 Flash | 2.5 Pro | 2.0 Fast | |
|---|---|---|---|
| 代次 | 2.5 | 2.5 | 2.0 |
| 定位 | 更快、更省的档位 | 旗舰画质 | 上一代快速档 |
| 输出设置位置 | 请求顶层 | 请求顶层 | metadata 内 |
| 分辨率 | 480p / 720p | 720p / 1080p | 2.0 档位 |
| 音轨 | 默认开启 | 默认开启 | 2.0 规则 |
| 请求体能否互换 | 可与 Pro 互换 | 可与 Flash 互换 | 与 2.5 不通用 |
FAQ
常见问题
Seedance 2.5 Flash 是什么?
它是字节跳动 Seedance 2.5 视频模型的快速档,属于 2.5 一代。输入文本和参考图,输出带音轨的视频,在 TokenRa 上以异步任务调用。
在 TokenRa 上调用 Seedance 2.5 Flash 多少钱?
按视频 token 计费,以 usage.total_tokens 为准,480p 和 720p 均为 $6.522 / 百万 tokens。本页价格与模型广场的实时价格一致。
怎么调用 Seedance 2.5 Flash?
视频生成是异步的。先 POST 创建任务拿到 task_id,再每 10 到 15 秒查询 GET /v1/video/generations/{task_id},直到 data.status 为 SUCCESS,视频链接在 data.result_url。
resolution 和 duration 要写在哪里?
写在请求顶层,和 Seedance 2.5 Pro 一样。2.5 一代不读 metadata,只把 resolution 写进 metadata 会被拒绝,错误码 invalid_resolution。
生成一段视频要等多久?
2.5 Pro 实测 4 到 5 秒 720p 的视频约需 5 分钟;Flash 定位是更快的档位,实际耗时受排队和分辨率影响。建议每 10 到 15 秒查询一次任务状态。
Seedance 2.5 Flash 和 2.5 Pro、2.0 Fast 有什么不同?
Flash 与 Pro 同属 2.5 一代,请求格式一样,输出设置在顶层;区别在速度与价格档位。2.0 Fast 是上一代,resolution、ratio、duration 写在 metadata 里,两种请求体不能混用。
result_url 是永久链接吗?
不是。result_url 是临时链接,请在任务成功后自行下载并保存文件。
"Seedance"及相关名称可能为其各自权利人的商标。本页面由 TokenRa 独立制作,仅提供模型信息与使用建议,并非相关权利人的官方页面或授权声明。