Skip to main content
GET
推荐业务侧轮询统一任务接口:
统一任务状态为 pending / processing / completed / failed,成功结果位于 result.images[].url 需要读取 buttons[].customId 做二次操作时,使用 MJ 风格查询:

任务状态流转

响应示例

grid_image_url 是四宫格合成大图,image_urls 是裁剪后的 4 张单图 URL 数组。
字段差异提醒
  • /v1/tasks/{task_id} 返回统一 pending / processing / completed / failed 状态。
  • /v1/midjourney/{task_id} 返回 MJ 风格字段,如 grid_image_urlimage_urlsbuttons
关于 buttons 大部分二次操作可传 indexdirectionzoom_ratio,系统会自动匹配对应 customId;如自动匹配失败,可直接传 custom_id

状态字段总览

查询说明

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

高级:使用 custom_id 直接操作

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