Query task

General task query API is used to read music, digital human, video and other asynchronous tasks. The status is judged first, and then the result or cause of failure is read.

GET /v1/tasks/{task_id}

curl https://moonnexai.com/v1/tasks/task_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>"

Success response

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "status": "succeeded",
  "progress": "100%",
  "result": {
    "audio_url": "https://example.com/result.mp3"
  }
}

Failed response

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "status": "failed",
  "progress": "100%",
  "fail_reason": "The request parameters are invalid.",
  "error": {
    "message": "The request parameters are invalid."
  }
}

Query Recommendations

• Saves the task_id returned when creating task.
• Do not infer success from a URL field alone; check status first.
• Show fail_reason or error.message as a priority in failed/ FAILURE status.
• Failed task usually does not need to continue polling.

Relevant Pages

• Overview of mandate management
• Asynchronous tasks
• Webhooks and callbacks
• API Reference