Authentication
Inference uses a Bearer obk- key against api.openbroker.gonka.gg. The website host is not the API host.
On this page
Base URL
https://api.openbroker.gonka.gg/v1
Send JSON as Content-Type: application/json and the key as a bearer token. GET /v1/models is the exception: it is public.
The site at https://openbroker.gonka.gg is the dashboard, docs, and status page. Point SDKs at api.openbroker.gonka.gg, not at the website host.
Missing and invalid keys
| Response | When |
|---|---|
401 missing or invalid OpenBroker API key | The header is absent, or the token does not start with obk-. |
401 invalid API key | The prefix is right, but the secret does not match a live key. |
A deleted key fails the second way. A dashboard session token fails the first way.
Account gates
| Response | When |
|---|---|
402 broker is not active | The account has not reached the 100 GNK activation deposit. |
402 broker GNK reserve exhausted | available_ngonka is 0. |
503 no active OpenBroker devshard capacity for this broker | The account is active, but no gateway capacity is assigned yet. Retry after a short wait. This can happen on the first calls right after activation. |
These checks run before the request is forwarded. A 402 or 401 is not a model failure.