Create an API Key

Gonka Broker supports two types of API keys. Choose based on your use case.

Managed keys

A managed key routes your requests through Gonka Broker’s proxy, which converts them into a fully OpenAI-compatible format. This is the simplest option — use it when you want to:

• Drop Gonka into existing OpenAI-based code
• Use third-party tools like LangChain, LlamaIndex, Cursor, or Continue
• Get OpenAI-compatible responses without any custom integration

To create a managed key:

1. Sign in to app.gonkabroker.com
2. Go to the Managed Keys tab
3. Click Create Key
4. Enter a name for the key
5. Click Create
6. Copy your secret key immediately — it is shown only once

Your managed key starts with gk-prx- and works anywhere an OpenAI API key is accepted.

Direct keys

A direct key connects your application directly to the Gonka GPU network using the Gonka SDK. Inference traffic goes peer-to-peer and never passes through Gonka Broker — we only handle billing and balance management.

Use direct keys when you are building your own product and want:

• Lower latency (no proxy hop)
• Maximum privacy (prompts never touch our servers)
• Full control over the SDK integration

To create a direct key:

1. Sign in to app.gonkabroker.com
2. Go to the Direct Keys tab
3. Click Create Key
4. Enter a name for the key
5. Click Create
6. Copy your secret key immediately — it is shown only once

Managing your keys

Pause and resume

You can temporarily pause a key to stop it from generating charges. Go to the key’s menu and select Pause. Resume it at any time to re-enable usage.

Rotate a managed key

If a managed key is compromised, you can rotate it. This generates a new secret and immediately invalidates the old one. Go to the key’s menu and select Rotate Key.

Direct keys cannot be rotated — archive the compromised key and create a new one.

Archive

Archiving permanently disables a key. This action cannot be undone. Use it for keys you no longer need.

Key limits

There is a maximum number of API keys you can create per account. Check the Limits & Quotas page for current values.

Caution

Your secret key is shown only once at creation. If you lose it, you’ll need to create a new key (or rotate, for managed keys).