Skip to Content
DocumentationModelsVideoSeedance 2.5 Flash

Seedance 2.5 Flash

Use seedance-2.5-flash to create video output. This page contains the complete request needed for this model.

Model facts

PropertyValue
Model IDseedance-2.5-flash
EndpointPOST /api/v1/generation/create
OutputVideo
Modestext-to-video, image-to-video, video reference, audio reference
PricingView current pricing 

Minimal request

curl -X POST https://api.api-stock.com/api/v1/generation/create \ -H "Authorization: Bearer $API_STOCK_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance-2.5-flash", "input": { "prompt": "A cinematic scene with soft natural light" } }'

The create response contains a task ID:

{ "code": 200, "data": { "taskId": "019ca881-9503-7270-a560-f00fc2b15785", "status": "not_started", "createdAt": "2026-08-22T12:00:00.000Z" } }

Parameters

Parameters belong inside the top-level input object. Unknown fields are rejected.

ParameterTypeRequiredDefaultDescription
promptstringYes—Video prompt. Reference media as [Image1], [Video1] or [Audio1], in array order.
durationnumberNo5Output duration in seconds (4-30). For reference-video jobs, input and output seconds use the reference-input tariff. min 4, max 30
size“adaptive” | “16:9” | “4:3” | “1:1” | “3:4” | “9:16” | “21:9”No"adaptive"Output aspect ratio. First/last-frame and extend jobs require adaptive.
generateAudiobooleanNotrueWhether the generated video includes audio
seednumberNo—Random seed; identical output is not guaranteed
outputFormat“mp4” | “mov”No"mp4"Output video container
omniReferenceTaskType“auto” | “reference” | “extend”No"auto"Optional task-type hint. edit is unavailable until variable-duration billing settlement is supported.
toolsobject[]No—Optional enhancements such as web search grounding. Each item is { type: “web_search” }.
resolution“480p” | “720p”No"480p"Output resolution and per-second billing tier
imageUrlsstring[]No—Reference image URLs (maximum 10). Cannot be combined with imageWithRoles. Very narrow or wide images may be padded to a width-to-height ratio of 0.4–2.5 without cropping. In first-frame mode, padding becomes part of the frame.
imageWithRolesobject[]No—Images with explicit first_frame, last_frame or reference_image roles (maximum 10). Cannot be combined with imageUrls. A last_frame requires a first_frame. Each item is { url: string, role: string }.
videoUrlsstring[]No—Public reference-video URLs (maximum 5; 2-30 seconds each and 30 seconds total). Their duration is probed before charging.
audioUrlsstring[]No—Reference audio URLs (maximum 5; 30 seconds total)

Modes

Minimal generation

{ "model": "seedance-2.5-flash", "input": { "prompt": "A cinematic scene with soft natural light" } }

With image urls

{ "model": "seedance-2.5-flash", "input": { "prompt": "A cinematic scene with soft natural light", "imageUrls": [ "https://example.com/input.jpg" ] } }

With video urls

{ "model": "seedance-2.5-flash", "input": { "prompt": "A cinematic scene with soft natural light", "videoUrls": [ "https://example.com/input.mp4" ] } }

With audio urls

{ "model": "seedance-2.5-flash", "input": { "prompt": "A cinematic scene with soft natural light", "audioUrls": [ "https://example.com/input.mp3" ] } }

Constraints

  • duration: minimum 4; maximum 30.
  • size: allowed: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.
  • outputFormat: allowed: mp4, mov.
  • omniReferenceTaskType: allowed: auto, reference, extend.
  • resolution: allowed: 480p, 720p.

Invalid types, unsupported enum values, out-of-range numbers, and missing required fields return HTTP 400 with error.code: "invalid_input". Correct the request rather than retrying it unchanged.

Result

Poll the task or provide a top-level webhook URL in the create request:

curl https://api.api-stock.com/api/v1/task/status/$TASK_ID \ -H "Authorization: Bearer $API_STOCK_KEY"

A successful media task returns one or more files:

{ "code": 200, "data": { "taskId": "019ca881-9503-7270-a560-f00fc2b15785", "status": "finished", "files": [ { "fileUrl": "https://s3.api-stock.com/result.mp4", "fileType": "video" } ], "createdTime": "2026-08-22T12:00:00.000Z" } }

See Tasks and webhooks for terminal statuses, retries and webhook delivery.