快速接入 Agent
接入总览
- 客户侧只需要确认账号已开通、API Key 可用、Base URL 填对、模型名使用平台公开名称。
- 普通 OpenAI Compatible 客户端统一使用 https://www.zltokens.com/v1，认证使用 Authorization: Bearer <API Key>。
- Claude Code 走 Anthropic/Claude 兼容协议时，Base URL 使用 https://www.zltokens.com，由客户端访问 https://www.zltokens.com/v1/messages。
- Gemini CLI 只有在当前版本支持自定义 Gemini API 地址，且平台提供 Gemini 兼容入口时才建议直连；否则改用 OpenAI Compatible 客户端。
- 所有客户端首次接入都先发低成本短请求，再到使用日志核对 request_id、模型名、渠道、token 和扣费。
配置步骤
- 获取服务开通信息：API Key、Base URL、可用公开模型名和适配客户端说明。
- 按客户端类型选择正确协议，不混用 OpenAI、Anthropic 和 Gemini 三类字段。
- 保存配置后先发送一条短请求，避免一上来就跑长上下文或生产流量。
- 首次请求成功后，用使用日志确认状态码、token、扣费和错误信息。
API 地址
| 客户端 | 协议 | 地址 |
|---|---|---|
| Codex 客户端 / Codex CLI | OpenAI Compatible | https://www.zltokens.com/v1 |
| VSCode + Cline | OpenAI Compatible | https://www.zltokens.com/v1 |
| Cherry Studio | OpenAI Compatible / 自定义 Provider | https://www.zltokens.com/v1；如果客户端会自动拼 /v1，则填 https://www.zltokens.com |
| Claude Code | Anthropic Compatible | https://www.zltokens.com |
| Gemini CLI | 仅在支持自定义 Gemini API 地址时使用 Gemini Compatible | https://www.zltokens.com 或客户端要求的 Gemini base URL |
常见问题
- Base URL 应该填什么？
普通 OpenAI Compatible 客户端填 https://www.zltokens.com/v1。只有工具明确要求完整接口地址时，聊天接口才填 https://www.zltokens.com/v1/chat/completions。
- API Key 从哪里来？
服务开通后由平台提供，或在控制台的 API Key 页面创建。API Key 列表会脱敏显示；登录后的所有者可在 API Key 页面按需查看完整 Key。仍应妥善保存，泄露后请立即轮换。
- 模型名填平台名还是上游名？
填平台公开模型名。管理员做过模型重命名时，客户也必须使用重命名后的公开名称。
- 模型列表为空怎么办？
先检查是否已登录、Key 是否可用、模型是否启用、渠道是否映射、模型是否已定价，以及账号或 Key 是否被限制。