Tasks

Get async task status

get

Get task status and result by task_address.

Poll this endpoint to check progress of async tasks. No authentication required - the task_address itself is the auth token.

Does not count toward rate limit.

Status Values

• running - Task is being processed

• completed - Task finished successfully, result in response

• failed - Task failed, error message in response

Example Response (running)

{
    "task_address": "direct:a1b2c3d4-...",
    "status": "running",
    "elapsed_seconds": 45,
    "mode": "direct",
    "model": "Wan-AI/Wan2.5-T2V"
}

Example Response (completed)

{
    "task_address": "direct:a1b2c3d4-...",
    "status": "completed",
    "elapsed_seconds": 312,
    "result": {
        "video_url": "https://...",
        "duration": 5
    }
}

Example Response (failed)

{
    "task_address": "direct:a1b2c3d4-...",
    "status": "failed",
    "elapsed_seconds": 15,
    "error": "Provider timeout"
}

Path parameters

task_addressstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v2/tasks/{task_address}

HTTPcURLJavaScriptPython

GET /v2/tasks/{task_address} HTTP/1.1
Accept: */*

{
  "task_address": "direct:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "elapsed_seconds": 312,
  "mode": "direct",
  "model": "Wan-AI/Wan2.5-T2V",
  "created_at": "2024-01-15T10:30:00+00:00",
  "result": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "error": "text",
  "ANY_ADDITIONAL_PROPERTY": "anything"
}