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
| Property | Value |
|---|---|
| Model ID | seedance-2.5-flash-spicy |
| 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-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.