Light Speed Future

API REFERENCE

Native Seedance API

On this page

Native Seedance video generation supports text, image, video and audio references, with creative controls for duration, aspect ratio and frame composition. The API follows an OpenAI-compatible style; place Seedance-specific controls under metadata as documented below.

This chapter covers the existing Native models. The separate Native Seedance 2.5 Flash model is specified in section 5A; do not apply this chapter's flagship 4K, Draft-to-Final, reference limits or bitrate controls to Native Flash.

5.1 Supported Task Endpoints

  • Submit a task: POST /v1/videos

  • Retrieve a task: GET /v1/videos/{task_id}

  • Typical status values: queued / in_progress / completed / failed / expired

Current task-management scope

Current scope: do not assume support for DELETE /v1/videos/{task_id}, GET /v1/videos, or POST /v1/videos/{task_id}/cancel unless those endpoints are separately enabled and confirmed by Light Speed Future.

5.2 Model Families and Output Scope

Model family Use case Supported output Unsupported by default
Standard Seedance 2.0 alias Standard video generation and enabled higher-resolution output 480p / 720p / 1080p, and 4k when available for your account
Fast Seedance 2.0 alias Fast video generation at supported resolutions Lower supported resolutions such as 480p / 720p 1080p and 4k
Mini Seedance 2.0 alias Mini video generation at supported resolutions 480p / 720p, duration 4-15 seconds 1080p and 4k
Seedance 2.5 alias Multimodal generation, video editing, video extension, and optional Draft Mode 480p / 720p / 1080p / 4k; text, frame, image, video, audio, and mixed reference modes; Draft Mode: 480p preview → 1080p or 4k Final 8k

Native bitrate control

For Native Seedance 2.0 Standard, Fast and Mini, and Native Seedance 2.5, set metadata.bitrate_mode to "standard" or "high". If omitted, the default bitrate setting applies. Seedance 2.5 accepts the field in normal, Draft and Final requests with MP4 or MOV output. An explicit Final value may differ from its Draft; omission does not imply inheritance. Native codec selection is not a request field. This Native setting is different from bitrate_level and bitrate in LSF Video Enhancement, LSF Seedance 2.5 Production and LSF Seedance 2.5 Flash.

5.3 Native Seedance 2.5 Request Structure

POST /v1/videos
{
  "model": "<YOUR_MODEL_ALIAS>",
  "prompt": "Describe the video you want",
  "metadata": {
    "duration": 4,
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": false,
    "client_request_id": "native-structure-001"
  }
}

5.4 Top-Level Fields

Field Required Description
model Yes The video model alias supplied by Light Speed Future. Use the exact alias provided for your account.
prompt Conditional Required for text-only requests. Optional when supported reference or frame inputs are supplied.
metadata Object Use an object for the documented controls. Seedance 2.5 requests do not support generic user or seed fields. Follow section 5.7.

5.5 metadata Fields

