LSF Seedance 2.5 Production creates videos from prompts and supported image, video and audio references. Choose Lite, Standard or Pro to match your output requirements, with resolutions up to 8K and controls for frame rate, bitrate and optional last-frame delivery.
Submit one request, track one public task and receive the finished video. Use the Production model alias for your selected tier. return_last_frame is unsupported for MOV, 6K and 8K delivery; omit it or set it to false. Other supported MP4 profiles require enabled last-frame delivery.
6.1 Product selection and outputs
| Tier | Use this alias | Allowed tier-specific fields |
|---|---|---|
| Lite | <YOUR_PRODUCTION_LITE_MODEL_ALIAS> | Common FPS and bitrate controls. No scene, enhance_style or bit_depth. |
| Standard | <YOUR_PRODUCTION_STANDARD_MODEL_ALIAS> | scene; enhance_style; common controls. No bit_depth. |
| Pro | <YOUR_PRODUCTION_PRO_MODEL_ALIAS> | enhance_style; bit_depth; codec on enabled profiles; common controls. No scene. |
Select Lite, Standard or Pro through model, not tool_version. Choose a resolution explicitly; there is no default. Production accepts named resolutions, not resolution_limit.
| Tier | Resolution values | 6K / 8K format |
|---|---|---|
| Lite | 1080p, 2k, 4k | Not supported |
| Standard | 1080p, 2k, 4k, 6k, 8k | H.264, 8-bit, 4:2:0, MP4 |
| Pro | 1080p, 2k, 4k, 6k, 8k | HEVC, 10-bit, 4:4:4, MP4 |
6K uses a 3456-pixel short side; 8K uses 4320. Exact 16:9 produces 6144 × 3456 or 7680 × 4320 respectively. Other source ratios retain their proportions; the longer side is rounded upward to an even pixel. Delivery does not crop or stretch a near-matching ratio into a fixed canvas. For Pro 6K/8K, use codec=h265, bit_depth=10 and output_format=mp4. Standard omits codec and bit_depth. HEVC 10-bit 4:4:4 requires compatible software. Production 6K/8K does not support ProRes or MOV.
6.2 Request fields
| Field | Required | Product behaviour |
|---|---|---|
| model | Yes | Exact LSF Seedance 2.5 Production tier alias provided for your account. |
| prompt | Conditional | Required for text-only generation; optional with supported reference or frame content. The same input-mode rules apply to 6K and 8K. |
| metadata.duration | Optional | JSON integer: omit, use -1, or specify 4–30 subject to the input-mode rules. Omission/-1 selects automatic duration and reserves against 30 output seconds. Edit accepts only omission/-1. Final billing uses the delivered duration. |
| metadata.resolution | Yes | Required: 1080p, 2k or 4k; Standard / Pro also support 6k and 8k. See section 6.1. There is no default. |
| metadata.content | For reference / frame input | Ordered image_url, video_url and audio_url items with the roles in section 5.6. Video references can use an accessible HTTPS URL or an authorized asset:// URI. |
| metadata. omni_reference_task_type |
Optional | auto, reference, edit or extend with the native Seedance 2.5 mode rules in section 5.7. |
| metadata.ratio | Optional | Text / reference: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9. Frame control, edit and extend: adaptive only. |
| metadata.generate_audio | Optional | Boolean; set explicitly when the application requires a specific audio behavior. |
| metadata.watermark | Optional | Boolean watermark request. |
| metadata.fps | Optional | Sets output FPS: a finite JSON number from 15 to 120, including fractional values. Omission defaults to 24 FPS. There is no FPS surcharge for LSF Seedance 2.5 Production. |
| metadata.bitrate_level / bitrate | Optional | Preset low / medium / high, or an integer target bitrate of 10–150000 kbps. Use one of these controls per request. |
| metadata.scene | Standard only | common, ugc, short_series, aigc or old_film. Standard omission is set to common. |
| metadata.enhance_style | Standard / Pro only | hd or natural. |
| metadata.bit_depth | Pro only | Use the bit depth supported by your selected output format. Pro 6K/8K requires 10 with codec=h265 and MP4. Values 8, 12 and 16 are not interchangeable alternatives for that format. Bit depth alone does not establish HDR. |
| metadata.codec | Enabled Pro profile only | String; requires explicit bit_depth. Pro 6K/8K uses h265 with bit_depth=10 and MP4. Standard / Lite omit codec. See section 6.1. |
| metadata. return_last_frame |
Optional | Unsupported for MOV, 6K and 8K: omit or set false. For other supported MP4 profiles, true requests a JPG when enabled. This is separate from an input last_frame reference. |
| metadata.output_format | Optional | Must match the enabled codec / bit-depth combination. Use mp4, or omit, for Standard / Pro 6K/8K. A container name alone does not select a codec. |
| metadata.client_request_id | Strongly recommended | Optional; strongly recommended. 1–128 characters from A–Z, a–z, 0–9 and . _ : - . Same-key identical replays return the existing task. Follow section 4.1. |
The only top-level fields are model, prompt and metadata; metadata must be an object. Put generation and output controls inside it. metadata.codec is available for supported Pro output formats and requires bit_depth; see section 6.1. Do not send top-level codec, mode, task_type, tool_version, video_url, bitrate_mode, seed, camera_fixed, draft, draft_task, resolution_limit or callbacks. Reference videos belong in metadata.content for supported profiles, including Standard and Pro 6K/8K. Use the URL and asset rules in section 6.5.
The reference limits are 30 reference images, 10 videos, 10 audio items and 50 total media items. Keep their order. First-frame input may be used alone or with one last frame; a last frame alone, audio-only reference input and mixing frame-control items with reference media are not supported. Frame, edit and extend modes require adaptive ratio. Edit/extend require a reference video; edit requires automatic output duration. Input-media requirements also apply, so use reference media within the limits confirmed by LSF.
6.3 Example A · Standard text to 1080p
POST /v1/videos
{
"model": "<YOUR_PRODUCTION_STANDARD_MODEL_ALIAS>",
"prompt": "A ceramic cup on a desk in soft daylight. The camera is still.",
"metadata": {
"duration": 5,
"resolution": "1080p",
"fps": 24,
"scene": "common",
"generate_audio": false,
"return_last_frame": false,
"client_request_id": "production-standard-001"
}
}
A successfully accepted LSF Seedance 2.5 Production request returns HTTP 202. Save its public task identifier and track that task until the finished video is ready. No additional processing request is needed.
{
"id": "<YOUR_TASK_ID>",
"task_id": "<YOUR_TASK_ID>",
"status": "queued"
}
This response shows selected fields. Query the same public task with an authorized API key; see section 2 for key rotation. Section 4.2 documents the shared Production and Flash response format. An accepted identical replay returns HTTP 200 and the current task view.
6.4 Example B · Lite 2K with an HTTPS video reference
POST /v1/videos
{
"model": "<YOUR_PRODUCTION_LITE_MODEL_ALIAS>",
"prompt": "Use @Video1 as a motion reference for a new product scene.",
"metadata": {
"duration": 5,
"resolution": "2k",
"fps": 60,
"generate_audio": false,
"content": [
{
"type": "video_url",
"role": "reference_video",
"video_url": {
"url": "https://example.com/reference-video.mp4"
}
}
],
"return_last_frame": false,
"client_request_id": "production-lite-reference-001"
}
}
metadata.duration requests the output duration; it is not the input-video duration. LSF validates the input video and measures its duration before calculating the initial charge estimate.
6.5 Video URLs, assets and measured input duration
| Input form | How it is handled |
|---|---|
| HTTPS video URL | LSF validates the video and measures its duration before acceptance. Supply a direct, stable and accessible media URL. A link that plays in a browser can still fail this validation. |
| asset:// video reference | The asset must be authorized for your account, have video type and Active status, and be accessible to LSF. LSF measures the video’s duration automatically. |
| Multiple video references | Input seconds are accumulated across the submitted video inputs. Fractional seconds are preserved; do not round each reference up. Repeated video inputs can contribute repeatedly. |
| Image or audio references | Do not add input-video seconds. A last-frame still image also remains a no-video-input request unless a video is included. |
| Accepted identical replay | Reuses the input-duration and pricing information already accepted for that task. It does not re-measure accepted inputs or create a new paid job. |
| New request | Requires the referenced media to remain authorized and accessible. Do not assume a previous URL or permission check remains valid indefinitely. |
Provide URLs that remain accessible long enough for validation and processing. Private or loopback destinations, unsafe redirects and unsupported or unstable media access are rejected. Validation may require byte-range access; a server that cannot provide consistent media metadata may be unsuitable.
LSF measures reference-video duration automatically and uses that measurement for billing. Do not send a separate input-video duration field.
6.6 Pro 4K and Standard / Pro 6K and 8K examples
Pro 4K with a video asset and last frame
POST /v1/videos
{
"model": "<YOUR_PRODUCTION_PRO_MODEL_ALIAS>",
"prompt": "Use @Video1 as a reference for smooth camera motion and lighting.",
"metadata": {
"duration": 5,
"resolution": "4k",
"fps": 24,
"generate_audio": false,
"content": [
{
"type": "video_url",
"role": "reference_video",
"video_url": {
"url": "asset://<YOUR_VIDEO_ASSET_ID>"
}
}
],
"return_last_frame": true,
"client_request_id": "production-pro-asset-001"
}
}
Do not include scene in a Pro request. Use only an asset ID that is authorized and Active. Virtual and real-human asset creation and verification remain distinct workflows; a real-human asset does not bypass its verification requirements.
Last-frame behavior
-
return_last_frame=true requests a JPG only for a supported MP4 profile with enabled last-frame delivery. MOV, 6K and 8K do not support it; omit the field or set it to false for those outputs.
-
An input content item with role=last_frame is a generation constraint. It does not request extraction of the delivered video’s last frame.
-
The requested outputs belong to the same public task. Do not submit a separate frame-extraction request; optional last-frame extraction is not billed as a separate customer API job.
-
Use the returned last-frame URL only when present on a successful result, and store it promptly if it is needed for subsequent work.
-
Keep your own project and source records when reusing a frame in another request; a returned frame URL is not proof of media provenance.
The following examples request 6K or 8K video. Send one body to POST /v1/videos using your assigned Production tier alias. Duration, ratio and FPS can vary within section 6.2. Keep return_last_frame omitted or false for these outputs.
Standard 6K example
{
"model": "<YOUR_PRODUCTION_STANDARD_MODEL_ALIAS>",
"prompt": "A red paper kite moves across a clear sky.",
"metadata": {
"duration": 4,
"ratio": "16:9",
"resolution": "6k",
"fps": 24,
"generate_audio": true,
"return_last_frame": false,
"client_request_id": "production-standard-6k-001"
}
}
Pro 6K example
{
"model": "<YOUR_PRODUCTION_PRO_MODEL_ALIAS>",
"prompt": "A red paper kite moves across a clear sky.",
"metadata": {
"duration": 4,
"ratio": "16:9",
"resolution": "6k",
"fps": 24,
"generate_audio": true,
"codec": "h265",
"bit_depth": 10,
"output_format": "mp4",
"return_last_frame": false,
"client_request_id": "production-pro-6k-001"
}
}
Standard 8K example
{
"model": "<YOUR_PRODUCTION_STANDARD_MODEL_ALIAS>",
"prompt": "A red paper kite moves across a clear sky.",
"metadata": {
"duration": 4,
"ratio": "16:9",
"resolution": "8k",
"fps": 24,
"generate_audio": true,
"return_last_frame": false,
"client_request_id": "production-standard-8k-001"
}
}
Pro 8K example
{
"model": "<YOUR_PRODUCTION_PRO_MODEL_ALIAS>",
"prompt": "A red paper kite moves across a clear sky.",
"metadata": {
"duration": 4,
"ratio": "16:9",
"resolution": "8k",
"fps": 24,
"generate_audio": true,
"codec": "h265",
"bit_depth": 10,
"output_format": "mp4",
"return_last_frame": false,
"client_request_id": "production-pro-8k-001"
}
}
Use the API value h265 for HEVC. Pixel format describes the delivered file: do not send pixel_format or a chroma-subsampling parameter. Production Pro 6K/8K uses 10-bit 4:4:4 and requires a compatible decoder; common browser and hardware playback paths may not support it.
6.7 Results and progress
LSF Seedance 2.5 Production continues automatically after acceptance; GET reports progress. Keep polling the original task through nonterminal states. A completed result provides the finished video. Standard and Pro 6K/8K deliver MP4 without a last-frame JPG. Other supported MP4 profiles may return a separately requested last-frame image.
| Response item | Client handling |
|---|---|
| id / task_id | Store the public task identifier returned at creation; use it for subsequent GET requests. |
| status | queued and in_progress are nonterminal; completed and failed are terminal. A successful HTTP GET does not itself mean the video succeeded. Do not create a new job because progress is slow. |
| metadata.url | Finished video URL. seconds and metadata.duration, fps and resolution are strings when returned. Save the final response alongside your billing records. |
| metadata.last_frame_url | Optional final-frame image URL. Absent optional fields are omitted, not filled with null. Do not assume this field exists when extraction was not requested or the task has not completed successfully. |
| error | On failure, use the documented error code/message returned by LSF. Do not build client logic around undocumented service details. |
LSF Seedance 2.5 Production does not currently echo client_request_id in this response. Keep your own request-ID to task-ID mapping. Progress values are indicative, not a promised completion schedule. Named resolutions identify output bands and do not guarantee one exact width and height across aspect ratios.
Result URLs are temporary
After completed, download from metadata.url or use the authenticated original-file route below. Download metadata.last_frame_url separately when present. Copy needed files to your own storage; neither route is a permanent archive or a promise of unlimited link renewal.
Download the original video
When status is completed, download the file with a key authorized to read the task:
curl --fail --show-error \
'https://ai-api.lightspeedfuture.com/v1/videos/<YOUR_TASK_ID>/content' \
--header 'Authorization: Bearer <LSF_API_KEY>' \
--output result.mp4.part
Rename the temporary file after the transfer completes and your integrity checks pass. Keep your API key on your backend; do not forward the LSF Bearer token to an external media URL. If the transfer fails, download the same task result again without creating a new video. Result access is temporary; save files promptly. Resumable downloads are not guaranteed.
Output file information
| Optional response field | Meaning |
|---|---|
| metadata.requested_encoding | Requested codec, bit depth, file format and result type; not a measurement of the file. |
| metadata.output_metadata | Available details about the output file, such as codec and bit depth. |
| metadata.delivery_contract | Available media specifications and compatibility information. |
| metadata.delivery_contract.media | Dimensions, frame rate, frame count, pixel format and duration when available. |
Allow optional fields to be absent and additional fields to appear. Check the downloaded file in your intended software when exact format compatibility matters.
In the Production preview, “Default encoding” means no explicit encoding was requested. Upstream-reported specifications show only available values and remain unverified against the file; when none are reported, the preview says “Upstream did not provide encoding specifications.” Missing reports do not establish an incorrect codec. Only existing measured delivery information may be presented as measured.
6.8 Pricing, initial estimate and final billing
| Output | Base USD per billable second No video input |
Base USD per billable second With video input |
|---|---|---|
| Standard 6K H.264 MP4 | 0.69 | 0.552 |
| Pro 6K HEVC 10-bit MP4 | 3.49 | 2.792 |
| Standard 8K H.264 MP4 | 0.99 | 0.792 |
| Pro 8K HEVC 10-bit MP4 | 4.49 | 3.592 |
These are reference base rates. Your effective account rate includes the applicable account pricing terms. With video references, the video-input rate applies to the entire combined duration: measured input-video seconds plus rounded-up reported output seconds. For other resolutions, use the rate agreed for your account.
Use the effective rate agreed for your account, tier, resolution and input mode. It already includes any agreed account adjustment; do not apply that adjustment twice. Account-specific rates may differ between Production and Flash. There is no additional FPS multiplier for this product.
| Input mode | Chargeable duration | Final charge basis |
|---|---|---|
| No video input | Final output duration rounded up to a whole second | Agreed no-video rate × rounded output seconds |
| Any video input | Sum of measured input-video seconds + final output duration rounded up to a whole second | Agreed video-input rate × combined seconds |
A still image, a first/last-frame image or an audio-only reference does not by itself activate video-input pricing. Reference video, editing, extension and mixed inputs containing video do. Use the video-input rate for the same tier and resolution, not a rate from another tier.
Worked duration examples — no price quotation
| Request | Calculation | Chargeable seconds |
|---|---|---|
| No video input; final output 5.042 s | ceil(5.042) | 6 |
| One 5.000 s input video; final output 5.017 s | 5.000 + ceil(5.017) | 11 |
| Input videos 2.125 s and 3.000 s; final output 5.042 s | 2.125 + 3.000 + ceil(5.042) | 12.125 |
| One still image only; final output 5.042 s | ceil(5.042), no video-input seconds | 6 |
The initial reservation uses the requested output duration, or 30 output seconds when duration is omitted or -1, plus measured input-video seconds where applicable. A reservation is not a spending cap. Final billing uses the output duration reported in your task result rounded up to a whole second, which can differ from the requested length and the measured video-stream duration.
The effective rate and measured input information accepted for a task remain fixed. Later price or account-setting changes do not reprice it. LSF calculates the final charge once from the delivered result and adds or releases the difference from the reservation. Repeated GET and an accepted identical replay do not duplicate charges. Final account records take precedence over rounded display values.
One LSF Seedance 2.5 Production task has one customer charge, including an enabled, requested last-frame image. A confirmed task failure, including failure to deliver a requested last frame, releases the full reservation with no final customer charge. A timeout or unknown submission outcome is not a confirmed failure; keep the original task ID and contact LSF if its status remains unclear.
Duration and playback
Generated duration is a target, not an exact frame-count guarantee. For example, a reported output duration of 4.065 seconds is billed as five seconds. At the Standard 8K base rate without video input, that is USD4.95 before account-specific terms.
Download the video for use in a player or editor that supports its resolution and codec. Pro 6K/8K HEVC 10-bit 4:4:4 is not universally supported by browsers or hardware decoders. Audio timing can differ slightly at the end of a compressed track; check the result when editing to a precise timeline. A 10-bit file does not by itself promise HDR, a particular color space or lossless preservation.
6.9 Request rejection and safe recovery
| Condition | What to do |
|---|---|
| Product or output combination not enabled | Confirm the supplied alias and account availability with LSF. |
| Wrong tier fields | Remove scene from Pro; remove scene, enhance_style and bit_depth from Lite; do not use tool_version to select a LSF Seedance 2.5 Production tier. |
| Unusable asset / URL / duration | Correct the source or authorization before creating an intentionally new request. Do not submit a manually asserted input duration to bypass validation. |
| Insufficient allowance | Check GET /v1/billing/balance and leave sufficient balance for the final charge. |
| Accepted task remains nonterminal | Keep the original task and request ID; resume GET. Contact LSF with the public ID if progress remains uncertain. |
| Terminal failure | Inspect the error and resulting balance adjustment. Start a new job only deliberately, after addressing the cause. |