Quick Agent Access
Access overview
- Customer setup requires four checks: activated account, usable API Key, correct Base URL, and public platform model name.
- OpenAI-compatible clients use https://www.zltokens.com/v1 with Authorization: Bearer <API Key>.
- Claude Code using the Anthropic-compatible protocol uses https://www.zltokens.com; the client calls https://www.zltokens.com/v1/messages.
- Gemini CLI should connect directly only when the tool supports a custom Gemini API base and the platform provides a Gemini-compatible endpoint.
- Always start with a low-cost short request, then verify request_id, model, channel, tokens, and deduction in usage logs.
Steps
- Get activation details: API Key, Base URL, public model names, and client-specific notes.
- Choose the correct protocol for the client; do not mix OpenAI, Anthropic, and Gemini fields.
- Save the client configuration and send one short request before running long contexts or production traffic.
- After the first success, verify status code, tokens, deduction, and errors in usage logs.
API base
| Client | Protocol | Address |
|---|---|---|
| Codex client / Codex CLI | OpenAI Compatible | https://www.zltokens.com/v1 |
| VSCode + Cline | OpenAI Compatible | https://www.zltokens.com/v1 |
| Cherry Studio | OpenAI Compatible / custom Provider | https://www.zltokens.com/v1; use https://www.zltokens.com if the client appends /v1 automatically |
| Claude Code | Anthropic Compatible | https://www.zltokens.com |
| Gemini CLI | Gemini Compatible only when custom Gemini API base is supported | https://www.zltokens.com or the Gemini base URL required by the client |
FAQ
- Which Base URL should I use?
OpenAI-compatible clients use https://www.zltokens.com/v1. Only use https://www.zltokens.com/v1/chat/completions when the tool explicitly asks for the full chat endpoint.
- Where do I get the API Key?
It is provided after service activation or created in the API Key page. API Key lists are masked. A signed-in owner can retrieve the full Key from the API Key page when needed; keep it secure and rotate it immediately if exposed.
- Should I use platform model names or upstream names?
Use public platform model names. If an administrator renamed a model, clients must use the renamed public name.
- Why is the model list empty?
Check login, Key status, model enablement, channel mapping, model pricing, and account or Key limits.