TokenPool Docs

Configure TokenPool by topic

Short, focused guides for API Keys, base_url values, Codex App, Codex CLI, OpenCode, and CC Switch.

View my API Key

Sign in, reveal your current TokenPool API Key, then copy it into Codex or OpenCode.

Account and Credentials

OpenAI-compatible API

Use TokenPool as an OpenAI-compatible API endpoint for supported Codex and GPT-style coding workflows.

Last updated 2026-05-12 | Maintained by TokenPool documentation team

TokenPool provides an OpenAI-compatible API gateway for supported Codex and GPT-style coding workflows. In practice, your tool uses a TokenPool API Key and a TokenPool base_url instead of calling the TokenPool website or console directly.

What OpenAI-compatible means

OpenAI-compatible means the client is configured with familiar OpenAI-style fields:

FieldWhat it doesTokenPool value
OPENAI_API_KEYPersonal credential used by your toolYour TokenPool API Key
base_urlAPI endpoint your tool callshttps://api.clawto.link or https://api.tokenpool.dev
wire formatRequest and response protocolUse the tool-specific guide
modelModel selected by the clientCheck the current TokenPool product and setup docs

This does not mean TokenPool is the OpenAI official website. It means supported tools can use TokenPool through an OpenAI-compatible configuration pattern.

Recommended endpoint

Use this endpoint first:

text
https://api.clawto.link

If your network reaches the standard TokenPool API endpoint more reliably, use:

text
https://api.tokenpool.dev

Do not use these as API endpoints:

text
https://tokenpool.dev
https://tokenpool.dev/console
https://cdn.tokenpool.dev

API key setup

Create or view your API Key in the console:

text
https://tokenpool.dev/console/api-keys

Then pass it to your tool as an OpenAI-compatible API key. For Codex App and Codex CLI, the key usually lives in:

text
~/.codex/auth.json

Example:

json
{
  "OPENAI_API_KEY": "<your TokenPool API Key>"
}

Codex configuration

For Codex CLI, configure the provider in ~/.codex/config.toml:

toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.clawto.link"
wire_api = "responses"
requires_openai_auth = true

See the Codex CLI guide and Codex App guide for the complete setup.

Common mistakes

  • Using https://tokenpool.dev as the API base_url.
  • Putting the API key in config.toml instead of auth.json.
  • Copying an incomplete key.
  • Using a model name that is not available in the current product flow.
  • Testing with an account that has no available quota.
  • Committing auth.json or secrets to Git.

FAQ

Is TokenPool an OpenAI-compatible API?

Yes. TokenPool is designed to work as an OpenAI-compatible API gateway for supported Codex and GPT-style workloads.

Is TokenPool the OpenAI official API?

No. TokenPool is not the OpenAI official website and does not claim official reseller status. Use the direct official API when you need provider-only features or direct provider billing.

Which endpoint should I use?

Start with https://api.clawto.link. If your network is more stable with the standard endpoint, use https://api.tokenpool.dev.

Where do I go next?

Read API Key, base_url and Endpoint Choice, Codex CLI, or Troubleshooting.