# Seedance 2.5 Flash API(TokenRa) 模型 ID:`seedance-2.5-flash` 获取 API Key:https://tokenra.io/sign-up?utm_source=llms-agent&utm_medium=model-llms 更新日期:2026-11-21 > Seedance 2.5 Flash 是字节跳动 Seedance 2.5 视频模型中偏重速度与成本的版本,在 TokenRa 上的模型 ID 为 `seedance-2.5-flash`。支持文本和参考图输入,输出带音轨的视频;请求格式与 Seedance 2.5 Pro 相同,并额外支持 480p 输出。 - 厂商:字节跳动 - 类型:视频模型 - 输入:文本、参考图 - 输出:480p 或 720p 视频 - 调用方式:异步任务 ## 价格 以下为本文件最后更新时 TokenRa 控制台的价格,单位美元,默认分组。请以实时价格为准:https://tokenra.io/pricing(JSON:https://tokenra.io/api/pricing)。 - `seedance-2.5-flash`:480p 与 720p 同价,$6.522 / 100 万视频 token(视频任务按实际消耗的 token 计费,见 `usage.total_tokens`) ## 能力与接口 视频生成是异步的:先创建任务,再轮询结果。请求体与 Seedance 2.5 Pro 完全一致,两个版本之间切换只需改 `model` 字段。2026-11-16 实测的一次 Flash 任务约 2 分钟完成。 - `POST https://tokenra.io/v1/video/generations`:创建任务,立即返回 `task_id`。 - `GET https://tokenra.io/v1/video/generations/{task_id}`:查询任务;`data.status` 为 `SUCCESS` 时,视频链接在 `data.result_url`。 ## 示例 先把 `TOKENRA_API_KEY` 设为你的 API Key。文档页提供同一示例的 Python、JavaScript 和 Java 版本。 ```bash # 1. 创建任务,响应里包含 task_id curl 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": "480p", "ratio": "16:9", "duration": 5 }' # 2. 每 10–15 秒查询一次,直到 data.status 为 SUCCESS 或 FAILURE curl https://tokenra.io/v1/video/generations/TASK_ID \ -H "Authorization: Bearer $TOKENRA_API_KEY" ``` ## 生成场景 ### A. 文生视频 输出设置直接写在请求顶层。下面的示例请求 480p,这是仅 Flash 支持的输出档位。 ```json { "model": "seedance-2.5-flash", "prompt": "雨夜霓虹街道上漂流的纸船,电影感特写镜头", "resolution": "480p", "ratio": "9:16", "duration": 4, "generate_audio": false } ``` ### B. 参考图生视频 `images` 中的图片会作为参考图传给模型,常用于固定人物、产品或包装的样貌。 ```json { "model": "seedance-2.5-flash", "prompt": "标志卡片缓慢推近,一道柔光从画面上扫过", "images": ["https://example.com/logo-card.png"], "resolution": "720p" } ``` ## 请求参数 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`,写在请求顶层,不传会被拒绝。需要 1080p 请用 Seedance 2.5 Pro。 | | `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` 等其他字段会被直接丢弃,不会报错。 ## 响应格式 查询任务的响应(`GET /v1/video/generations/{task_id}`): ```json { "code": "success", "message": "", "data": { "task_id": "task_RxuCqxISrGGv04KFM4xStexL4PW60sCC", "action": "generate", "status": "SUCCESS", "fail_reason": "", "result_url": "https://example.com/output.mp4", "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 数。`data.status` 取值为 `NOT_START`、`SUBMITTED`、`QUEUED`、`IN_PROGRESS`、`SUCCESS` 或 `FAILURE`;失败时原因见 `fail_reason`,预扣费用会退回。 ## 错误与限制 | HTTP | code | message | 原因 | | --- | --- | --- | --- | | `400` | `invalid_resolution` | `resolution must be 480p, 720p or 1080p` | 未传 `resolution`、传了所列以外的值,或只写在 `metadata` 里。 | | `400` | `invalid_request` | `prompt is required` | 没有 `prompt`,`content` 中也没有 `text` 项。 | | `500` | `build_request_failed` | `unsupported content type: video_url` | `content` 中有 `text`、`image_url` 以外的素材类型。 | | `401` | - | `Invalid token` | API Key 缺失、错误或已删除。 | | `403` | `insufficient_user_quota` | - | 余额或套餐额度不足,充值后重试。 | | `503` | `model_not_found` | - | 模型 ID 不存在,或你的分组下没有可用渠道。 | - 建议每 10–15 秒查询一次。 - `result_url` 是临时链接,请自行下载保存。 ## 更多 - [Seedance 2.5 Flash API 文档页](https://tokenra.io/zh/docs/seedance-2-5-flash.html):参数表与 cURL、Python、JavaScript、Java 示例 - [Seedance 2.5 Flash 模型介绍与价格](https://tokenra.io/zh/models/seedance-2-5-flash.html) - [Seedance 2.5 Pro 指南](https://tokenra.io/zh/docs/artsdance-2-5-pro-260801/llms.txt):请求格式相同,支持 720p 与 1080p - [公共信息](https://tokenra.io/zh/docs/common.html):Base URL、鉴权、错误码与重试 - [全部模型](https://tokenra.io/zh/docs/models.html) - [本指南英文版](https://tokenra.io/docs/seedance-2-5-flash/llms.txt) - [站点索引](https://tokenra.io/llms.txt) --- 本文档的规范地址:https://tokenra.io/zh/docs/seedance-2-5-flash/llms.txt