Light Speed Future

API REFERENCE

LSF Seedance 2.5 Flash

On this page

LSF Seedance 2.5 Flash creates videos from prompts and supported image, video and audio references. Choose Fast or Standard through your assigned model alias. Submit one request to POST /v1/videos, track it with GET /v1/videos/{task_id} and download the finished MP4 from metadata.url. Standard includes 6K H.264 8-bit output; Fast supports outputs through 4K.

Flash delivers the finished video through one task. For applications that need a preview-and-approve step before requesting a final video, use Native Seedance 2.5 Draft Mode in section 5.8.

7.1 Product selection and outputs

Tier Named output resolutions Additional controls
Fast 240p / 360p / 480p / 540p / 720p / 1080p / 2k / 4k FPS and bitrate controls
Standard The Fast resolutions plus 6k and 8k FPS and bitrate; scene and enhance_style

Use <YOUR_FLASH_FAST_MODEL_ALIAS> or <YOUR_FLASH_STANDARD_MODEL_ALIAS> exactly as supplied by LSF. Availability depends on your account and enabled output combinations. Select Fast or Standard through model; do not send engine or tool_version. LSF Seedance 2.5 Flash has no Professional tier. Named resolutions indicate output bands, not one fixed width and height for every aspect ratio.

Standard 6K delivers H.264 8-bit 4:2:0 MP4. Its short side is 3456 pixels; the proportional longer side is rounded upward to an even pixel. Exact 16:9 produces 6144 × 3456. A different actual source ratio produces different dimensions, without cropping or stretching to a fixed canvas. Fast does not support 6K or 8K. Flash does not expose a Professional encoding menu.

7.2 Request fields

Generation parameters

Only model, prompt and metadata are allowed at the top level. metadata must be an object. Fields in the table below are inside metadata unless marked top level. Send the documented JSON types; numeric strings and null are not substitutes.

Field Type and requirement Usage
model String; required; top level Assigned Fast or Standard alias.
prompt String; conditional; top level Required and nonempty for text-only generation. May be omitted with supported media input.
client_request_id String; required 1–128 characters: A–Z, a–z, 0–9 and . _ : - . See section 4.1.
duration Integer; optional Omit, -1, or 4–30. Omission/-1 is automatic and reserves for 30 output seconds. edit requires omission/-1.
ratio String; optional adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 or 21:9 for text/reference inputs. Frame, edit and extend modes require adaptive.
omni_reference_task_type String; optional auto, reference, edit or extend. reference needs a reference input; edit/extend need reference_video.
content Array; optional Ordered media items as in section 5.6. Omit for text-only input. Text belongs in prompt, not a content text item.
generate_audio Boolean; optional Set explicitly when required. Omission leaves the setting unspecified.
watermark Boolean; optional Set explicitly when required. Omission leaves the setting unspecified.

Frame control accepts one first_frame alone or one first_frame with one last_frame, using image_url items. A last_frame alone, duplicate frame roles or mixing frame-control items with reference images/video/audio is rejected. Reference inputs allow up to 30 images, 10 videos and 10 audio items, with 50 items total. Preserve their order for @ImageN, @VideoN and @AudioN. Audio-only input is unsupported.

Use HTTPS URLs or authorized asset:// references. URLs must be nonempty, without surrounding whitespace or embedded user credentials. LSF Seedance 2.5 Flash reference inputs do not accept plain HTTP, Base64, data URLs or inline file uploads. Input format and media limits confirmed for your account still apply.

Final output parameters

Field Type Usage
resolution String; optional Values in section 7.1. Omission alone defaults to 1080p; empty string and null are invalid.
fps Number; optional Finite 15–120, including fractions. Sets output FPS. Omit to preserve the original frame rate.
output_format String; optional mp4 only; omission also delivers MP4.
return_last_frame Boolean; optional Default false. Unsupported for MOV, 6K and 8K; omit or set false. Other supported MP4 profiles require enabled extraction for true.
bitrate_level String; optional low, medium or high; available to both tiers.
bitrate Integer; optional 10–150000 kbps; available to both tiers. Use either bitrate or bitrate_level.
scene String; Standard only common, ugc, short_series, aigc or old_film. Standard omission uses common. Fast rejects this field.
enhance_style String; Standard only hd or natural. Omit to leave the style unspecified. Fast rejects this field.

LSF Seedance 2.5 Flash does not expose codec, bit_depth, bitrate_mode, seed, camera_fixed, resolution_limit, draft, draft_task, tool_version, engine, source_fps or video_url controls. It does not accept callback, priority, queue or service-tier settings. Unknown fields are rejected. The standalone LSF Video Enhancement request is a different schema.

