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: wan22_t2v_plus
input object required
Basic input object for generation, such as prompts
prompt
stringrequiredText prompt used to describe expected elements and visual characteristics in the generated video
Supports Chinese and English, each Chinese character/letter counts as one character, overflow is automatically truncated
For wan2.2 and wan2.1 series models, maximum length is800characters
Example:一只小猫在月光下奔跑
negative_prompt
stringNegative prompt used to describe content that should not appear in the generated video
Supports Chinese and English, maximum length is500characters, overflow is automatically truncated
Example:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等
parameters object
Video generation control parameters, such as resolution, prompt rewrite, and watermark
size
string
sizemust be a concrete value such as1280*720, not1:1or480P
Specifies output resolution inwidth*heightformat
Forwan2.2-t2v-plus, default is1920*1080and available resolutions are all 480P and 1080P resolutions480P Tier:
832*480: 16:9
480*832: 9:16
624*624: 1:11080P Tier:
1920*1080: 16:9
1080*1920: 9:16
1440*1440: 1:1
1632*1248: 4:3
1248*1632: 3:4Default:
1920*1080
duration
integerFor
wan2.2-t2v-plus, duration is fixed at5seconds and cannot be modifiedValue:
5
prompt_extend
booleanWhether to enable intelligent prompt rewriting, when enabled a large model rewrites the input prompt and usually improves short prompts but increases latency
Options:
true,falseDefault:
true
watermark
booleanWhether to add a watermark in the lower-right corner, fixed text is
AI生成Options:
false,trueDefault:
false
seed
integerRandom seed value, if not specified the system generates one automatically, fixing
seedcan improve reproducibility
Due to probabilistic generation, identicalseeddoes not guarantee exactly identical output every run
Example:12345Range:
0-2147483647
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.
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