Field Type Description
draft boolean Seedance 2.5 Draft Mode only. true creates a 480p Draft preview. Omitted or false uses the normal native-generation flow. Draft Mode Final does not resend draft=true; it references the completed Draft through metadata.content. See section 5.8.
duration integer Optional for Seedance 2.5; omission uses the model default (-1). Accepted values are -1 or an integer from 4 to 30. Edit accepts omitted or -1; extend accepts omitted, -1, or 4-30.
resolution string Output resolution. Seedance 2.5 supports 480p, 720p, 1080p, and 4k. Its ordinary default remains 720p. Mini supports 480p/720p. Standard Seedance 2.0 can use 4k when enabled. Fast and Mini do not support 1080p or 4k.
ratio string Seedance 2.5 text/reference modes support adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, and 21:9. Edit, extend, first-frame, and first+last-frame modes support adaptive only. Omission uses adaptive.
generate_audio boolean Whether to generate audio. Seedance 2.5 accepts omitted, true, or false; send an explicit value when deterministic behavior is required.
watermark boolean Optional Seedance 2.5 watermark switch.
client_request_id string Optional request ID. Use 1–128 characters from A–Z, a–z, 0–9 and . _ : - . Follow section 4.1 and keep the same key and payload for replay.
content array Ordered multimodal input items. Each media item uses type for media format and role for purpose; see section 5.6. Limits: 30 reference_image, 10 reference_video, 10 reference_audio, and 50 total. Pure-audio and mixed references are supported. Draft Mode Final is the documented exception and uses one draft_task item as described in section 5.8.
output_format string Optional output container: "mp4" or "mov". Omitted requests use MP4.
return_last_frame boolean Requests the generated last frame. On success, metadata.last_frame_url is present only when returned.
omni_reference_task_type string Optional for Seedance 2.5 Omni reference-to-video. Allowed values: auto, reference, edit, or extend. Omission uses auto behavior. reference requires reference input; edit and extend require reference_video and the rules in section 5.7.
bitrate_mode string Native output bitrate profile: standard or high. Supported for Seedance 2.0 Standard / Fast / Mini and Seedance 2.5, including 2.5 Draft / Final with MP4 / MOV. Omission stays unspecified. Final may explicitly use a different value from its Draft.

Use metadata for Seedance-specific controls

Place duration, resolution, ratio and generate_audio under metadata, not at the top level.

5.6 metadata.content Item Structure and Roles

metadata.content is an ordered array. Each item requires type (media format) and role (purpose). Supported roles are reference_image, reference_video, reference_audio, first_frame, and last_frame. Use image_url for image/frame roles, video_url for reference_video, and audio_url for reference_audio. Item order is preserved for @Image1, @Video1, and @Audio1. Draft Mode Final is the only documented exception: metadata.content contains exactly one draft_task item without a media role; see section 5.8.

Reference image item

{ "type": "image_url", "role": "reference_image",
 "image_url": { "url": "https://example.com/image-1.jpg" } }

Reference video item

{ "type": "video_url", "role": "reference_video",
 "video_url": { "url": "https://example.com/video-1.mp4" } }

Reference audio item

{ "type": "audio_url", "role": "reference_audio",
 "audio_url": { "url": "https://example.com/audio-1.mp3" } }

Reference video items use type=video_url with role=reference_video. Keep reference media accessible throughout processing; commercial terms are outside this technical guide.

5.7 Seedance 2.5 API Request Specification

Seedance 2.5 is available only when Light Speed Future provides a model alias for your account. Use only the documented fields and combinations below.

Setting Supported in Seedance 2.5 Notes
Model Exact model alias provided by Light Speed Future Use only the model alias provided by LSF.
Resolution 480p, 720p, 1080p, or 4k Omitted resolution defaults to 720p. 4k uses the same Native Seedance 2.5 alias and existing product permissions.
Duration omitted, -1, or integer 4-30 Omission uses -1. Edit accepts omitted or -1; extend accepts omitted, -1, or 4-30. Do not send strings, decimals, or null.
Input mode Text; frame control; reference images, videos, or audio; pure audio; or mixed references Prompt is required for text-only requests and optional when supported reference or frame content is supplied. Maximum 30 images, 10 videos, 10 audio items, and 50 total; original item order is preserved.
Ratio adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, or 21:9 Text-to-video and reference-to-video support all listed values. Editing, extension, and first/last-frame modes support adaptive only. Omission uses adaptive.
Generated audio generate_audio omitted, true, or false Set an explicit value when deterministic behavior is required.
Not supported Video callbacks; task cancel, delete, or list; native codec selection; inline file upload, Base64, or data: URLs Reference media is sent for Native Seedance processing. LSF Seedance 2.5 Production also measures reference-video duration for billing; see section 6.5.
Output controls output_format="mp4" or "mov"; return_last_frame boolean; watermark boolean Omitted output_format uses MP4. metadata.last_frame_url appears only when the service returns a last frame.
Omni task type omitted (auto behavior), auto, reference, edit, or extend reference requires reference input. edit requires reference_video, ratio omitted or adaptive, and duration omitted or -1. extend requires reference_video and adaptive ratio; duration may be omitted, -1, or 4–30. Supported input-media limits also apply; confirm reference-video requirements with LSF.
Draft Mode 480p Draft preview → 1080p or 4k Final Set metadata.draft=true for the Draft stage. Finalize a completed Draft before 7 days have elapsed from its creation, using one draft_task content item with its LSF public task ID. Final inherits the creative inputs; bitrate_mode is a stage-specific output control and may be set independently as described in section 5.8.
Bitrate mode standard or high Optional in normal, Draft and Final requests with MP4 or MOV output. LSF forwards explicit values and leaves omission unspecified. Final may explicitly differ from Draft.

