curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying over a neon city after rain, reflections shimmering on the streets",
"aspect_ratio": "16:9",
"resolution": "4k",
"duration": 5,
"generate_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-04T10:30:00"
}
}Seedance
Seedance 2 Video Generation
Video generation with Seedance 2 and Seedance 2 Fast
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",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying over a neon city after rain, reflections shimmering on the streets",
"aspect_ratio": "16:9",
"resolution": "4k",
"duration": 5,
"generate_audio": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-04T10:30:00"
}
}- 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.
Available Models
- seedance-2 - Standard Seedance 2 video generation model
- seedance-2-fast - Faster, lower-cost Seedance 2 variant
Key Features
- Text-to-Video: Generate videos directly from prompt text
- First and Last Frame Control: Use up to 2 images as the first and last frame
- Multimodal Reference: Guide generation with reference images, videos, and audio
- Optional Audio: Request generated audio together with the video
Variant Notes
seedance-2is the default standard-quality variantseedance-2supports480p,720p,1080p, and4kseedance-2-fastuses the same input schema but is optimized for lower latency and lower credit cost, and supports480pand720ponly
Important Notes
promptmust be between 3 and 20,000 characters.image_urlsis used for image-to-video mode and supports up to 2 images only: index0maps to the starting frame and index1maps to the optional ending frame.image_urlssupports JPG, JPEG, PNG, WebP, GIF, and AVIF images. Each image should be publicly accessible and up to 30 MB.image_urlsand anyreference_*_urlsfields are mutually exclusive and cannot be used together in the same request.reference_image_urlsis used for reference-to-video mode and supports up to 9 images. Supported formats are JPG, JPEG, PNG, and WebP, with each image up to 30 MB.reference_video_urlssupports up to 3 MP4 or MOV files. The combined reference video duration should be 2 to 15 seconds total, total video size should be under 50 MB, and each video should be 480p to 720p.reference_audio_urlssupports up to 3 MP3 or WAV files. The combined reference audio duration should not exceed 15 seconds, and each audio file should be up to 15 MB. Audio references require at least one reference image or reference video.- For reference-to-video mode, the total number of files across
reference_image_urls,reference_video_urls, andreference_audio_urlsmust not exceed 12. - Reference assets can be mentioned in the prompt by order, such as
@Image1,@Video1, and@Audio1. aspect_ratiois optional. When provided, supported values areauto,21:9,16:9,4:3,1:1,3:4,9:16.durationsupports integer values from4to15.resolutionsupports1080pand4konly forseedance-2.seedance-2-fastremains limited to480pand720p.- All remote URLs should be publicly accessible and directly downloadable.
Credits Reference
- Credits are calculated based on video duration and selected resolution.
- If
reference_video_urlsis provided, the final credit cost may differ from requests without video references.
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Seedance 2 model identifier. Use seedance-2 for the standard variant or seedance-2-fast for faster, lower-cost generation.
Available options:
seedance-2, seedance-2-fast Webhook callback URL for result notifications
Example:
"https://your-domain.com/callback"
Input parameters for generation
Show child attributes
Show child attributes