Skip to main content
POST
Wanx Wan 2.7 Reference-to-Video
Wanx Wan 2.7 reference-to-video model supports multimodal input (text/images/videos). It can use a person or object as the protagonist to generate single-character performance videos or multi-character interaction videos. It supports intelligent storyboarding to generate multi-shot videos. It supports 720P and 1080P resolutions, durations from 2 to 10 seconds, and is billed by the second. The output includes audio by default.
This is an asynchronous API and only returns the asynchronous task’s task_id. You should use this task_id to request the Get Task Result API to retrieve the generated result.

Request Headers

string
required
Enumerated value: application/json
string
required
Bearer authentication format: Bearer {{API key}}.

Request Body

integer
Random seed, used to improve the reproducibility of generated results. Value range: [0, 2147483647].Value range: [0, 2147483647]
string
default:"1920*1080"
Output video resolution (widthheight), which affects cost. 720P tier: 1280720 (16:9), 7201280 (9:16), 960960 (1:1), 1088832 (4:3), 8321088 (3:4). 1080P tier: 19201080 (16:9), 10801920 (9:16), 14401440 (1:1), 16321248 (4:3), 1248*1632 (3:4).Available values: 1280*720, 720*1280, 960*960, 1088*832, 832*1088, 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632
boolean
default:true
Whether to generate a video with sound, which affects cost. Default is true (video with sound).
object[]
required
Reference media array, used to extract character appearance, motion, and voice timbre. Corresponds to character1, character2, etc. in the prompt in array order. Number of images: 0–5; number of videos: 0–3; total number does not exceed 5. Image formats: JPEG, JPG, PNG, BMP, WEBP; resolution [240,8000] pixels; no more than 10 MB. Video formats: MP4, MOV; duration 1–30 seconds; no more than 100 MB. Audio formats: MP3, WAV, FLAC; duration 3–30 seconds.Array length: 1 - 5
string
required
Text prompt, used to describe the elements and visual characteristics expected in the generated video. Use character1, character2, etc. to reference the reference characters. Each reference (video or image) contains only a single character. Chinese and English are supported, up to 1500 characters.Length limit: 0 - 1500
integer
default:5
Duration of the generated video, in seconds, billed by the second. Integer value range: [2, 10].Value range: [2, 10]
string
default:"single"
Shot type. single indicates a single shot (default), and multi indicates multiple shots. This parameter has higher priority than the prompt.Available values: single, multi
boolean
default:false
Whether to add a watermark identifier. The watermark is located in the lower-right corner of the video.
string
Negative prompt, used to describe content you do not want to appear in the video. Chinese and English are supported, up to 500 characters.Length limit: 0 - 500

Response

string
Use task_id to request the Get Task Result API to retrieve the generated output.