Seedance 2.5 request specification | Use documented fields only. For Omni editing and extension, keep the explicit task type, prompt intent, reference assets, ratio, and duration mutually consistent.

Seedance 2.5 Explicit Omni Edit Example

POST /v1/videos
{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "prompt": "Edit @Video1 using the visual details from @Image1 and the sound style from @Audio1.",
  "metadata": {
    "client_request_id": "video-job-20260824-edit-0001",
    "omni_reference_task_type": "edit",
    "duration": -1,
    "resolution": "1080p",
    "ratio": "adaptive",
    "output_format": "mp4",
    "return_last_frame": true,
    "watermark": false,
    "generate_audio": false,
    "content": [
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/video-1.mp4"
        }
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://example.com/image-1.jpg"
        }
      },
      {
        "type": "audio_url",
        "role": "reference_audio",
        "audio_url": {
          "url": "https://example.com/audio-1.mp3"
        }
      }
    ]
  }
}

Use metadata.omni_reference_task_type only for Seedance 2.5 Omni reference-to-video requests. Omitting it uses auto behavior and lets the model infer the subtask. Explicit reference, edit, or extend validates known task constraints earlier, but the prompt and inputs must still match; otherwise the task can fail asynchronously with InvalidParameter.TaskTypeMismatch. Do not send a generic task_type field.

Seedance 2.5 Explicit Omni Extend Example

POST /v1/videos
{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "prompt": "Continue @Video1 forward, preserving the scene and motion.",
  "metadata": {
    "client_request_id": "video-job-20260824-extend-0001",
    "omni_reference_task_type": "extend",
    "duration": 5,
    "resolution": "480p",
    "ratio": "adaptive",
    "generate_audio": false,
    "content": [
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/video-1.mp4"
        }
      }
    ]
  }
}

For edit, omit duration or set it to -1. For extend, omit duration or use -1 or an integer from 4 to 30. Both modes require at least one reference_video; omit ratio or set it to adaptive.

Native 4K access output and pricing

LSF provides Native Seedance 2.5 4K through its BytePlus whitelist access. Use your existing Native Seedance 2.5 model alias and set metadata.resolution="4k". The same account and product permissions apply; no separate 4K model alias, endpoint or customer application is required.

Existing duration, aspect-ratio and audio options continue to apply. At 16:9, Native 4K output is 3840 × 2160; dimensions vary with the selected ratio. MP4 uses HEVC Main 10 with 10-bit 4:2:0 (yuv420p10le). The documented MOV format uses HEVC Rext with 10-bit 4:4:4 (yuv444p10le). Use compatible players and editors. Native does not expose a codec selector, and 10-bit output alone does not establish HDR delivery.

Native Seedance 2.5 4K input class Standard USD per million completion tokens
No video input 5.64
With original video input 3.48

Published Native 4K standard rates are in USD per million completion tokens. Text, images and audio-only references use the no-video-input rate. Requests containing original video input use the video-input rate. Account-specific commercial terms apply where agreed. The initial reservation is an estimate; final billing uses actual completion tokens and the pricing accepted for the task. Confirm your assigned 4K capacity rather than assuming the same limits as lower-resolution generation.

5.8 Seedance 2.5 Draft Mode

