MoonApiX Docs

Appearance

异步任务 ​

MoonApiX 的视频、音乐、数字人和部分图片能力会以异步任务形式运行。创建任务后保存 task_id，再查询状态或等待 Webhook。

创建任务 ​

bash
curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music-v5.5",
    "prompt": "A warm pop song about sunrise.",
    "title": "Morning Light"
  }'

查询任务 ​

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

状态处理 ​

状态说明
pending / submitted已创建或已提交。
running正在处理。
succeeded已完成，可以读取结果。
failed已失败，读取 fail_reason 或 error。
cancelled已取消。

部分模型会返回 SUBMITTED、QUEUED、IN_PROGRESS、SUCCESS、FAILURE 等大写状态。业务系统可以做等价映射。

重要建议 ​

  • 永远保存创建响应中的 task_id。
  • 前端或服务端读取媒体 URL 前，先检查 status。
  • 失败任务通常会包含 fail_reason，可直接用于用户提示。
  • 对长任务使用 Webhook，同时保留主动查询。

常用入口 ​

能力创建查询
音乐POST /v1/tasksGET /v1/tasks/{task_id}
数字人音频POST /v1/tasksGET /v1/tasks/{task_id}
数字人视频POST /v1/tasksGET /v1/tasks/{task_id}
视频POST /v1/videosGET /v1/videos/{task_id}
图片异步任务POST /v1/images/generations/asyncGET /v1/images/tasks/{task_id}