Updated 10 November 2026 · API Guide v2.10.5
LSF Seedance 2.5 Flash combines the strengths of Seedance 2.5 on BytePlus ModelArk with ByteDance’s advanced video technologies to deliver fast, high-quality video generation.
Submit one task, track its progress and download the finished MP4. Full parameter and billing reference: LSF API Integration Guide v2.10.5, section 7.
1. Prepare your request
Set LSF_API_KEY in your server environment and replace the model placeholder with your assigned Fast alias. Save the following body as flash-request.json before submitting it. Use a new request ID for this first, intentionally new job; keep the saved body unchanged for any recovery replay.
{
"model": "<YOUR_FLASH_FAST_MODEL_ALIAS>",
"prompt": "A paper boat floats across a quiet pond.",
"metadata": {
"client_request_id": "flash-demo-001",
"duration": 5,
"resolution": "1080p",
"fps": 120,
"ratio": "9:16",
"generate_audio": false,
"return_last_frame": false
}
}
2. Submit the saved request
Submit the saved request:
curl --request POST \
"https://ai-api.lightspeedfuture.com/v1/videos" \
--header "Authorization: Bearer ${LSF_API_KEY}" \
--header "Content-Type: application/json" \
--data-binary @flash-request.json
A first accepted request returns HTTP 202. An illustrative response is:
{
"id": "task_example",
"task_id": "task_example",
"object": "video",
"model": "<YOUR_FLASH_FAST_MODEL_ALIAS>",
"status": "queued",
"progress": 0,
"created_at": 1792100000
}
3. Track the task
Save id as the public task ID, set LSF_TASK_ID to that value, and retrieve it with the same key:
curl "https://ai-api.lightspeedfuture.com/v1/videos/${LSF_TASK_ID}" \
--header "Authorization: Bearer ${LSF_API_KEY}"
Poll every 30 seconds or longer until completed or failed. LSF advances the workflow automatically. On completed, read metadata.url and copy the media to your own storage. If the create response is lost, preserve the same key, request ID and body; do not create a replacement job just to find out what happened.
This example deliberately requests 5 seconds and disables generated audio. Omitting duration or setting -1 selects automatic duration and reserves against 30 output seconds. Omitted audio and watermark fields do not mean false. Omitted fps preserves source FPS rather than requesting 120 FPS.
4. Read the final result
{
"id": "task_example",
"task_id": "task_example",
"object": "video",
"model": "<YOUR_FLASH_FAST_MODEL_ALIAS>",
"status": "completed",
"progress": 100,
"seconds": "5.025",
"metadata": {
"url": "https://example.com/final.mp4",
"duration": "5.025",
"fps": "120",
"resolution": "1080p"
}
}
This response shows selected fields. Download metadata.url promptly. Duration and FPS values in this response are strings. Flash delivers a finished video. For a separate preview-and-approve workflow, use Native Seedance 2.5 Draft Mode. A confirmed failed task releases its reservation; a timeout alone does not confirm failure.
5. Keep retries and billing predictable
Use a unique request ID per intended job across all video products on the same key. For an uncertain POST, keep the same key, ID and saved body. An accepted identical replay returns the current task with HTTP 200; a different request under the same ID can return HTTP 409. Once a task ID is known, use GET.
If you rotate credentials, use a valid replacement key issued for the same LSF tenant and account, with the required permissions, to retrieve the original task. Do not replay the old POST under the new key: request IDs are scoped per key and a new submission can incur a separate charge. See section 2 of the full guide.
A 5-second request initially reserves 5 output seconds; a delivered 5.025-second result bills 6 output seconds. Video-reference requests also include measured original input-video seconds. Use your agreed LSF Seedance 2.5 Flash price. One Flash task has one customer charge, with no FPS surcharge.
6. Get support
Support: [email protected]. Share the public task ID, request ID, time and returned error; keep API keys and private media links out of ordinary support messages.
Choose a supported output
This example uses Fast 1080p. Fast supports up to 4K; Standard adds 6K and 8K. For 6K or 8K, omit return_last_frame or set it to false. Audio-only references are not supported. Use the complete Flash reference for a different input mode or output profile.