Draft Mode is an optional two-stage Native Seedance 2.5 workflow for reviewing a low-resolution preview before requesting the final 1080p or 4k result. It uses the same Seedance 2.5 model alias provided by LSF and the same POST /v1/videos and GET /v1/videos/{task_id} endpoints. It is separate from LSF Seedance 2.5 Production and LSF Seedance 2.5 Flash.

Stage 1 · Create the 480p Draft

Create the Draft with metadata.draft=true. Draft creation follows the ordinary Seedance 2.5 input and mode rules in sections 5.6–5.7, but the Draft output is 480p only. Omit resolution to use the Draft default or set metadata.resolution="480p" explicitly. Any other Draft resolution is rejected before task creation.

POST /v1/videos
{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "prompt": "A ceramic cup on a desk in soft daylight.",
  "metadata": {
    "draft": true,
    "duration": 5,
    "resolution": "480p",
    "bitrate_mode": "high",
    "generate_audio": false,
    "client_request_id": "seedance-draft-001"
  }
}

Save the returned LSF public task ID and poll that task to completed. A Draft must complete successfully before it can be used for Final. Final may use a valid replacement key issued for the same LSF organization and account, with the required product access permissions. A shared organization name alone does not establish access; contact LSF if the replacement key cannot use an eligible Draft.

Stage 2 · Create the Final

Create Final as a new POST with a new client_request_id. Use the same Seedance 2.5 model alias provided by LSF. metadata.content must contain exactly one draft_task item whose id is the completed Draft's LSF public task ID. Final output defaults to 1080p. Omit resolution, set metadata.resolution="1080p", or set metadata.resolution="4k".

POST /v1/videos
{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "metadata": {
    "resolution": "1080p",
    "bitrate_mode": "standard",
    "content": [
      {
        "type": "draft_task",
        "draft_task": {
          "id": "<YOUR_COMPLETED_DRAFT_TASK_ID>"
        }
      }
    ],
    "output_format": "mp4",
    "return_last_frame": false,
    "watermark": false,
    "client_request_id": "seedance-final-001"
  }
}

For a 4K Final, use the same Final request structure and set metadata.resolution="4k". The Final default remains 1080p; the Draft preview remains 480p.

Final inherits the Draft's creative inputs automatically. Do not resend or change:

  • prompt or text content;

  • reference images, videos or audio;

  • duration;

  • ratio;

  • generate_audio;

  • omni_reference_task_type;

  • seed.

For Final, the supported stage-specific controls are metadata.resolution (1080p or 4k), bitrate_mode, output_format, return_last_frame, watermark and client_request_id. Do not combine draft_task with other content items.

bitrate_mode can be specified independently on Final and may differ from the Draft value, as shown above. If Final omits bitrate_mode, LSF also leaves the field unspecified; do not assume LSF copies the Draft value.

Draft validity, retry and billing

  • Create Final before 7 days have elapsed from the completed Draft’s original creation time.

  • Draft and Final are separate tasks. Keep both public task IDs and both client_request_id values in your application records.

  • If a Draft or Final POST outcome is uncertain, preserve that stage's original client_request_id and payload. Do not create a replacement job merely because the response was lost.

  • Draft is billed independently under the applicable Native Seedance 2.5 480p pricing for the original Draft request inputs.

  • Final is a new, independently billed task under the applicable Native Seedance 2.5 pricing for its selected resolution (1080p or 4k). It is charged to the key used to submit Final at the terms accepted for that new task; the original Draft charge is unchanged. The Final pricing class depends on whether the original Draft request included video input; the Draft preview itself does not make Final a video-input request.

  • If the original Draft request included video input, the original input-video duration from that Draft request is used where applicable; the generated Draft preview is not counted as input-video duration. Each stage has its own initial charge estimate and final charge. Use your LSF quotation and GET /v1/billing/balance; Draft Mode is not a single combined charge.

5.9 Common Video Generation Examples

Example A: Minimal text-to-video

POST /v1/videos
{
  "model": "<YOUR_MODEL_ALIAS>",
  "prompt": "A person speaking naturally to camera in a clean indoor setting.",
  "metadata": {
    "duration": 4,
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": false
  }
}

