Documentation
How to open an account, call the inference API, read a bill, and tell a capacity rejection apart from an outage.
No enrollment or allowlist application. Create an account, deposit at least 100 GNK, and use the obk- key from the dashboard.
What OpenBroker is, and the path from an account to a working key.
A broker API for Gonka inference. OpenBroker runs the escrow wallet, devshard capacity, and GNK accounting so you can call an OpenAI-compatible endpoint.
Create an account, deposit at least 100 GNK, create an obk- key, and send one chat completion.
Registration, email verification, activation, sign-in, and password reset.
obk- keys authenticate inference, balance, and usage. The secret is shown once.
Send native GNK on Gonka mainnet to the deposit address. 100 GNK activates the account. Later payments use the same address.
OpenAI-compatible chat, streaming, models, and the errors you will actually see.
Inference uses a Bearer obk- key against api.openbroker.gonka.gg. The website host is not the API host.
POST /v1/chat/completions accepts an OpenAI-style JSON body and forwards it to the devshard gateway.
stream:true returns server-sent events. The first byte can take longer than a typical HTTP header timeout.
POST /v1/completions takes a single string prompt and is served as a chat completion.
The live catalog is GET /v1/models. Use the full id. Kimi-K2.6 is deprecated.
Chat, legacy completions, models, balance, and usage are served. Embeddings, images, assistants, and batches are not.
What 401, 402, 429, and 502 mean on OpenBroker, and what to change in the client.
Retry 429, 502, and 503 with backoff. Change the key, the balance, or the JSON before you retry 401, 402, or 400.
How GNK is priced, reserved, and reported.
Live DevShard escrows are 10 ngonka per token per attempt. The old governance endpoint still says 1. OpenBroker adds no markup.
GET /v1/balance returns the ledger, the reserve, and the amount a new request can spend. Amounts are ngonka.
List requests, summarize a date range, or look up one completion by its response id.
Dashboard, the public status page, and global stats.
Balance, keys, the deposit address, reserved escrows, the usage report, recent requests, and the GNK ledger.
How to read the public status page: what the red percentage counts, and what it leaves out.
Use your own recent calls and the public status snapshot to decide whether to lower or raise concurrency.
A public view of active brokers and aggregate usage by model. Pending accounts are hidden.
Client setup, glossary, and short answers.
Point any OpenAI SDK or app at https://api.openbroker.gonka.gg/v1 with an obk- key and a full model id.
Set a custom OpenAI base URL, an obk- key, a full model id, and a timeout of several minutes.
Broker, escrow, devshard, ngonka, epoch, and the other words used in the dashboard and the API.
Short answers for the questions that usually follow the first failed request or the first bill.
No enrollment, no application, no waiting. Create an account and get your API key in minutes.