MoonApiX Docs

Appearance

查询任务 ​

通用任务查询接口用于读取音乐、数字人、视频和其他异步任务的状态。查询时先判断 status，再读取结果或失败原因。

http
GET /v1/tasks/{task_id}
bash
curl https://moonapix.com/v1/tasks/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

成功响应 ​

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

失败响应 ​

json
{
  "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."
  }
}

查询建议 ​

  • 保存创建任务时返回的 task_id。
  • 不要只根据 URL 字段判断任务成功，必须先检查 status。
  • failed / FAILURE 状态下优先展示 fail_reason 或 error.message。
  • 已失败任务通常不需要继续轮询。

相关页面 ​