Example B: Seedance Mini high-bitrate text-to-video

POST /v1/videos
{
  "model": "<YOUR_MINI_VIDEO_MODEL_ALIAS>",
  "prompt": "A premium skincare bottle in soft studio light with a slow camera move.",
  "metadata": {
    "duration": 4,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "high",
    "generate_audio": false
  }
}

Example C: Single-image reference

POST /v1/videos
{
  "model": "<YOUR_MODEL_ALIAS>",
  "prompt": "Create a product video using Image 1 as the visual reference. Keep the product shape and label consistent.",
  "metadata": {
    "duration": 4,
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": false,
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/product-reference.jpg"
        },
        "role": "reference_image"
      }
    ]
  }
}

Example D: Reference video input

POST /v1/videos
{
  "model": "<YOUR_MODEL_ALIAS>",
  "prompt": "Use the camera rhythm and motion style from Video 1, while creating a new product-focused short video.",
  "metadata": {
    "duration": 4,
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": false,
    "content": [
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/reference-camera-motion.mp4"
        },
        "role": "reference_video"
      }
    ]
  }
}

Example E: Seedance 2.0 Standard 4K output when enabled

POST /v1/videos
{
  "model": "<YOUR_STANDARD_VIDEO_MODEL_ALIAS>",
  "prompt": "Generate a premium product commercial with slow cinematic camera movement and high-detail lighting.",
  "metadata": {
    "duration": 5,
    "resolution": "4k",
    "ratio": "16:9",
    "generate_audio": false
  }
}

Example F: Native Seedance 2.5 4K

Use the same Native Seedance 2.5 alias and account permissions as your other Native 2.5 requests. Four seconds and silent output are example choices, not product-wide restrictions.

POST /v1/videos
{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "prompt": "A red ceramic cup on a wooden table in soft daylight, with a slow camera move.",
  "metadata": {
    "duration": 4,
    "resolution": "4k",
    "ratio": "16:9",
    "output_format": "mp4",
    "generate_audio": false,
    "client_request_id": "native-4k-001"
  }
}

5.10 Unsupported Resolution Behavior

POST /v1/videos
{
  "model": "<YOUR_MINI_VIDEO_MODEL_ALIAS>",
  "prompt": "A short product clip.",
  "metadata": {
    "duration": 4,
    "resolution": "1080p",
    "ratio": "adaptive",
    "generate_audio": false
  }
}

Expected result: the request is rejected with an invalid_request_error. No video task is created. Fast and Mini also reject 1080p and 4k. Native Seedance 2.5 supports 4k using the existing Native 2.5 model alias and product permissions.

5.11 Retrieve Task Status

GET /v1/videos/{task_id}
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "<YOUR_MODEL_ALIAS>",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4",
    "last_frame_url": "https://example.com/generated-last-frame.jpg"
  },
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  }
}

Poll the same GET /v1/videos/{task_id} every 30 seconds or longer. If a connection is interrupted, resume polling the same task ID; do not submit another POST only because polling was interrupted. Stop when status is completed, failed, or expired. Video callbacks are not supported.

Seedance 2.5 Error Details

When a task reaches failed or expired, check the error object returned by GET /v1/videos/{task_id}:

{
  "status": "failed",
  "error": {
    "code": "InvalidParameter.TaskTypeMismatch",
    "message": "The task type identified by the model does not match the specified value."
  }
}

Use error.code for application logic and error.message for diagnostics. If a specific error code is unavailable, the API returns video_generation_failed.

5.12 Idempotency

Use metadata.client_request_id and retain the public task ID. Follow section 4.1 for the current ID format, API-key scope, identical replay and unknown submission outcomes. Native billing continues to use actual returned usage and the applicable account terms; the finished-video pricing formulas for LSF Seedance 2.5 Production and LSF Seedance 2.5 Flash do not apply to Native generation.

5A. Native Seedance 2.5 Flash

