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

base_url and Endpoint Choice

Use the correct API endpoint. The website homepage is not the API base URL.

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

base_url is the OpenAI-compatible API endpoint your coding tool calls. It is not the TokenPool homepage, not the console URL, and not a CDN URL.

Recommended endpoint

text
https://api.clawto.link

This is the recommended endpoint, optimized for access from China.

Standard endpoint

text
https://api.tokenpool.dev

Use this if it is more stable from your network.

Do not use these

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

Those are not API endpoints.

Final request URL

Most tools only ask for base_url and append paths automatically. For example, the Responses API becomes:

text
https://api.clawto.link/v1/responses

Screenshot placeholder: endpoint selection.

Codex App and Codex CLI

For Codex App and Codex CLI, put the endpoint in ~/.codex/config.toml:

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

Your API Key goes in ~/.codex/auth.json, not in this endpoint field.

Troubleshooting endpoint errors

If the request fails, check these first:

  1. The value starts with https://.
  2. The value is exactly an API endpoint, not https://tokenpool.dev.
  3. Your tool appends /v1/... automatically.
  4. Your account has available quota.
  5. Your network can reach the endpoint.

FAQ

What is the TokenPool OpenAI-compatible API endpoint?

The recommended endpoint is https://api.clawto.link. The standard endpoint is https://api.tokenpool.dev.

Should I include /v1 in base_url?

Most supported tools only need the base endpoint and append /v1/... automatically. Follow the specific tool guide if it asks for a full URL.

Can I use the website URL as base_url?

No. https://tokenpool.dev is the website, not the API endpoint.