Webhooks

Receive real-time notifications for generation events.

Webhook Events

Pass a webhook_url when generating a video or image. We'll POST to that URL when generation completes or fails.

Events

video.completed

Video generation finished successfully

video.failed

Video generation failed (credits refunded)

image.completed

Image generation finished

image.failed

Image generation failed

Payload Format

{
  "event": "video.completed",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "video_url": "https://..."
  }
}

Delivery

Webhooks are delivered with up to 3 retries using exponential backoff (1s, 2s, 4s)
Your endpoint must respond with a 2xx status code
Delivery is best-effort — always implement polling as a fallback
Webhook requests have a 10-second timeout