7.3 Request examples

A. Fast · 1080p

POST /v1/videos
{
  "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
  }
}

Generate and persist client_request_id before submission. The example requests 5 seconds and explicitly disables generated audio. Omission of duration or -1 selects automatic duration and reserves against 30 output seconds. Omission of generate_audio or watermark does not mean false. Omit fps to preserve the source frame rate.

B. Standard · video reference

This example uses an existing video as a reference for a new generated scene. Replace its placeholder URL with a stable HTTPS video source accessible to LSF. Use an already authorized Active video asset with asset:// only when that asset workflow is enabled.

POST /v1/videos
{
  "model": "<YOUR_FLASH_STANDARD_MODEL_ALIAS>",
  "prompt": "Use @Video1 as a motion reference for a new product scene.",
  "metadata": {
    "client_request_id": "flash-reference-001",
    "duration": 5,
    "resolution": "1080p",
    "omni_reference_task_type": "reference",
    "ratio": "9:16",
    "generate_audio": false,
    "content": [
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/reference-video.mp4"
        }
      }
    ]
  }
}

fps is intentionally omitted, so processing preserves the source frame rate. LSF measures each reference video before acceptance; metadata.duration refers to requested output, not input duration. If a video’s duration cannot be established, the request is rejected instead of treating that video as zero seconds. Repeated references count repeatedly.

C. Standard · 6K MP4

{
  "model": "<YOUR_FLASH_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": "flash-standard-6k-001"
  }
}

Use the assigned Standard alias and resolution="6k". Omit codec and bit_depth. Keep return_last_frame omitted or false. FPS is explicitly 24 in this example; omission preserves the generated source frame rate.

7.4 Task lifecycle and result

Poll the original public task every 30 seconds or longer until completed or failed. The workflow advances automatically. Section 4.2 documents the response structure and field types; the final video is in metadata.url. Use an authorized key as described in section 2, and retain your own client_request_id to task-ID mapping.

For a supported MP4 profile, enabled and requested last-frame delivery returns metadata.last_frame_url. It is unsupported for MOV, 6K and 8K. Named resolutions follow the dimensions explained in section 7.1. Download the returned media promptly.

7.5 Reservation and final billing

Use the effective rate agreed for your account, tier, final resolution and input mode. Video-input rates are configured independently for this product. Account-specific terms may differ between products. No additional FPS multiplier applies.

Output Base USD per billable second
No video input
Base USD per billable second
With video input
Standard 6K H.264 MP4 0.49 0.39

These are reference base rates. Your effective account rate includes the applicable account pricing terms. Use the agreed rate for other resolutions, including Standard 8K. The video-input rate applies to the entire combined duration below.

Input mode Final charge
No video reference Agreed no-video rate × final output seconds rounded up to a whole second.
One or more video references Agreed video-input rate × (total measured original input-video seconds + final output seconds rounded up to a whole second).

Only video references activate video-input pricing. Images and audio do not add video-input seconds. Keep fractional input seconds; round only the output, not each input or the combined total. One Flash task has one customer charge. Input-video seconds include only the video references supplied in your request.

For a 5-second request without video input, the reservation uses 5 output seconds. If the delivered output is 5.025 seconds, final billing uses 6 output seconds. With a measured 5-second reference video, that same delivered result uses 5 + 6 = 11 chargeable seconds at the agreed video-input rate. Requested duration is not a guarantee of exact media duration.

If duration is omitted or -1, the initial reservation uses 30 output seconds, plus any measured video input. The accepted effective rate and input measurements remain fixed for the task; later configuration or price changes do not reprice it. LSF settles once and releases or collects the difference. Repeated GET does not add charges.

A confirmed task failure, including failure to deliver a requested last frame, releases the full reservation with no final customer charge. A network timeout or unknown submission outcome is not a confirmed failure. Keep the original task ID and contact LSF if its status remains unclear.

7.6 Errors and recovery

Use the shared submission errors in section 11.1 and the replay rules in section 4.1. Missing or invalid client_request_id is rejected before task acceptance. Reuse the original key, ID and saved request for an uncertain POST; once a task ID is known, use GET. Do not create a replacement task merely because polling is slow or interrupted.

Search documentation

Search pages and headings. Use Tab or arrow keys to move through results.

NEWSEEDANCE 2.5

Native Seedance 2.5 4K

Invite-only access on BytePlus
Available to you through LSF

Explore Native 4K