v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Wan video task

Create a Wan text-to-video task. Send fields as multipart/form-data.

post/v1/videos

Response

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

idstring required

Task ID. Use this value as task_id in retrieve and content requests.

task_idstring

Compatibility alias for id. The value matches id when present.

objectstring required

Object type. Wan video tasks return video.

modelstring required

Model ID used for the task.

status'queued' | 'in_progress' | 'completed' | 'failed' | 'error' required

Task lifecycle status. Poll until the value is completed, failed, or error.

progressinteger required

Task progress as a coarse percentage.

created_atinteger required

Task creation time as a Unix timestamp in seconds.

completed_atinteger

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

video_urlstring

Temporary video delivery URL. This field appears on completed tasks.

errorobject

Failure details. This field appears when the task fails.

Example response

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan2.6",
  "status": "queued",
  "created_at": 1779938152,
  "completed_at": 1779938219,
  "video_url": "<temporary-video-url>"
}