接入客户端
推荐做法:用 cc-switch 统一管。 如果你同时用好几个 AI 工具,不要一个个手改配置文件——cc-switch 是一个桌面应用,把 AllTokens 添加一次,10 个工具共用一份供应商配置,还能在托盘里一键切换、自动故障转移。它是我们合作伙伴的产品,也是我们最推荐的接入方式(安装 · 配置 AllTokens)。
两个值填完就能用
任何支持自定义 Base URL 的 OpenAI 兼容客户端,只需要两个值:
| 填什么 | 值 |
|---|---|
| Base URL(接口地址) | https://alltokens.si/v1 |
| API Key | 你的个人密钥,或管理员发给你的企业共享密钥 |
模型名以平台实际提供为准。 本文档不列举模型名——不同渠道、不同分组能用的模型不同,且随时会变。请先在模型与价格 页面确认,再把本文示例里的模型名替换掉。
curl
export ALLTOKENS_API_KEY='sk-...'
curl https://alltokens.si/v1/chat/completions \
-H "Authorization: Bearer $ALLTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "把这里换成平台实际提供的模型名",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'流式响应把 stream 改成 true 即可,接口是标准 SSE,网关侧没有额外缓冲。
OpenAI Python SDK
官方的 openai 包可以直接指向本站,因为接口是 OpenAI 兼容的:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ALLTOKENS_API_KEY"],
base_url="https://alltokens.si/v1",
)
resp = client.chat.completions.create(
model="把这里换成平台实际提供的模型名",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)也可以只用环境变量,不改代码:
export OPENAI_API_KEY='sk-...'
export OPENAI_BASE_URL='https://alltokens.si/v1'OpenAI Node SDK
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.ALLTOKENS_API_KEY,
baseURL: 'https://alltokens.si/v1'
})
const resp = await client.chat.completions.create({
model: '把这里换成平台实际提供的模型名',
messages: [{ role: 'user', content: '你好' }]
})
console.log(resp.choices[0].message.content)Anthropic 兼容的客户端
部分客户端(如 Claude Code 一类工具)走的是 Anthropic 协议而不是 OpenAI 协议的路径,它们的「Base URL」要填不带 /v1 的站点地址:
https://alltokens.si具体某个客户端该填哪一种,取决于它用的是哪套协议。判断方法很简单:如果客户端让你填的是「OpenAI Base URL」或「OpenAI API 地址」,用 https://alltokens.si/v1;如果它问的是「Anthropic API 地址」,用 https://alltokens.si。
排错顺序
按这个顺序看,能覆盖绝大多数接入问题:
- 401 — 密钥没带、带错、或被停用。检查请求头是不是
Authorization: Bearer sk-...。 - 402 — 余额不足。个人密钥看个人余额;企业共享密钥看企业余额。
- 403 — 通常是成员额度用尽,或请求的模型分组不在企业允许范围内。
- 429 — 触发限流。网关有全局限流。
- 404 / 模型不存在 — 模型名不在当前可用范围内,回模型与价格 核对。
上面对应的详细说明见常见问题。
逐个客户端的配置步骤
待补充:主流客户端(终端类 CLI、编辑器插件、桌面客户端)逐个的图文配置步骤。首版只给出通用协议与通用 SDK 的接入方式。
终端类 CLI 工具这一步可以直接绕过去:用 cc-switch 就能把 AllTokens 写进 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 等工具,不用手改每个配置文件。编辑器插件与桌面客户端仍按各自的官方方式填 Base URL 与 Key。