Skip to Content
DocumentationModelsVideoSeedance 2.5 Flash Spicy

Seedance 2.5 Flash Spicy

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

Model facts

PropertyValue
Model IDseedance-2.5-flash-spicy
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-spicy", "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 (up to 30000 characters). Describe references in array order. max 30000 chars
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
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). In auto mode, one or two images without other media are first/last frames and require adaptive size. Use reference mode for subject or style references. Images outside a width-to-height ratio of 0.4–2.5 may be padded without cropping.
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; 2–30 seconds each, 30 seconds total). Requires an image or video reference.
omniReferenceTaskType "auto" | "reference" | "edit" | "extend" No "auto" auto selects text, first/last frames or references from the supplied media. reference uses media as subject/style references. extend requires videoUrls and adaptive size. edit requires exactly one 4–30 second source video, keeps its timeline and ignores duration and size; its length is probed before charging.

Modes

Minimal generation

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

First and last frames

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

Subject reference

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

Edit a source video

{ "model": "seedance-2.5-flash-spicy", "input": { "prompt": "Make the petals look like glass", "videoUrls": [ "https://example.com/source.mp4" ], "omniReferenceTaskType": "edit" } }

Extend a source video

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

With image urls

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

With video urls

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

With audio urls

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

Constraints

  • prompt: maximum 30000 characters.
  • duration: minimum 4; maximum 30.
  • size: allowed: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.
  • resolution: allowed: 480p, 720p.
  • omniReferenceTaskType: allowed: auto, reference, edit, extend.
  • In auto mode, one or two images without video/audio are first/last frames and require adaptive size. Use reference mode for subject/style references. Audio requires an image or video.
  • Generate and extend 4–30 seconds at 480p/720p. Up to 10 images, 5 videos and 5 audio clips; reference videos must be 2–30 seconds each, at most 30 seconds combined. Audio references must be 2–30 seconds each, at most 30 seconds combined.
  • edit requires exactly one 4–30 second source video and preserves its timeline. duration and size are ignored. The source is probed before charging and rounded up to whole seconds; both input and output seconds use the reference-input tariff.
  • extend requires videoUrls and adaptive size. Reference input and generated output seconds use the reference-input tariff. Default generation duration is 5 seconds and default resolution is 480p.
  • This is the APIPod Flash Spicy channel, with no lite substitution. Automatic duration (-1), seed, outputFormat and imageWithRoles are unavailable. Provider expenses are reconciled from task receipts; account discounts are managed separately.

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.