Use Native Seedance 2.5 Flash for native 480p or 720p output. Your account needs its own enabled Native Flash alias. This chapter covers its request fields, result links and completion-token billing.

Choose the correct product

Native Seedance 2.5 Flash is a separate native model billed by completion tokens. Use the exact enabled Native Flash alias issued by LSF; existing Native 2.5 and LSF Flash aliases select different products.

Product Output and workflow Billing unit
Native Seedance 2.5 Flash Native 480p or 720p; one ordinary generation task; MP4 or MOV Actual completion tokens under agreed account terms
Native Seedance 2.5 — section 5 Existing native output through 4K, including the separate Draft-to-Final workflow Actual completion tokens under its own account terms
LSF Seedance 2.5 Flash — section 7 Existing Fast/Standard generation-and-enhancement workflow; finished MP4 Billable seconds under the section 7 rules

Existing products keep their options and prices. Native Flash does not use enhancement to produce higher resolutions.

Text-to-video example

Submit the following JSON body to POST /v1/videos with your LSF Bearer API key. Replace the model placeholder with the exact enabled Native Flash alias; never place your API key in a browser application.

{
  "model": "<YOUR_NATIVE_FLASH_MODEL_ALIAS>",
  "prompt": "A slow cinematic view of a quiet mountain lake at dawn",
  "metadata": {
    "resolution": "720p",
    "duration": 4,
    "ratio": "16:9",
    "output_format": "mp4",
    "generate_audio": false,
    "client_request_id": "my-native-flash-request-001"
  }
}

For a separately intended MOV task, set output_format to mov and use a new request ID. Changing an accepted request while keeping its ID is not a format-conversion operation. Do not submit another task merely to recover a missing response or interrupted download.

Retrieve, download and recover

Illustrative completed response fields — retain the task ID and open the returned metadata.url:

{
  "task_id": "task_example",
  "status": "completed",
  "metadata": {"url": "https://example.com/video.mp4"}
}

Retain the returned public task ID, original key identity, request ID and unchanged request. Poll the same task every 30 seconds or longer. A completed task exposes its media URL through metadata.url; save retained outputs promptly because result access is temporary. completed, failed and expired are terminal Native task states. Use sanitized error details to diagnose a failure; a delayed or uncertain response does not prove failure.

Native Flash also supports authenticated original-file download through GET /v1/videos/{task_id}/content. Download it from your backend with an authorized LSF key. Do not forward that key to an external media URL. This path retrieves the existing result; it does not create a new video. Check the actual downloaded media when exact dimensions, format or playback compatibility matter.

For an accepted Native Flash task, exhaustion of an otherwise valid key's allowance does not by itself prevent query or download. Revocation and current access checks still apply: disabled, expired, deleted or unauthorized keys cannot read the task. A valid replacement key must belong to the same LSF organization and account and retain the required model and IP permissions. Use GET with the original task ID; changing keys does not transfer the original charge or make a repeated POST safe.

An accepted identical request may be replayed with the same key and client_request_id to recover the existing task. Different parameters under that ID are a conflict. Without an ID, separate submissions do not provide cross-request deduplication. If acceptance is uncertain, preserve the original identity and request, retrieve the original task when known, and contact support if needed. Do not change keys or create a fresh ID as a blind retry. New tasks still require sufficient allowance and current product availability.

Request and output scope

Submit model, prompt and metadata to POST /v1/videos; retrieve the returned task ID with GET /v1/videos/{task_id}. Use the fields for this product; options from other Seedance workflows are not interchangeable.

