Skip to main content

Create a key

Dashboard → API Keys → Create key The secret is displayed once after creation and remains retrievable in the console. Treat both the console session and the secret as credentials.

What the group does

A group is a routing and pricing profile configured by the operator. Two keys on the same account can use different groups and therefore see different models and different prices.
  • Available models per group: call GET /v1/models with that key.
  • Prices per group: the pricing page.
  • If a model returns model_not_found, the model exists but not for that key’s group — this is the most common cause.

Quota on a key vs. balance on the account

They are separate limits, both enforced:
Setting Quota on a key never increases your balance. Setting it too low produces insufficient_user_quota even when the account still has credit.

Rotate and revoke

  1. Create a replacement key with the same group and limits.
  2. Deploy it to your app.
  3. Disable the old key in the console (or delete it).
Disabling is instant for new requests. Requests already streaming complete normally.

Handling keys in code

Never ship a key in a frontend bundle. For browser clients, proxy through your backend and keep the key server-side.