Skip to main content
GET
Endpoint de polling recomendado:
Os status unificados são pending / processing / completed / failed; os resultados estão em result.images[].url. Use o endpoint estilo MJ quando precisar de buttons[].customId para ações de acompanhamento:

Fluxo de status

Exemplo de response

grid_image_url é a imagem grid 2x2; image_urls são as quatro URLs de imagens individuais recortadas.
Diferenças de campos
  • /v1/tasks/{task_id} retorna status unificados pending / processing / completed / failed.
  • /v1/midjourney/{task_id} retorna campos estilo MJ como grid_image_url, image_urls, buttons.
Sobre buttons: Para a maioria das ações de acompanhamento, passe index, direction ou zoom_ratio e o serviço encontra o customId correspondente. Se o auto-matching falhar, passe custom_id diretamente.

Resumo de status

Notas de consulta

  • O endpoint de consulta não é cobrado separadamente, mas mantenha uma frequência razoável (polling de 3–5s recomendado).
  • Um usuário comum só pode consultar suas próprias tarefas; consultar as de outros retorna 403.
  • As tarefas são retidas por 3 dias por padrão; depois, consultas retornam 404, mas as URLs de imagem / vídeo geradas continuam acessíveis.

Avançado: usar custom_id diretamente

Após ler buttons[].customId, você pode passá-lo diretamente no campo custom_id dos endpoints de ação de acompanhamento, ignorando o auto-matching: