Skip to main content
POST
cURL
한 번에 하나의 task id를 폴링하는 대신 Midjourney 작업을 일괄 조회해야 할 때 이 엔드포인트를 사용하세요.

사용 시점

  • 여러 Midjourney 작업을 함께 추적하고 있을 때
  • 작업 상태, 제출 시간 범위 또는 기타 서버 측 조건으로 필터링하고 싶을 때
  • 대화형 단일 작업 폴링 대신 대시보드나 정산 작업이 필요할 때

쿼리 패턴

1

핫 패스에는 단일 작업 폴링 사용

하나의 활성 작업에는 더 간단하고 빠른 Fetch Single Task를 우선 사용하세요.
2

일괄 확인에는 조건 기반 목록 조회 사용

한 번의 요청으로 여러 Midjourney 작업을 확인해야 할 때 이 엔드포인트를 통해 필터 조건을 전송하세요.
3

중요한 작업 후속 확인

일괄 결과에서 더 자세한 확인이나 후속 진행이 필요한 작업이 보이면 다시 Fetch Single TaskAction으로 전환하세요.
모니터링 및 정산 작업에는 이 경로를 사용하고, 주요 대화형 폴링 경로에는 Fetch Single Task를 사용하세요.

인증

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.