~/Documentation
Documentation

Webhooks

Les webhooks permettent des notifications asynchrones lorsque vos tâches de génération sont terminées. Au lieu d'interroger l'API pour obtenir des résultats, fournissez une URL de webhook pour recevoir des requêtes POST contenant les résultats de génération.

Utilisation des Webhooks

Ajoutez le paramètre {code} à votre requête de génération. Lorsque la tâche est terminée (ou échoue), nous enverrons une requête POST à votre point de terminaison :

{
  "type": "text-to-image",
  "model": "flux-dev",
  "prompt": "A beautiful sunset over mountains",
  "webhook_url": "https://your-app.com/webhooks/renderful"
}

Charge Utile du Webhook

Votre point de terminaison reçoit une requête POST avec la charge JSON suivante :

{
  "event": "generation.completed",
  "data": {
    "id": "gen_abc123",
    "status": "completed",
    "model": "flux-dev",
    "outputs": ["https://..."],
    "created_at": "2024-01-15T10:30:00Z",
    "completed_at": "2024-01-15T10:30:15Z"
  }
}