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 response result through the unified Query Task Status endpoint.
Seedance 2.5 Flash is the Flash tier of ByteDance Seedance 2.5, with 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 480p or 720p

Features

  • 4–30 second videos: Set duration to any whole number of seconds from 4 to 30.
  • Synchronized audio: Audio is generated in the same pass as the video. Set generate_audio to false for 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, or 9:16.

Input modes

Use 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): 480p or 720p. Default: 720p.
  • aspect_ratio (string): auto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16. Default: auto, which lets the model choose. With image_urls, auto follows 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 with reference_image_urls or reference_video_urls. MP3 or WAV, 2–30 seconds and up to 15 MB each.

Examples

Text to Video

First and Last Frame

Reference to Video

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 1080p output, use Seedance 2.5.
  • All media URLs must be publicly accessible over HTTP or HTTPS 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.5 Flash model identifier

Available options:
seedance-2.5-flash
input
object
required
callback_url
string<uri>

Webhook callback URL for result notifications

Example:

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

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
message
string
Example:

"success"