Skip to main content
POST
cURL
Use este endpoint quando você precisar recuperar um lote de tarefas do Midjourney em vez de consultar um task id por vez.

Quando usar

  • Você está acompanhando várias tarefas do Midjourney em conjunto
  • Você quer filtrar por estado da tarefa, janela de envio ou outras condições no lado do servidor
  • Você precisa de um dashboard ou job de reconciliação em vez de uma consulta interativa de tarefa única

Padrão de consulta

1

Use single-task polling for hot paths

Para uma tarefa ativa, prefira Fetch Single Task, porque é mais simples e mais rápido.
2

Use condition-based listing for batch checks

Envie suas condições de filtro por este endpoint quando precisar inspecionar várias tarefas do Midjourney em uma única solicitação.
3

Follow up on interesting tasks

Quando o resultado em lote mostrar tarefas que precisam de uma inspeção mais profunda ou continuação, volte para Fetch Single Task e Action.
Use esta rota para jobs de monitoramento e reconciliação; use Fetch Single Task para o principal fluxo interativo de polling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
ids
string[]
obrigatório

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

Resposta

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.