Skip to main content
Every request requires a bearer API key, passed in the Authorization header:
Requests without a valid, active key return 401 Unauthorized.
Create and manage API keys in the web panel at bananahub.io. Keys can be scoped to specific models — a key without permission for the requested model returns 403.

​
Idempotency

All generation endpoints accept an optional Idempotency-Key header. Replaying the same key returns the original job_id without creating a duplicate job or charging again.
Use a fresh UUID per logical request and retry with the same key on network failures — this makes job creation safe to retry.
Example