Skip to main content
POST
cURL
当你需要批量检索 Midjourney 任务,而不是一次轮询一个 task id 时,请使用此端点。

何时使用

  • 你正在同时跟踪多个 Midjourney 任务
  • 你希望按任务状态、提交时间窗口或其他服务端条件进行筛选
  • 你需要的是仪表板或对账任务,而不是交互式的单任务轮询

查询模式

1

对关键路径使用单任务轮询

对于一个活跃任务,优先使用 获取单个任务,因为它更简单也更快。
2

对批量检查使用基于条件的列表查询

当你需要在一次请求中检查多个 Midjourney 任务时,通过此端点发送你的筛选条件。
3

继续跟进值得关注的任务

当批量结果显示某些任务需要更深入的检查或继续处理时,切换回 获取单个任务Action
将此路由用于监控和对账任务;主要的交互式轮询路径请使用 获取单个任务

授权

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json
ids
string[]
必填

Array of Midjourney task ids to retrieve. Returns the current status and result for each.

响应

200 - application/json

Success

action
string

Task type: IMAGINE, UPSCALE, VARIATION, DESCRIBE, BLEND, VIDEO, or another action name.

buttons
object[]

Action buttons available on the finished task. Send a button's customId together with this task's id to /mj/submit/action to upscale, vary, zoom, or pan.

description
string

Human-readable submission status message.

failReason
string

Failure reason when status is FAILURE.

finishTime
integer

Completion time as a Unix timestamp in milliseconds.

id
string

Task id.

imageUrl
string

Stable CometAPI-proxied image link (https://api.cometapi.com/mj/image/{id}). Prefer this link; entries in image_urls point at provider storage and can expire.

progress
string

Progress percentage string such as 58% while the task runs and 100% when finished.

prompt
string

Original prompt as submitted.

promptEn
string

Prompt after translation to the provider language. For DESCRIBE tasks, the extracted prompt suggestions arrive here.

properties
object

Additional task metadata, such as finalPrompt.

startTime
integer

Processing start time as a Unix timestamp in milliseconds.

state
string

Custom state string echoed back from the submission for your own tracking.

status
string

Task lifecycle state: NOT_START, SUBMITTED, IN_PROGRESS, SUCCESS, or FAILURE.

submitTime
integer

Submission time as a Unix timestamp in milliseconds.