Skip to main content
POST
wan3.0-video

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

Must be one of: wan3.0-video.

Available options:
wan3.0-video
prompt
string

Enter a prompt for text-to-video. For image-to-video, describe motion, camera movement, and sound.

Maximum string length: 20000
first_frame_image
string

Enter an accessible image URL for image-to-video. This control does not upload local files. The API also accepts OSS URLs and image Data URLs.

last_frame_image
string

A last frame requires a first frame. Leave this blank for first-frame-only image-to-video.

Conditional limits:

  • A last frame requires a first frame.
duration
enum<integer>
default:5

In seconds. -1 selects automatic duration. Billing uses the actual generated duration. Defaults to 5.

Available options:
-1,
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
resolution
enum<string>
default:1080P

Must be one of: 1080P, 480P, 720P. Defaults to 1080P.

Available options:
1080P,
480P,
720P
size
enum<string>
default:adaptive

adaptive selects the aspect ratio automatically. For image-to-video, use adaptive to match the input image. Defaults to adaptive.

Available options:
16x9,
1x1,
3x4,
4x3,
9x16,
adaptive
seed
integer
default:-1

-1 selects a random seed. Using the same seed does not guarantee identical results. Defaults to -1.

Required range: -1 <= x <= 2147483647
extends.audio
boolean
default:true

Turn off to generate a video without an audio track. This setting does not change the unit price. Defaults to true.

extends.prompt_extend
boolean
default:true

Defaults to true.

extends.watermark
boolean
default:false

Defaults to false.

Response

Business response. code=0 means the task was accepted; validation failures can return HTTP 200 with code=400.

code
enum<integer>
required
Available options:
0
Example:

0

data
object
required
msg
string
required
Example:

"success"

request_id
string<uuid>
Example:

"250b66dd-e1fb-4bb6-b5f6-c668efadc35d"