Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is 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-2 is the default standard-quality variant
  • seedance-2 supports 480p, 720p, 1080p, and 4k
  • seedance-2-fast uses the same input schema but is optimized for lower latency, and supports 480p and 720p only
  • prompt must be between 3 and 20,000 characters.
  • image_urls is used for image-to-video mode and supports up to 2 images only: index 0 maps to the starting frame and index 1 maps to the optional ending frame.
  • image_urls supports JPG, JPEG, PNG, WebP, GIF, and AVIF images. Each image should be publicly accessible and up to 30 MB.
  • image_urls and any reference_*_urls fields are mutually exclusive and cannot be used together in the same request.
  • reference_image_urls is 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_urls supports 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_urls supports 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, and reference_audio_urls must not exceed 12.
  • Reference assets can be mentioned in the prompt by order, such as @Image1, @Video1, and @Audio1.
  • aspect_ratio is optional. When provided, supported values are auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • duration supports integer values from 4 to 15.
  • resolution supports 1080p and 4k only for seedance-2. seedance-2-fast remains limited to 480p and 720p.
  • All remote URLs should be publicly accessible and directly downloadable.

Authorizations

Authorization
string
header
required

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:

Body

application/json
model
enum<string>
required

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
callback_url
string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

input
object

Input parameters for generation

Response

Task submitted successfully

code
enum<integer>
required

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: Success
  • 400: Invalid request parameters
  • 401: Missing or invalid API key
  • 402: Insufficient credits
  • 403: Permission denied
  • 404: Resource not found
  • 408: Request timeout
  • 429: Rate limit exceeded
  • 500: Internal server error
  • 502: Upstream service error
  • 503: Service unavailable

See Error Codes for details.

Available options:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
Example:

200

data
object
required