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
| Property | Value |
|---|---|
| Model ID | seedance-2.5-flash |
| Endpoint | POST /api/v1/generation/create |
| Output | Video |
| Modes | text-to-video, image-to-video, video reference, audio reference |
| Pricing | View 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.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Video prompt. Reference media as [Image1], [Video1] or [Audio1], in array order. |
duration | number | No | 5 | Output 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. |
generateAudio | boolean | No | true | Whether the generated video includes audio |
seed | number | No | — | 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. |
tools | object[] | 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 |
imageUrls | string[] | 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. |
imageWithRoles | object[] | 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 }. |
videoUrls | string[] | No | — | Public reference-video URLs (maximum 5; 2-30 seconds each and 30 seconds total). Their duration is probed before charging. |
audioUrls | string[] | 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.