Skip to main content
POST
cURL
當你需要一次擷取一批 Midjourney 任務,而不是每次輪詢一個 task id 時,請使用這個端點。

何時使用

  • 你正在同時追蹤多個 Midjourney 任務
  • 你想依照任務狀態、提交時間範圍或其他伺服器端條件進行篩選
  • 你需要的是儀表板或對帳工作,而不是互動式的單一任務輪詢

查詢模式

1

針對高頻路徑使用單一任務輪詢

對於單一進行中的任務,建議優先使用 擷取單一任務,因為這樣更簡單也更快。
2

針對批次檢查使用條件式列表

當你需要在一次請求中檢視多個 Midjourney 任務時,請透過此端點傳送你的篩選條件。
3

後續追蹤值得關注的任務

當批次結果顯示有些任務需要更深入檢查或繼續處理時,請切回使用 擷取單一任務操作
將此路由用於監控與對帳工作;主要的互動式輪詢路徑請使用 擷取單一任務

授權

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.