Documentaci贸n

Webhooks

Los webhooks permiten notificaciones as铆ncronas cuando tus tareas de generaci贸n se completan. En lugar de consultar la API para obtener resultados, proporciona una URL de webhook para recibir solicitudes POST que contienen los resultados de la generaci贸n.

Usando Webhooks

Agrega el par谩metro {code} a tu solicitud de generaci贸n. Cuando la tarea se complete (o falle), enviaremos una solicitud POST a tu endpoint:

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

Carga 脷til del Webhook

Tu endpoint recibe una solicitud POST con la siguiente carga 煤til JSON:

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