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"
}
}{
"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
The Seedance 2 API generates a 4–15 second video from text, up to two frames, or image, video, and audio references. A faster variant is limited to 480p and 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",
"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"
}
}{
"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 result through the unified Query Task Status endpoint.
Models
- seedance-2 - Standard Seedance 2 video generation model
- seedance-2-fast - Faster, lower-cost Seedance 2 variant
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
Notes
-
seedance-2is the default standard-quality variant -
seedance-2supports480p,720p,1080p, and4k -
seedance-2-fastuses the same input schema but is optimized for lower latency, and supports480pand720ponly -
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.
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