curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-flash",
"input": {
"prompt": "One continuous 30-second story of the same young woman in a yellow raincoat delivering a handwritten letter across a small seaside town at dawn. 0-6s: wide aerial shot of the sleepy harbor town, fishing boats rocking, soft morning light; she rides an old bicycle down a cobblestone hill. 6-12s: tracking shot beside her as she weaves past a fish market, seagulls lifting off, a vendor waves at her. 12-18s: low-angle shot as she climbs a steep stone staircase carrying the bicycle, breathing hard, the letter tucked in her pocket. 18-24s: she knocks on a blue door at the top; an elderly man opens it and she hands him the letter. 24-30s: close-up of the man reading, his eyes filling with tears; he smiles and says softly, \"She remembered.\" Camera slowly pulls back to reveal the sunrise over the sea. Natural ambient sound: waves, gulls, bicycle bell, footsteps, gentle piano music. No subtitles, no on-screen text.",
"duration": 30,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
},
"message": "success"
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Seedance
Seedance 2.5 Flash
The Seedance 2.5 Flash API generates a 4–30 second video with synchronized audio from text, first and last frames, or image, video, and audio references at 480p or 720p.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-flash",
"input": {
"prompt": "One continuous 30-second story of the same young woman in a yellow raincoat delivering a handwritten letter across a small seaside town at dawn. 0-6s: wide aerial shot of the sleepy harbor town, fishing boats rocking, soft morning light; she rides an old bicycle down a cobblestone hill. 6-12s: tracking shot beside her as she weaves past a fish market, seagulls lifting off, a vendor waves at her. 12-18s: low-angle shot as she climbs a steep stone staircase carrying the bicycle, breathing hard, the letter tucked in her pocket. 18-24s: she knocks on a blue door at the top; an elderly man opens it and she hands him the letter. 24-30s: close-up of the man reading, his eyes filling with tears; he smiles and says softly, \"She remembered.\" Camera slowly pulls back to reveal the sunrise over the sea. Natural ambient sound: waves, gulls, bicycle bell, footsteps, gentle piano music. No subtitles, no on-screen text.",
"duration": 30,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
},
"message": "success"
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the response result through the unified Query Task Status endpoint.
480p and 720p output. It creates 4–30 second videos with synchronized audio from a text prompt, animates a first frame with an optional last frame, or follows image, video, and audio references. The supplied media selects the mode automatically.
Models
- seedance-2.5-flash — Text-to-video, first/last-frame image-to-video, and multimodal reference-to-video at
480por720p
Features
- 4–30 second videos: Set
durationto any whole number of seconds from 4 to 30. - Synchronized audio: Audio is generated in the same pass as the video. Set
generate_audiotofalsefor video only. - First and last frames: Start from one image, or supply a first and a last frame to define how the shot ends.
- Multimodal references: Guide the video with up to 10 reference images, 5 reference videos, and 5 reference audio clips.
- Aspect ratios:
auto,21:9,16:9,4:3,1:1,3:4, or9:16.
Input modes
| Mode | Selected when |
|---|---|
| Reference-to-video | reference_image_urls, reference_video_urls, or reference_audio_urls is non-empty |
| Image-to-video | image_urls is non-empty |
| Text-to-video | No media is provided |
image_urls and the reference fields in separate requests. In image-to-video, set aspect_ratio to auto or omit it.
Required parameters
prompt(string): Video instructions. Refer to reference media by upload order as@Image1,@Video1, and@Audio1.duration(integer): Output duration from 4 to 30 seconds.
Optional parameters
resolution(string):480por720p. Default:720p.aspect_ratio(string):auto,21:9,16:9,4:3,1:1,3:4, or9:16. Default:auto, which lets the model choose. Withimage_urls,autofollows the aspect ratio of the first frame.generate_audio(boolean): Generates synchronized audio with the video. Default:true.image_urls(array of strings): A first frame, or a first frame followed by a last frame. JPEG, PNG, or WebP, up to 30 MB each.reference_image_urls(array of strings): Up to 10 reference images. JPEG, PNG, or WebP, up to 30 MB each.reference_video_urls(array of strings): Up to 5 reference videos. MP4 or MOV, 2–30 seconds and up to 200 MB each.reference_audio_urls(array of strings): Up to 5 reference audio clips, used together withreference_image_urlsorreference_video_urls. MP3 or WAV, 2–30 seconds and up to 15 MB each.
Examples
Text to Video
{
"model": "seedance-2.5-flash",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "One continuous 30-second story of the same young woman in a yellow raincoat delivering a handwritten letter across a small seaside town at dawn. 0-6s: wide aerial shot of the sleepy harbor town, fishing boats rocking, soft morning light; she rides an old bicycle down a cobblestone hill. 6-12s: tracking shot beside her as she weaves past a fish market, seagulls lifting off, a vendor waves at her. 12-18s: low-angle shot as she climbs a steep stone staircase carrying the bicycle, breathing hard, the letter tucked in her pocket. 18-24s: she knocks on a blue door at the top; an elderly man opens it and she hands him the letter. 24-30s: close-up of the man reading, his eyes filling with tears; he smiles and says softly, \"She remembered.\" Camera slowly pulls back to reveal the sunrise over the sea. Natural ambient sound: waves, gulls, bicycle bell, footsteps, gentle piano music. No subtitles, no on-screen text.",
"duration": 30,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}
First and Last Frame
{
"model": "seedance-2.5-flash",
"input": {
"prompt": "Locked-off time-lapse of the red lakeside cabin: start from the summer evening in the first frame, let snow gradually cover the shore and the wooden dock as the sky darkens, and end exactly on the snowy night with the aurora in the last frame. Soft wind and crackling ice.",
"image_urls": [
"https://example.com/first-frame.jpg",
"https://example.com/last-frame.jpg"
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto"
}
}
Reference to Video
{
"model": "seedance-2.5-flash",
"input": {
"prompt": "@Image1 is the ginger cat. It wears the yellow knitted scarf from @Image2 and is inside the bookstore from @Image3. On a rainy night the cat walks along a bookshelf, jumps down beside a reading lamp, and looks at the camera. Match the slow, cozy rhythm of @Audio1. No subtitles.",
"reference_image_urls": [
"https://example.com/cat.png",
"https://example.com/scarf.png",
"https://example.com/bookstore.png"
],
"reference_audio_urls": [
"https://example.com/rhythm.mp3"
],
"duration": 6,
"resolution": "480p",
"aspect_ratio": "16:9"
}
}
Notes
- Reference videos together can last up to 30 seconds, and reference audio clips together can last up to 30 seconds. Both totals are checked when the task is submitted.
- Reference indexes start at 1 and follow the order of the corresponding input array.
- For
1080poutput, use Seedance 2.5. - All media URLs must be publicly accessible over HTTP or HTTPS and directly downloadable.
Authorizations
All API endpoints require Bearer Token authentication.
Create an API key: sign in to PoYo, open Dashboard → API Key at poyo.ai/dashboard/api-key, and click to create a key.
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Response
Task submitted successfully
Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.
200: Success400: Invalid request parameters401: Missing or invalid API key402: Insufficient credits403: Permission denied404: Resource not found408: Request timeout429: Rate limit exceeded500: Internal server error502: Upstream service error503: Service unavailable
See Error Codes for details.
Available options:
200, 400, 401, 402, 403, 404, 408, 429, 500, 502, 503 Example:
200