Skip to main content
Instead of polling, you can have BananaHub call a URL when a job finishes (done or failed).

​
Two ways to configure

Per-request

Pass callback_url in the body of a generation request. Applies to that job only.

Account-wide

Register a default webhook in the web panel. Called automatically for all jobs.
A per-request callback_url takes precedence over the account webhook for that request.

​
Per-request example

{
  "prompt": "a red panda astronaut floating in a nebula",
  "aspect_ratio": "16:9",
  "resolution": "2K",
  "callback_url": "https://example.com/webhooks/banana"
}
The webhook is called once the job reaches a terminal state, carrying the same payload shape as GET /jobs/{job_id}.