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
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.
Where does the API key go?
Codex reads OPENAI_API_KEY from ~/.codex/auth.json. Use the full key from the console (including the sk- prefix). Restart codex after editing.
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.