Skip to main content
POST

Authorizations

Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Wan 2.7 image-to-video. Choose one option — Frame and Continuation fields are mutually exclusive. prompt is optional. Do not mix first_frame with first_clip. driving_audio is only valid with first-frame modes.

first_frame
string
required

Required. First frame image URL. Supports HTTP/HTTPS URL, OSS URL, or image base64 data URI. Do not pass first_clip.

Pattern: ^(https?://|oss://|data:image/)
Examples:

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

"oss://dashscope-instant/example/first.png"

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="

last_frame
string

Optional last frame image URL. Requires first_frame. Supports HTTP/HTTPS URL, OSS URL, or image base64 data URI.

Pattern: ^(https?://|oss://|data:image/)
driving_audio
string

Optional driving audio URL (HTTP/HTTPS/OSS). Do not pass with first_clip.

Pattern: ^(https?://|oss://)
prompt
string

Optional text prompt, max 5000 chars.

Maximum string length: 5000
negative_prompt
string

Optional negative prompt, max 500 chars.

Maximum string length: 500
resolution
enum<string>
default:1080P

Output resolution tier.

Available options:
720P,
1080P
duration
integer
default:5

Video duration in seconds.

Required range: 2 <= x <= 15
prompt_extend
boolean
default:true

Enable prompt intelligent rewrite.

seed
integer

Random seed for reproducibility.

Required range: 0 <= x <= 2147483647

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.