Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

video_urls is required. Optional reference_images and audio_urls can be combined with the reference videos.

​
video_urls
string<uri>[]
required

Reference video URLs (1-5). Total input video duration must be no more than 15 seconds.

Required array length: 1 - 5 elements
Example:
​
prompt
string

Text prompt describing the desired video content. Supports Chinese and English. Max 20000 characters.

Required string length: 1 - 20000
Example:

"A cute cat running on a moonlit rooftop, cinematic."

​
reference_images
string<uri>[]

Optional reference image URLs (1-10) used together with reference videos

Required array length: 1 - 10 elements
Example:
​
audio_urls
string<uri>[]

Optional reference audio URLs (1-5)

Required array length: 1 - 5 elements
Example:
​
resolution
enum<string>
default:1080P

Specifies the resolution tier for the generated video

Available options:
480P,
720P,
1080P
Example:

"1080P"

​
ratio
enum<string>
default:1:1

Specifies the aspect ratio for the generated video

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

"1:1"

​
duration
enum<integer>
default:5

Video duration in seconds. Allowed values are integers from 2 to 30

Available options:
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
Example:

5

​
audio
boolean
default:true

Whether the output video includes an audio track

Example:

true

​
seed
integer

Random number seed for reproducibility. Identical seeds cannot guarantee completely identical results

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

12345

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.