跳轉到主要內容
GET
在每次 Midjourney submit 呼叫之後使用此端點。這是 imagine、action、modal、blend 與 editor 工作流程的主要輪詢端點。

先檢查這些欄位

  • status 用於整體任務狀態
  • progress 用於目前完成進度訊號
  • 當資產準備就緒時,查看 imageUrlvideoUrl
  • buttons 用於下一步可用的 customId

輪詢規則

  • 持續輪詢,直到任務到達 SUCCESSMODALFAILURE
  • buttons 陣列視為後續操作的唯一依據
  • 當你需要完成的九宮格圖或放大結果時,使用 imageUrl

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

路徑參數

id
string
必填

Midjourney task id.

回應

200 - application/json

Current task state.

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.

status
string
必填

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

progress
string
必填

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

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.

action
string

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

customId
string

Button customId that created this task, when the task came from an action.

botType
string

Bot that handled the task, MID_JOURNEY or NIJI_JOURNEY, when reported.

prompt
string

Original prompt as submitted.

promptEn
string

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

description
string

Human-readable submission status message.

state
string

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

submitTime
integer

Submission time as a Unix timestamp in milliseconds.

startTime
integer

Processing start time as a Unix timestamp in milliseconds.

finishTime
integer

Completion time as a Unix timestamp in milliseconds.

videoUrl
string

Generated video link for VIDEO tasks.

failReason
string

Failure reason when status is FAILURE.

maskBase64
string

Mask attached to the task when a region edit created it.

properties
object

Additional task metadata, such as finalPrompt.