TokenRaTokenRa
登录 注册

视频模型 · 字节跳动

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

怎么调用

POSThttps://tokenra.io/v1/video/generations
创建任务,立即返回 task_id;视频不会在这一步返回。
GEThttps://tokenra.io/v1/video/generations/{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

请求参数

参数类型必填说明
modelstring是本页用 seedance-2.5-flash。
promptstring是画面、动作与镜头描述;用 content 且其中含 text 项时可省略。
resolutionstring是顶部字段,可选 480p 或 720p;同时决定计费档位。写进 metadata 会被拒绝。
ratiostring否画面比例,如 16:9、9:16。
durationinteger否视频时长(秒),不传时取默认值。
generate_audioboolean否是否生成音轨,默认开启;传 false 得到无声视频。
imagesstring[]否参考图链接数组。
contentarray否逐项控制素材,可代替 prompt 与 images。
不支持的写法:本页所依据的 2.5 接口只从顶层读输出设置;metadata 会被忽略,只在 metadata 里传 resolution 会返回 invalid_resolution。视频与音频参考(video_url、audio_url)会报 unsupported content type;seed、watermark、callback_url 等字段会被直接丢弃且不报错,别指望它们生效。

Errors

常见错误

HTTP错误信息原因与处理
400invalid_resolution没传 resolution、传了 480p/720p 以外的值,或只写进了 metadata。改到顶层重发。
400prompt is required没有 prompt,content 里也没有 text 项。
401Invalid tokenAPI Key 缺失、错误或已删除;检查 Authorization: Bearer 请求头。
403insufficient_user_quota余额或套餐额度不足,充值后重试。
429—请求过于频繁,指数退避后重试。
503model_not_found模型 ID 不存在,或当前分组下没有可用渠道;用 GET /v1/models 核对。

Comparison

和 2.5 Pro、2.0 Fast 的区别

2.5 Flash2.5 Pro2.0 Fast
代次2.52.52.0
定位更快、更省的档位旗舰画质上一代快速档
输出设置位置请求顶层请求顶层metadata 内
分辨率480p / 720p720p / 1080p2.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 独立制作,仅提供模型信息与使用建议,并非相关权利人的官方页面或授权声明。