DocumentaĆ§Ć£o

Webhooks

Os webhooks permitem notificaƧƵes assĆ­ncronas quando suas tarefas de geraĆ§Ć£o sĆ£o concluĆ­das. Em vez de consultar a API para obter resultados, forneƧa uma URL de webhook para receber requisiƧƵes POST contendo os resultados da geraĆ§Ć£o.

Usando Webhooks

Adicione o parĆ¢metro {code} Ć  sua requisiĆ§Ć£o de geraĆ§Ć£o. Quando a tarefa for concluĆ­da (ou falhar), enviaremos uma requisiĆ§Ć£o POST para seu endpoint:

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

Payload do Webhook

Seu endpoint recebe uma requisiĆ§Ć£o POST com o seguinte payload 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"
  }
}