Status e webhooks -UlazAI

Acompanhe gerações assíncronas

A geração de imagens é assíncrona. Comece com /api/v1/generate/, então enquete /api/v1/generate/{generation_id}/ até que o trabalho chegue completed ou failed.

curl -X GET https://ulazai.com/api/v1/generate/YOUR_GENERATION_ID/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Estados do ciclo de vida

pendente

Trabalho criado e enfileirado.

processamento

A tarefa do provedor está em execução.

concluído

O URL da imagem do resultado está disponível.

falhou

Erro retornado, os créditos são reembolsados.

Exemplos de resposta de status

Processamento

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by queue",
    "prompt": "...",
    "message": "Generating your image..."
  }
}

Concluído

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "completed",
    "image_url": "https://media.ulazai.com/.../image.png",
    "prompt": "...",
    "credits_used": 8
  }
}

Fracassado

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "failed",
    "error_message": "Prompt violates content policy",
    "message": "Generation failed. Credits have been refunded."
  }
}

Retornos de chamada

Os trabalhos de endpoint unificado usam URLs de retorno de chamada assinados internamente. Retorno de chamada o manuseio é gerenciado por UlazAI e não requer configuração do lado do cliente.

Os endpoints Nano Banana herdados também expõem o processamento de webhook em:

/nano-banana/webhook/

Documentos UlazAI