获取 API Key 获取 API
文档

任务查询

查询 Midjourney 任务状态与结果。统一任务接口 /v1/tasks/{task_id} 与 MJ 风格接口 /v1/midjourney/{task_id}

请求示例

curl --request GET \
  --url https://api.openveer.com/v1/midjourney/task_01KV52C0TEJSYZMCG0NCS4YWKK \
  --header 'Authorization: Bearer <token>'

响应示例

{
  "id": "task_01KV52C0TEJSYZMCG0NCS4YWKK",
  "status": "SUCCESS",
  "action": "IMAGINE",
  "progress": "100%",
  "grid_image_url": "https://cdn.openveer.com/mj_xxxx.png",
  "image_urls": [
    "https://cdn.openveer.com/mj_xxxx_0.png",
    "https://cdn.openveer.com/mj_xxxx_1.png",
    "https://cdn.openveer.com/mj_xxxx_2.png",
    "https://cdn.openveer.com/mj_xxxx_3.png"
  ],
  "buttons": [
    {"customId": "MJ::JOB::upsample::1::abc123def456", "label": "U1"},
    {"customId": "MJ::JOB::variation::1::abc123def456", "label": "V1"}
  ],
  "prompt": "a beautiful sunset over mountains"
}

推荐业务侧轮询统一任务接口:

GET /v1/tasks/{task_id}

统一任务状态为 pending / processing / completed / failed,成功结果位于 result.images[].url。

需要读取 buttons[].customId 做二次操作时,使用 MJ 风格查询:

GET /v1/midjourney/{task_id}

任务状态流转

SUBMITTED → IN_PROGRESS → SUCCESS
                        → FAILURE
                        → MODAL(需补充参数,见局部重绘)

响应示例

{
  "id": "task_01JWXXXX",
  "status": "SUCCESS",
  "action": "IMAGINE",
  "progress": "100%",
  "grid_image_url": "https://cdn.openveer.com/mj_xxxx.png",
  "image_urls": [
    "https://cdn.openveer.com/mj_xxxx_0.png",
    "https://cdn.openveer.com/mj_xxxx_1.png",
    "https://cdn.openveer.com/mj_xxxx_2.png",
    "https://cdn.openveer.com/mj_xxxx_3.png"
  ],
  "buttons": [
    {"customId": "MJ::JOB::upsample::1::abc123def456", "label": "U1"},
    {"customId": "MJ::JOB::variation::1::abc123def456", "label": "V1"}
  ],
  "prompt": "a beautiful sunset over mountains"
}

grid_image_url 是四宫格合成大图,image_urls 是裁剪后的 4 张单图 URL 数组。

警告

字段差异提醒

  • /v1/tasks/{task_id} 返回统一 pending / processing / completed / failed 状态。
  • /v1/midjourney/{task_id} 返回 MJ 风格字段,如 grid_image_url、image_urls、buttons。

关于 buttons: 大部分二次操作可传 index、direction 或 zoom_ratio,系统会自动匹配对应 customId;如自动匹配失败,可直接传 custom_id。

状态字段总览

status 含义 终态
NOT_START 已建行,系统未确认(瞬时态) 否
SUBMITTED 系统接受,排队中 否
IN_PROGRESS 系统处理中 否
MODAL 等待调 /modal 补参(见局部重绘) 否
SUCCESS 完成 ✓
FAILURE 失败 → 自动退款(quota 归 0,fail_reason 含原因) ✓

查询说明

  • 查询接口不单独计费,但建议合理控制频率(推荐 3–5s 轮询一次)。
  • 普通用户只能查自己的任务;查他人任务返回 403。
  • 任务默认保留 3 天,过后查询返回 404,但生成的图片 / 视频 URL 仍可访问。

高级:使用 custom_id 直接操作

读取 buttons[].customId 后,可直接传给二次操作接口的 custom_id 字段,绕过自动匹配:

{
  "task_id": "task_01JWXXXX",
  "custom_id": "MJ::JOB::upsample::1::abc123def456"
}