wan2.6-t2v API Usage Guide
Overview
wan2.6-t2v is Wan AI’s text-to-video model with reference-aware generation. Requests are submitted to the request-queue API and results are retrieved via polling.Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header:Submit Video Generation Request
Base URL
Endpoint
Request Format
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|---|---|---|---|---|
model | string | Yes | Model identifier | - | Must be "wan2.6-t2v" |
payload.prompt | string | Yes | Text prompt describing desired video | - | Max 1500 characters |
payload.audio_url | string (URL) | No | wav/mp3 audio to drive the video | null | 3–30s, ≤15 MB; excess trimmed to duration |
payload.negative_prompt | string | No | What to avoid in the video | "" | Max 500 characters |
payload.size | string (enum) | No | Output resolution | ”1920*1080” | Options: “1280*720”, “720*1280”, “960*960”, “1088*832”, “832*1088”, “1920*1080”, “1080*1920”, “1440*1440”, “1632*1248”, “1248*1632” |
payload.duration | integer (enum) | No | Video length in seconds | 5 | Options: 5, 10, 15 |
payload.prompt_extend | boolean | No | Let LLM rewrite prompt for richer detail | true | - |
payload.shot_type | string (enum) | No | Single vs multi-shot sequencing | ”single” | Options: “single”, “multi”; applied when prompt_extend is true |
payload.audio | boolean | No | Auto-generate audio if audio_url not set | true | - |
payload.watermark | boolean | No | Add fixed AI Generated watermark | false | - |
payload.seed | integer | No | Random seed for reproducibility | - | 0–2147483647 |
Response
Check Request Status
Endpoint
Example
Response
Request Status Values
| Status | Description |
|---|---|
queued | Request is waiting to be processed |
processing | Video generation is in progress |
success | Video generation completed successfully |
failed | Video generation failed |
cancelled | Request was cancelled |