Docs · Getting started

Create an API key and choose a route

2026-10-29

The key drawer step by step, what each route means, and the three 403 refusals a key can hit.

Open API keys in the sidebar and click Create API key.

The form

1. Name: any label; the placeholder suggests production-backend.
2. Group: the route the key is billed on. Nothing is preselected; saving without one fails with Choose a group. An N models button on each row expands its price table (USD per 1M tokens, USD per image or USD per second), with a Long context row where that tier exists.
3. Quota: Unlimited quota on, or off with a Quota (USD) after which the key stops.
4. Expiry: an Expiration time, or a preset: Never, 1 Hour, 1 Day, 1 Month.
5. Quantity (creating only): up to 50 keys; the first keeps the name you typed, the rest get a random suffix.
6. Advanced settings, collapsed by default: Model limits and IP Whitelist (supports CIDR), both empty.

Click Save changes. The key starts with sk-.

The routes

Auto route is listed first and covers the whole catalogue with one key. Each request goes to the lowest-priced line that can serve its model right now, normally the shared pool; when the pool cannot, it goes to the official line at its higher price, so the billed route can differ per request. The usage log shows that route under Group.

• Claude, OpenAI and Grok: a Shared pool (claude-shared, openai-shared, grok-shared) at 50% of list and an Official line (claude-official, openai-official, grok-official) at 90%. A text model is sold only on its own vendor's two routes. Grok's official line is also the only route for grok-imagine-video-1.5, per second.
• Claude Special offer (claude-special, marked Opus 5.5 only · limited time · often unavailable): a temporary line for claude-opus-5-5 only, at $0.45 input / $0.90 output / $0.10 cache read / $0.20 cache write ($0.30 for a 1-hour write) per million tokens. It is often unavailable for long stretches with no availability guarantee, adds its own system prompt to every request, has no fallback and is never chosen by Auto route; selecting it shows its terms under the list. See Claude Opus 5.5 special offer.
• OpenAI Image generation (image): the only route for gpt-image-2.5-sunburst and gpt-image-2.5-flare, per image by size.
• GLM Private deployment (z-official): GLM-5.3-Abliterated, a fine-tuned GLM 5.3 on a private deployment, text only, above list.
• DeepSeek: deepseek-official carries deepseek-flash-Abliterated, a private deployment with fixed $1.20 input / $0.15 cache read / $2.40 output per million tokens. The route id is retained for keys; Flash is not the official DeepSeek API.
• Kimi Official line (kimi-official): kimi-k3.1-pro at 120% of list.
• TypeSafe Official line (typesafe-official, marked Official key · 107% of list price): jev-1.14.0. Its Full API key popover adds One-command setup for Jev.

Claude, OpenAI and Grok official-line requests fall back to the shared pool when no dedicated line is configured; for a dedicated official-price line, write to support@topxea.com.

Three refusals

Three checks run before a provider is reached; each fails with HTTP 403:

• Model is not offered by this service: the model id is not in the catalogue.
• Model is not available on this API key route: the model is not on this key's route, such as a GPT model on a Claude key.
• This token has no access to model <name>: the key's Model limits exclude it. Pick them under Select models (empty allows all); jev-latest and jev-preview count as jev-1.14.0 here.

IP Whitelist takes one IP or CIDR block per line; addresses can be spoofed, so pair it with a gateway such as nginx or a CDN.

Related

• Shared pool, official line and auto route
• Connect your SDK
• Top up with a card
• Reading your usage log

Previous: What TopxAI is · Next: Connect your SDK

Other languages: 简体中文