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