Field or capability Native Flash scope
Model alias The separately assigned alias, using the lsf-seedance-2.5-native-flash-<tenant> naming pattern; illustrated as <YOUR_NATIVE_FLASH_MODEL_ALIAS>
metadata.resolution 480p or 720p; omission defaults to 720p
metadata.duration Integer 4–30; omit it or use -1 for automatic duration
Output profile Native 24 fps, 8-bit; no customer codec, bit-depth or FPS selector
metadata.output_format mp4 or mov; MP4 is the default
Text input A non-empty prompt is required for text-only generation
Frame input First frame, or first and last frame, using the existing image-item structure; ratio must be adaptive or omitted
Reference input Image and audio references, including audio-only reference requests; up to 10 reference images and 5 reference audio items
metadata.ratio for text/reference input adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 or 21:9; omission uses adaptive behaviour
Optional booleans generate_audio, return_last_frame and watermark; explicit false stays false, while omission leaves the default unspecified
metadata.omni_reference_task_type Omit or use auto; use reference only with reference input
metadata.client_request_id Recommended for identical-request replay with the same key; see section 5A.4

At 16:9, text-to-video dimensions are 854 × 480 (480p) or 1280 × 720 (720p). Inspect the returned file when exact specifications matter; requested duration does not promise an exact frame count.

For image/audio items and role ordering, follow section 5.6 with the limits above. Frame and reference modes cannot be mixed. Authorized media URLs and asset:// references retain their access and media constraints; request validation does not measure every remote file's duration or guarantee upstream acceptance.

Video-reference requests are unavailable in this release. This includes editing and extension. Do not send reference_video, edit or extend to Native Flash while this restriction remains in place.

Native Flash has no Draft or Draft-to-Final mode. Omit draft; a correctly typed draft: false is treated as omission. draft: true, null, non-boolean values and any draft_task reference are rejected. Native Flash also rejects 1080p/2K/4K/6K/8K output and bitrate_mode. The existing flagship Native model's Draft, 4K and bitrate options do not transfer to this alias.

Billing and availability

An initial reservation is an estimate. Final billing uses valid completion-token usage and the account terms accepted for the original task. Repeated status queries and original-file downloads do not create another generation charge. Image or audio reference input is not video input.

The standard price is USD8.40 per million completion tokens for 480p or 720p requests without video input. Text, image and audio-reference requests use this no-video rate. Your agreed account pricing applies. The token unit price is the same at both resolutions; actual token usage can differ. Video-input pricing is not offered in this release.

Native Flash is available through the LSF API for enabled accounts. It is not available in Light Speed Future for ChatGPT. Completion time depends on the request and service load.

Native Flash request downloads

MP4 request JSON · MOV request JSON

Native 4K request examples and downloads

Use the existing Native Seedance 2.5 model alias for your account. Both examples use POST /v1/videos; check a known task with GET /v1/videos/{task_id}. Replace the placeholders before use.

Ordinary Native 4K request

{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "prompt": "A red ceramic cup on a wooden table in soft daylight, with a slow camera move.",
  "metadata": {
    "duration": 4,
    "resolution": "4k",
    "ratio": "16:9",
    "output_format": "mp4",
    "generate_audio": false,
    "client_request_id": "native-4k-001"
  }
}

Download Native 4K request JSON. Four seconds and disabled audio are sample choices, not product-wide limits.

4K Final from a completed 480p Draft

{
  "model": "<YOUR_SEEDANCE_2_5_MODEL_ALIAS>",
  "metadata": {
    "resolution": "4k",
    "content": [
      {
        "type": "draft_task",
        "draft_task": {
          "id": "<YOUR_COMPLETED_DRAFT_TASK_ID>"
        }
      }
    ],
    "output_format": "mp4",
    "client_request_id": "native-4k-final-001"
  }
}

Download 4K Final request JSON

Complete a 480p Draft under section 5.8 first. Use the same account and Native Seedance 2.5 alias, a new client_request_id and the completed Draft’s public task ID. Submit Final within seven days of the Draft’s original creation.

metadata.content must contain exactly one draft_task. Final inherits creative inputs: do not resend the prompt, reference media, duration, ratio, generate_audio or seed. Final defaults to 1080p; set metadata.resolution="4k" explicitly for 4K.

Draft and Final are billed separately. Final’s input-pricing class follows the original Draft request; the generated preview is not itself original video input. If submission is uncertain, preserve that stage’s original request ID and payload and recover the original task rather than creating a replacement.

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