API Notes
wan30_video_intl is the international variant of the standard Wan 3.0 All-in-One model and supports text-to-video, first-frame and first-last-frame image-to-video, and reference-to-video workflows through one model ID
wan30_video_intl can generate videos up to 30 seconds at 30fps; input.prompt and input.media are not validated as required fields by Vtrix, but the upstream model requires at least one of them
input.media reference, file, and link types cannot be combined with first_frame or last_frame in the same request
Authentication
authorization string required
All APIs require authentication via Bearer Token.
Get API Key:
Visit API Key Management Page to get your API Key.
Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEY
Parameters
model string required
Model ID to use for the request
Value: wan30_video_intl
input array required
Vtrix generation request array. Put the model request body in input[0].params
input[0].params object required
Wan 3.0 request body. Put source content under input and generation options under parameters
input
objectSource content for the video generation request
input.prompt
stringText prompt describing the expected video. Chinese and English are supported, and excess content is truncated. In reference mode, refer to media in array order with labels such as “image 1”, “video 1”, and “audio 1”
Maximum length:
20000characters
input.media
arrayMedia inputs for first-frame, first-last-frame, reference, file, or link workflows. Each item contains
typeandurl
first_frame: at most1image, used strictly as the first video framelast_frame: at most1image, used strictly as the last video framereference_image: at most10reference imagesreference_video: at most5reference videos with a combined duration no longer than15secondsreference_audio: at most5reference audio files with a combined duration no longer than15secondsfile: at most1document and cannot be combined withlinklink: at most1public web page and cannot be combined withfile
input.media[].type
stringMedia item type
Options:
first_frame,last_frame,reference_image,reference_video,reference_audio,file,link
input.media[].url
stringPublicly accessible media URL or Base64-encoded image data where supported
Image requirements: JPEG, JPG, PNG without transparency, BMP, or WEBP; each side
240to8000pixels; aspect ratio no greater than8:1; file size no greater than20MBReference video requirements: MP4 or MOV; each video
1to15seconds; each side240to4096pixels; aspect ratio no greater than8:1; file size no greater than100MBReference audio requirements: WAV or MP3; each audio file
1to15seconds; file size no greater than15MBFile requirements: DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, or MD; file size no greater than
100MB; paginated documents support up to50pages
parameters
objectVideo generation options
parameters.resolution
stringOutput resolution tier. The successful task’s output resolution is used for billing
Options:
1080P,720P,480PDefault:
1080P
parameters.ratio
stringOutput aspect ratio.
adaptiveselects a ratio based on the input media and request intentOptions:
adaptive,16:9,4:3,1:1,3:4,9:16Default:
adaptive
parameters.duration
integerOutput duration in seconds. Without video input, use an integer from
2to30. With video input, the total input video duration plus output duration cannot exceed30seconds. Use-1to let the model select the durationDefault:
5
parameters.audio
booleanWhether the output video contains audio. Enabling or disabling audio does not change the price
Options:
true,falseDefault:
true
parameters.seed
integerRandom seed used to improve reproducibility
Range:
0-2147483647
parameters.prompt_extend
booleanWhether to use a language model to rewrite and enrich the prompt. This can improve short prompts but increases processing time
Options:
true,falseDefault:
true
parameters.watermark
booleanWhether to add a watermark to the output video
Options:
true,falseDefault:
false
Polling
Since result generation takes time, you need to poll the task status after creating the task.
The initial response only returns information such as the task ID and initial status. The final result must be obtained by polling the task status endpoint using the task ID.
See the examples on the right for polling requests and responses.
Response Format
error object
Error information, only present when status is failed
code
stringError code
message
stringDetailed error message
output array
Generation results, only present when status is completed
content
arrayList of generated resource content
type
stringResource type
Value:
image|videourl
stringProcessed resource URL
jobId
stringRemote task ID
usage object
Usage statistics, only present when status is completed
cost
stringTotal cost in USD
discount
numberDiscount amount
metadata object
Metadata information