Seedance 2 Mini

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2-mini",
  "input": {
    "prompt": "Camera follows a man in black sprinting through a crowded street, a group chasing close behind. The shot cuts to a side tracking angle as he panics and crashes into a roadside fruit stall, scrambles to his feet, and keeps running. Sounds of a frantic crowd.",
    "aspect_ratio": "auto",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2026-06-25T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

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-mini",
  "input": {
    "prompt": "Camera follows a man in black sprinting through a crowded street, a group chasing close behind. The shot cuts to a side tracking angle as he panics and crashes into a roadside fruit stall, scrambles to his feet, and keeps running. Sounds of a frantic crowd.",
    "aspect_ratio": "auto",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2026-06-25T10: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_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.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Models

seedance-2-mini - Fast Seedance 2 Mini video generation

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
Reference-to-Video: Guide generation with reference images, videos, and audio
Optional Audio: Request generated audio together with the video

Notes

prompt is required.
duration supports integer values from 4 to 15.
resolution supports 480p and 720p.
aspect_ratio is optional. Supported values are auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
image_urls and any reference_*_urls fields are mutually exclusive.
reference_image_urls supports up to 9 images.
reference_video_urls supports up to 3 videos.
reference_audio_urls supports up to 3 audio files and requires at least one reference image or reference video.
The total number of reference files across image, video, and audio references must not exceed 12.
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:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Seedance 2 Mini model identifier

Available options:

seedance-2-mini

input

object

required

Input parameters for generation

Show child attributes

callback_url

string<uri>

Webhook callback URL for result notifications. Use a publicly reachable endpoint that you control.

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

Show child attributes

​Models

​Features

​Notes

Authorizations

Body

Response

Models

Features

Notes