Appearance
任务管理概览
视频、数字人、音乐、部分图片和后处理能力会以异步任务形式运行。提交任务后，MoonApiX 返回任务 ID；你可以主动查询，也可以通过 Webhook 接收完成通知。
Tasks异步任务查看通用任务结构、状态、轮询建议和结果 URL。GET查询任务复制通用查询请求，理解结果 URL 和失败字段。WebhookWebhook 和回调接收任务完成通知，处理成功和失败 payload。Errors错误码处理鉴权、参数、额度、频率和任务失败问题。
通用流程
- 提交任务。
- 保存返回的
task_id或id。 - 主动查询任务状态，或等待 Webhook。
- 任务成功后读取结果 URL。
- 任务失败时读取
fail_reason、error.code和error.message。
常用查询入口
| 能力 | 查询路径 |
|---|---|
| 通用任务 | GET /v1/tasks/{task_id} |
| 音乐任务 | GET /v1/tasks/{task_id} |
| 数字人音频 | GET /v1/tasks/{task_id} |
| 数字人视频 | GET /v1/tasks/{task_id} |
| 视频任务 | GET /v1/videos/{task_id} |
| Midjourney 任务 | GET /mj/task/{id}/fetch |
状态说明
| 状态 | 说明 | 建议 |
|---|---|---|
pending | 系统准备中。 | 稍后继续查询。 |
submitted | 已提交，等待处理。 | 稍后继续查询。 |
running | 正在处理。 | 继续等待。 |
succeeded | 已完成。 | 读取结果 URL。 |
failed | 任务失败。 | 查看失败原因并决定是否重试。 |
cancelled | 任务已取消。 | 停止查询。 |
部分任务可能返回大写状态，例如 SUBMITTED、QUEUED、IN_PROGRESS、SUCCESS、FAILURE。业务系统可以统一映射为等待中、处理中、成功和失败。
Webhook 建议
- 回调接口应在 10 秒内返回
2xx。 - 按
task_id做幂等处理。 - 不要在回调 URL 中放 API Key、用户 token 或其他敏感信息。
- 即使启用了 Webhook，也保留主动查询能力。