FAQ
Common issues and triage paths for AI app integrations
A single page collecting the common questions from the four integration guides. Jump by section; if something's missing, reach out from the console.
General
401 / 403 unauthorized
Confirm the API key is copied in full and hasn't been revoked in the console; the Authorization header should read Bearer sk-tb-… (or x-api-key: sk-tb-…). Double-check the base URL suffix — OpenAI-compatible needs /v1, Anthropic-compatible does not.
Which base URL?
| Protocol | Base URL |
|---|---|
| OpenAI-compat | https://api.tempools.com |
| Anthropic-compat | https://api.tempools.com |
What do I put in the model field?
Open the Models page or the Console → Models catalog. The title on each model card is the exact value you put in the API model field. Tempools passes the upstream name through as-is, so the card title is the model name, with no secondary mapping.
Usage stats aren't showing up?
Metrics take ~1 minute to settle. If they're still missing, make sure the traffic actually hit api.tempools.com — some tools fall back to the upstream default endpoint silently.
Claude Code
Model selection? Tempools forwards Claude Code's model requests to upstream Anthropic as-is. To route to non-Claude models, configure mapping rules in the console.
Rate limited?
Claude Code issues a lot of parallel requests (multiple tools + background summarization). Raise the key's RPM / TPM, and keep CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC set so only essential calls go through.
Which env var?
Claude Code reads ANTHROPIC_AUTH_TOKEN (not ANTHROPIC_API_KEY). Tempools keys still start with sk-tb-.
Codex CLI
Windows setx didn't take effect?
setx only affects newly spawned terminals. Close and reopen the window — VS Code's integrated terminal too.
Which model should I use?
Pick the model that fits your Codex CLI workflow from the Models page or the Console → Models catalog, then paste that card title into the model field of ~/.codex/config.toml.
.codex folder not visible?
Explorer hides dot-directories by default. Enable View → Show → Hidden items, or run mkdir .codex.
What does env_key do?
It tells config.toml which environment variable holds the API key. The value of env_key must match the system variable name exactly — e.g. both set to TEMPOOLS_API_KEY.
Kilo Code
Model list is short? Under OpenAI Compatible, model names are typed by hand. Copy the exact card title from the Models page or the Console → Models catalog.
Homepage doesn't load?
The brand moved from kilocode.ai to kilo.ai. The old domain 308-redirects, but update your bookmarks.
Can Kilo's Anthropic entry take a custom base URL? No — that entry hits Anthropic directly, with no override. Route Claude through Tempools via OpenAI Compatible instead.
Cline
The Base URL field disappeared? API Provider must be set to OpenAI Compatible — the Base URL field only appears there. Cline's built-in "Cline" quick-login is a managed mode and doesn't allow custom endpoints.
Context overflow? Long tasks hit model context limits. Prefer models with stronger long-context support from the Models page or the Console → Models catalog, and let Cline compact state via Focus Chain or Memory Bank.
How do I cap Auto-approve spend? Set a per-request cap and RPM/TPM on the key itself in the console. During testing, keep Auto-approve off.
Can Plan and Act use different models? Yes — toggle Use different models for Plan and Act in Settings. Use a reasoning-oriented model for Plan and a faster coding-oriented model for Act; in both cases, use the exact card title from the Models page or the Console → Models catalog.