~/Documentation
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"
  }
}