Appearance
Midjourney Imagine
Midjourney Imagine 用于提交文生图任务。提交后请保存任务 ID,再通过任务查询接口读取进度和结果。
接口路径
| 方法 | 路径 | 返回方式 |
|---|---|---|
POST | /mj/submit/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"
}'常用字段
| 字段 | 说明 |
|---|---|
prompt | Midjourney prompt 和参数。 |
notifyHook | 任务状态回调地址。 |
state | 业务侧自定义透传字段,以 API Reference 为准。 |
任务处理
| 阶段 | 处理方式 |
|---|---|
| 提交成功 | 保存任务 ID、prompt、用户 ID 和业务订单。 |
| 任务进行中 | 展示排队或生成状态,并允许用户刷新。 |
| 任务完成 | 读取最终图片 URL,并保存原始查询结果。 |
| 任务失败 | 展示失败信息,保留重新提交入口。 |
接入建议
- 保存提交响应中的任务 ID,作为后续查询主键。
- 用户端可以展示排队、执行、完成、失败等状态。
- 配置回调后仍建议保留主动查询入口,便于用户刷新结果。