Skip to main content
Create Wan2.7 video tasks through POST /v1/video/generations. Choose a workflow below; each workflow uses the same endpoint with a different model ID and input media structure.

Create task

POST /v1/video/generations
cURL
200

Request headers

string
required
Bearer authentication in the form Bearer YOUR_API_KEY.
string
default:"application/json"
required
Request body format.

Request parameters

string
required
Must be wan2.7-t2v.
string
required
Video description in Chinese or English. Maximum 5,000 non-Chinese or 2,500 Chinese characters.
string
Content to exclude from the video. Maximum 500 characters.
string
Public WAV or MP3 URL. The audio must be 2-30 seconds and no larger than 15 MB.
string
default:"1080P"
Output resolution: 720P or 1080P.
string
default:"16:9"
Output aspect ratio: 16:9, 9:16, 1:1, 4:3, or 3:4.
integer
default:5
Video duration from 2 to 15 seconds.
boolean
default:true
Whether to rewrite and enrich the prompt. For specific content requests, select the Special-Ns resource group and set this parameter to false.
boolean
default:false
Whether to add an AI Generated watermark.
integer
Random seed in [0, 2147483647].

Response

string
Created task ID.
string
Created task ID; use it for task queries.
string
Response object type, returned as video.
string
Model used for task creation.
string
Initial task status, normally queued.
integer
Initial task progress, normally 0.
integer
Task creation time as a Unix timestamp.

Error responses

  • 400 Bad Request - Invalid input or unsupported parameter or media combination.
  • 401 Unauthorized - API key is missing or invalid.
  • 429 Rate limit exceeded - Request rate exceeded the applicable limit.