Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

At least one of reference_images, reference_videos, or first_frame_image must be provided.

​
prompt
string
required

Video content description (supports Chinese and English, up to 5000 characters). Can reference media using 'Image1/Image2' or 'Video1/Video2' format

Required string length: 1 - 5000
Example:

"The character walks through a blooming garden"

​
reference_images
string<uri>[]

Reference image URLs. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Combined with reference_videos, max 5 total

Example:
​
reference_videos
string<uri>[]

Reference video URLs. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Combined with reference_images, max 5 total

Example:
​
first_frame_image
string<uri>

First frame image URL. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Max 1, not counted in the 5-item limit

Example:

"https://example.com/first_frame.jpg"

​
negative_prompt
string

Negative prompt describing unwanted content

Maximum string length: 500
Example:

"blurry, distorted, low quality"

​
resolution
enum<string>
default:1080P

Video resolution tier

Available options:
720P,
1080P
Example:

"1080P"

​
ratio
enum<string>
default:16:9

Video aspect ratio (auto-ignored when first_frame_image is present)

Available options:
16:9,
9:16,
1:1,
4:3,
3:4
Example:

"16:9"

​
duration
enum<integer>
default:5

Video duration in seconds. Dynamic range: [2,10] when reference_videos is present, [2,15] when only reference_images

Available options:
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Example:

5

​
prompt_extend
boolean
default:true

Enable intelligent prompt rewriting

Example:

true

​
seed
integer

Random seed for reproducibility

Required range: 0 <= x <= 2147483647
Example:

42

Response

200 - application/json

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required

Detailed data about the submitted asynchronous task.