Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Wan 3.0 image-to-video. Choose one option — Frame and Reference fields are mutually exclusive. prompt is optional. audio_urls is only valid with reference_images.

​
first_frame
string<uri>
required

Required. First-frame image URL. Do not pass reference_images or audio_urls.

Example:

"https://example.com/first.png"

​
last_frame
string<uri>

Optional. Last-frame image URL. Requires first_frame. Do not pass reference_images or audio_urls.

Example:

"https://example.com/last.png"

​
prompt
string

Optional. 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."

​
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.