Skip to main content

Developer

The default role (USER). You request virtual keys, call the gateway from your applications, and track your own spend.

Where you work: Dashboard, Keys, Models, Usage, Request Logs, Budgets, Docs, Settings.

1. Request a key​

Go to Keys → Request Key. Pick ownership (Personal for yourself, Service account for an app — service accounts require a team), the team and application, the environment, an access group, and a budget tier or custom budget/RPM/TPM. Your team admin, org admin or a platform admin reviews it.

2. Reveal it once and store it safely​

After approval the key is Pending reveal. Open it from Keys and reveal it — the plaintext zea-… value is shown exactly once. Put it straight into your secret manager, never in code.

3. Point your SDK at the gateway​

Use any OpenAI SDK with base_url set to the gateway and your key as api_key. See SDK snippets. List models via GET /v1/models or the Models page.

4. Monitor usage and budgets​

Dashboard and Usage show spend, tokens and latency; Request Logs shows individual calls; Budgets shows remaining budget. A 429 rate_limit_error means an RPM/TPM window is exhausted; a budget error means a budget at some level ran out.

5. Rotate or revoke​

From Keys you can rotate (new plaintext, same settings) or revoke your own keys. Rotation takes effect on the gateway immediately.

Good to know​

  • You only see your own keys, usage and logs — no Management section.
  • If a request is pending too long, contact your team admin — they see it in Approvals.