Skip to main content
POST
cURL
Usa este endpoint cuando necesites recuperar un lote de tareas de Midjourney en lugar de consultar un task id a la vez.

Cuándo usarlo

  • Estás haciendo seguimiento de muchas tareas de Midjourney al mismo tiempo
  • Quieres filtrar por estado de la tarea, ventana de envío u otras condiciones del lado del servidor
  • Necesitas un panel o un trabajo de conciliación en lugar de una consulta interactiva de una sola tarea

Patrón de consulta

1

Usa la consulta de una sola tarea para rutas críticas

Para una tarea activa, prioriza Fetch Single Task, porque es más simple y rápida.
2

Usa el listado basado en condiciones para comprobaciones por lotes

Envía tus condiciones de filtro a través de este endpoint cuando necesites inspeccionar varias tareas de Midjourney en una sola solicitud.
3

Haz seguimiento de las tareas relevantes

Cuando el resultado por lotes muestre tareas que necesiten una inspección más profunda o continuación, vuelve a Fetch Single Task y Action.
Usa esta ruta para trabajos de monitoreo y conciliación; usa Fetch Single Task para la ruta principal de consulta interactiva.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
ids
string[]
requerido

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

Respuesta

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.