Skip to main content
POST
cURL
Gunakan endpoint ini saat Anda perlu mengambil sekumpulan tugas Midjourney alih-alih melakukan polling satu task id setiap kali.

Kapan menggunakannya

  • Anda melacak banyak tugas Midjourney sekaligus
  • Anda ingin memfilter berdasarkan status tugas, jendela pengiriman, atau kondisi sisi server lainnya
  • Anda memerlukan dashboard atau job rekonsiliasi alih-alih polling tugas tunggal yang interaktif

Pola kueri

1

Gunakan polling tugas tunggal untuk hot path

Untuk satu tugas aktif, gunakan Fetch Single Task, karena lebih sederhana dan lebih cepat.
2

Gunakan listing berbasis kondisi untuk pemeriksaan batch

Kirim kondisi filter Anda melalui endpoint ini saat Anda perlu memeriksa beberapa tugas Midjourney dalam satu permintaan.
3

Tindak lanjuti tugas yang menarik

Saat hasil batch menampilkan tugas yang memerlukan pemeriksaan lebih mendalam atau kelanjutan, beralih kembali ke Fetch Single Task dan Action.
Gunakan rute ini untuk job pemantauan dan rekonsiliasi; gunakan Fetch Single Task untuk jalur polling interaktif utama.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
ids
string[]
wajib

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

Respons

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.