Statut et webhooks

Suivre les générations asynchrones

La génération d'images est asynchrone. Commencez par /api/v1/generate/, puis sondage /api/v1/generate/{generation_id}/ jusqu'à ce que le travail atteigne completed ou failed.

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

États du cycle de vie

en attente

Travail créé et mis en file d'attente.

traitement

La tâche du fournisseur est en cours d'exécution.

terminé

L’URL de l’image du résultat est disponible.

échoué

Erreur renvoyée, les crédits sont remboursés.

Exemples de réponses d'état

Traitement

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

Complété

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

Échoué

{
  "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."
  }
}

Rappels

Les tâches de point de terminaison unifié utilisent des URL de rappel signées en interne. Rappel la gestion est gérée par UlazAI et ne nécessite pas de configuration côté client.

Les anciens points de terminaison Nano Banana exposent également le traitement des webhooks à l'adresse suivante :

/nano-banana/webhook/

Documents UlazAI