Appearance
Fetch - 查询绘图任务
通过任务 ID 查询 Midjourney 绘图任务的状态、进度和生成结果。
一、接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | GET |
| 请求路径 | /mj/task/{id}/fetch |
| 完整地址 | https://api.hllapi.vip/mj/task/{id}/fetch |
| 鉴权方式 | Bearer Token |
二、请求头
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | String | 是 | Bearer API Key |
三、路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | String | 是 | Imagine 返回的任务 ID |
四、请求示例
cURL
curl -X GET "https://api.hllapi.vip/mj/task/YOUR_TASK_ID/fetch" \
-H "Authorization: Bearer YOUR_API_KEY"
PowerShell
$headers = @{
Authorization = "Bearer YOUR_API_KEY"
}
$result = Invoke-RestMethod `
-Uri "https://api.hllapi.vip/mj/task/YOUR_TASK_ID/fetch" `
-Method GET `
-Headers $headers
$result | Format-List *
五、返回字段
| 字段 | 说明 |
|---|---|
| id | 任务 ID |
| action | 任务操作类型 |
| prompt | 原始提示词 |
| promptEn | 英文提示词 |
| status | 任务状态 |
| progress | 任务进度 |
| submitTime | 提交时间 |
| startTime | 开始时间 |
| finishTime | 完成时间 |
| imageUrl | 图片访问地址 |
| videoUrl | 视频访问地址 |
| videoUrls | 视频地址列表 |
| failReason | 失败原因 |
| buttons | 后续操作按钮 |
| properties | 扩展属性 |
六、任务状态
| 状态 | 说明 |
|---|---|
| IN_PROGRESS | 正在生成 |
| SUCCESS | 生成成功 |
| FAILURE | 生成失败 |
以上状态中，IN_PROGRESS 和 SUCCESS 已有实际测试记录；其他状态以接口实际返回为准。
七、成功响应示例
以下为真实任务响应的简化示例：
{
"id": "1794254436902883",
"action": "IMAGINE",
"status": "SUCCESS",
"progress": "100%",
"imageUrl": "https://api.hllapi.vip/mj/image/1794254436902883",
"failReason": ""
}
八、获取生成图片
任务成功后，读取返回的 imageUrl。
示例：
https://api.hllapi.vip/mj/image/YOUR_TASK_ID
请使用返回的公网图片地址，不要使用 localhost 地址。
九、常见问题
1. task_no_found
检查任务 ID 是否正确，以及任务是否属于当前服务。
2. 任务仍在生成
当 status 为 IN_PROGRESS 时，可以继续查询，不需要重新提交任务。
3. 任务生成失败
检查 failReason 返回的具体原因。
十、推荐调用流程
- 调用 Imagine 提交绘图任务。
- 获取 result 返回的任务 ID。
- 调用 Fetch 查询任务。
- 等待 status 变为 SUCCESS。
- 读取 imageUrl 获取图片。