Skip to main content
GET
Endpoint de sondeo recomendado:
Los estados unificados son pending / processing / completed / failed; los resultados aparecen en result.images[].url. Use el endpoint estilo MJ cuando necesite buttons[].customId para acciones posteriores:

Flujo de estado

Ejemplo de respuesta

grid_image_url es la imagen 2x2; image_urls son las cuatro URLs de imágenes individuales recortadas.
Diferencias de campos
  • /v1/tasks/{task_id} devuelve estados unificados pending / processing / completed / failed.
  • /v1/midjourney/{task_id} devuelve campos estilo MJ como grid_image_url, image_urls, buttons.
Sobre buttons: Para la mayoría de las acciones, pase index, direction o zoom_ratio y el servicio encuentra el customId correspondiente. Si el auto-matching falla, pase custom_id directamente.

Resumen de estados

Notas de consulta

  • El endpoint de consulta no se factura por separado, pero mantenga una frecuencia razonable (sondeo de 3–5s recomendado).
  • Un usuario normal solo puede consultar sus propias tareas; consultar las de otros devuelve 403.
  • Las tareas se conservan 3 días por defecto; después, las consultas devuelven 404, pero las URLs de imagen / video generadas siguen accesibles.

Avanzado: usar custom_id directamente

Tras leer buttons[].customId, puede pasarlo directamente al campo custom_id de las acciones posteriores, evitando el auto-matching: