Skip to main content
POST
Wan V2.7 Edit Video
Wan 2.7 instruction-based video editing and style transfer.

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

Editing instruction or style transfer description.

Minimum string length: 1
video_url
string<uri>
required

Input video URL to edit. Supports MP4 and MOV, 2-10 seconds, max 100 MB.

reference_image_url
string<uri>

Optional reference image URL for reference-based editing.

resolution
enum<string>
default:1080p

Output video resolution tier.

Available options:
720p,
1080p
aspect_ratio
enum<string> | null

Optional output aspect ratio. If omitted, the input video ratio is preserved.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4
duration
default:0

Output duration in seconds. 0 keeps input duration; 2-10 truncates from the start.

audio_setting
enum<string>
default:auto

Choose whether to regenerate audio or preserve original audio.

Available options:
auto,
origin
seed
integer | null

Random seed for reproducibility.

Required range: 0 <= x <= 2147483647
n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.