TokenRa
English登录注册

视频模型 · 字节跳动

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 支持的输出档位。

POST /v1/video/generations
{
  "model": "seedance-2.5-flash",
  "prompt": "雨夜霓虹街道上漂流的纸船,电影感特写镜头",
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 4,
  "generate_audio": false
}

B. 参考图生视频

images 中的图片会作为参考图(reference_image)传给模型,常用于固定人物、产品或包装的样貌。需要特定比例和时长时请显式传入,不要依赖默认值。

POST /v1/video/generations
{
  "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 读取的方式相反。
参数类型必填说明
modelstring是seedance-2.5-flash
promptstring是画面、动作与镜头描述。使用 content 且其中包含 text 项时可省略。
resolutionstring是480p 或 720p,写在请求顶层,不传会被拒绝。Seedance 2.5 系列中仅 Flash 提供 480p;需要 1080p 请用 Seedance 2.5 Pro。同时决定任务消耗的 token 数。
ratiostring否画面比例,如 16:9、9:16。
durationinteger否视频时长(秒),默认 5。
generate_audioboolean否是否生成音轨,默认开启;传 false 得到无声视频。
imagesstring[]否参考图链接数组,见 B 模式。
contentarray否文本与图片素材,格式与 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

响应格式

创建任务的响应

200 OK
{
  "id": "task_RxuCqxISrGGv04KFM4xStexL4PW60sCC",
  "task_id": "task_RxuCqxISrGGv04KFM4xStexL4PW60sCC",
  "object": "video",
  "model": "seedance-2.5-flash",
  "status": "queued",
  "progress": 0,
  "created_at": 1794831017
}

查询任务的响应

200 OK
{
  "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

错误与限制

该模型的参数错误

HTTPcodemessage原因
400invalid_resolutionresolution must be 480p, 720p or 1080p未传 resolution、传了 message 所列以外的值,或只写在 metadata 里。
400invalid_requestprompt is required没有 prompt,content 中也没有 text 项。
500build_request_failedunsupported content type: video_urlcontent 中有 text、image_url 以外的素材类型。

常见错误

HTTPerror.code含义处理建议
401—API Key 缺失、错误或已删除,message 为 Invalid token。检查 Authorization: Bearer 请求头,并在控制台核对 Key。
400—请求体不是合法 JSON。修正 JSON,并带上 Content-Type: application/json。
500invalid_request缺少必填字段,例如未传 messages。按 message 补全字段,重试无效。
403insufficient_user_quota账户余额或套餐额度不足。在控制台充值后重试。
503model_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)。实时价格见模型广场。