# Seedance 2.5 Flash API on TokenRa Model ID: `seedance-2.5-flash` Get an API key: https://tokenra.io/register?utm_source=llms-agent&utm_medium=model-llms Updated: 2026-11-21 > Seedance 2.5 Flash is the speed-focused tier of ByteDance's Seedance 2.5 video model, served on TokenRa under the ID `seedance-2.5-flash`. It takes text and reference images and returns a video with audio, and it uses the same request format as Seedance 2.5 Pro, with 480p added as a cheaper output size. - Provider: ByteDance - Type: Video model - Input: Text, reference images - Output: 480p or 720p video - Mode: Async task ## Pricing Rates in the TokenRa console when this file was last updated, in US dollars for the default group. The live price list is authoritative: https://tokenra.io/pricing (JSON: https://tokenra.io/api/pricing). - `seedance-2.5-flash`: $6.522 per 1M video tokens at 480p and 720p alike (a video task is charged by the tokens it uses, reported in `usage.total_tokens`) ## Capabilities & endpoints Video generation is asynchronous: create a task, then poll it. The body is the one Seedance 2.5 Pro accepts, so moving between the two tiers is a change to the `model` field only. A Flash task run on 2026-11-16 finished in about two minutes. - `POST https://tokenra.io/v1/video/generations`: Create a task. Returns `task_id` immediately. - `GET https://tokenra.io/v1/video/generations/{task_id}`: Query the task. The video link is in `data.result_url` when `data.status` is `SUCCESS`. ## Example Set `TOKENRA_API_KEY` to your API key first. The docs page has the same example in Python, JavaScript and Java. ```bash # 1. Create the task. The response contains 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": "A paper boat drifting down a rainy neon street at night, cinematic close-up", "resolution": "480p", "ratio": "16:9", "duration": 5 }' # 2. Poll every 10-15 s until data.status is SUCCESS or FAILURE. curl https://tokenra.io/v1/video/generations/TASK_ID \ -H "Authorization: Bearer $TOKENRA_API_KEY" ``` ## Generation modes ### A. Text to video Output settings sit at the top level of the request. This example asks for 480p, the size only the Flash tier accepts. ```json { "model": "seedance-2.5-flash", "prompt": "A paper boat drifting down a rainy neon street at night, cinematic close-up", "resolution": "480p", "ratio": "9:16", "duration": 4, "generate_audio": false } ``` ### B. Reference images Image URLs in `images` are passed to the model as reference images, usually to pin a character, product or packaging look. ```json { "model": "seedance-2.5-flash", "prompt": "The logo card slowly zooms in while a soft light sweeps across it", "images": ["https://example.com/logo-card.png"], "resolution": "720p" } ``` ## Request parameters Seedance 2.5 Flash reads `resolution`, `ratio`, `duration` and `generate_audio` from the top level of the request. This is the opposite of Seedance 2.0, which reads them from `metadata`. | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `model` | string | Yes | `seedance-2.5-flash` | | `prompt` | string | Yes | Describe the scene, the motion and the camera. Optional when `content` contains a `text` item. | | `resolution` | string | Yes | `480p` or `720p`, at the top level. A missing value is rejected. For 1080p output use Seedance 2.5 Pro. | | `ratio` | string | No | Aspect ratio such as `16:9` or `9:16`. | | `duration` | integer | No | Length in seconds. Default 5. | | `generate_audio` | boolean | No | Generate a soundtrack. On by default; `false` returns a silent video. | | `images` | string[] | No | Reference image URLs, see mode B. | | `content` | array | No | Text and image items in the same shape as Seedance 2.5 Pro. Replaces `prompt` and `images`. | Not supported on TokenRa: - `metadata` is ignored. A request that puts `resolution` only in `metadata` is rejected with `invalid_resolution`. - Video and audio references are not available: `video_url` and `audio_url` items fail with `unsupported content type`. - Only the fields in the table are sent to the model. Others, such as `seed`, `watermark`, `return_last_frame` or `callback_url`, are dropped without an error. ## Response format Query response (`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` holds the raw upstream task; `usage.total_tokens` is the billed video token count. `data.status` is one of `NOT_START`, `SUBMITTED`, `QUEUED`, `IN_PROGRESS`, `SUCCESS` or `FAILURE`; on failure the reason is in `fail_reason` and the pre-charged amount is refunded. ## Errors & limits | HTTP | code | Message | Cause | | --- | --- | --- | --- | | `400` | `invalid_resolution` | `resolution must be 480p, 720p or 1080p` | `resolution` missing, not one of the listed values, or only inside `metadata`. | | `400` | `invalid_request` | `prompt is required` | No `prompt` and no `text` item in `content`. | | `500` | `build_request_failed` | `unsupported content type: video_url` | A `content` item other than `text` or `image_url`. | | `401` | - | `Invalid token` | Missing, wrong or deleted API key. | | `403` | `insufficient_user_quota` | - | Balance or plan quota used up; top up and retry. | | `503` | `model_not_found` | - | Unknown model ID, or no channel serves it for your group. | - Poll every 10-15 seconds. - `result_url` is a temporary link. Download and store the video yourself. ## More - [Seedance 2.5 Flash API docs page](https://tokenra.io/docs/seedance-2-5-flash.html): parameter tables and code samples in cURL, Python, JavaScript and Java - [Seedance 2.5 Flash overview and pricing page](https://tokenra.io/models/seedance-2-5-flash.html) - [Seedance 2.5 Pro guide](https://tokenra.io/docs/artsdance-2-5-pro-260801/llms.txt): same request format, 720p and 1080p - [API basics](https://tokenra.io/docs/common.html): base URL, authentication, errors, retries - [All models](https://tokenra.io/docs/models.html): every model ID - [Chinese version of this guide](https://tokenra.io/zh/docs/seedance-2-5-flash/llms.txt) - [Site index for agents](https://tokenra.io/llms.txt) --- Canonical version of this document: https://tokenra.io/docs/seedance-2-5-flash/llms.txt