Tempools logoTempools Docs

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?

ProtocolBase URL
OpenAI-compathttps://api.tempools.com
Anthropic-compathttps://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.

On this page