Appearance
Midjourney 任务
Midjourney 能力是任务型接口。提交任务后需要保存任务 ID,再通过查询接口读取状态和结果。建议同时配置回调字段,并保留主动查询能力。
路由清单
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /mj/submit/imagine | 提交 Imagine 任务。 |
POST | /mj/submit/action | 提交动作任务。 |
POST | /mj/submit/blend | 提交混图任务。 |
POST | /mj/submit/describe | 提交描述任务。 |
POST | /mj/submit/modal | 提交 Modal 任务。 |
POST | /mj/submit/shorten | 提交短提示词任务。 |
POST | /mj/submit/video | 提交视频任务。 |
GET | /mj/task/{id}/fetch | 查询单个任务。 |
POST | /mj/task/list-by-condition | 批量查询任务。 |
GET | /mj/task/{id}/image-seed | 查询图片 seed。 |
提交 Imagine
bash
curl https://moonapix.com/mj/submit/imagine \
-H "Authorization: Bearer <MOONAPIX_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A futuristic city at sunrise --ar 16:9",
"notifyHook": "https://example.com/moonapix/webhook"
}'查询任务
bash
curl https://moonapix.com/mj/task/task_xxx/fetch \
-H "Authorization: Bearer <MOONAPIX_API_KEY>"接入建议
- 保存提交响应中的任务 ID。
- 对同一任务做幂等处理,避免重复入库。
- 任务完成后保存最终图片 URL 和原始响应。
- 回调失败时允许用户通过任务查询获取结果。