Skip to Content
快速开始接入客户端

接入客户端

推荐做法:用 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。

排错顺序

按这个顺序看,能覆盖绝大多数接入问题:

  1. 401 — 密钥没带、带错、或被停用。检查请求头是不是 Authorization: Bearer sk-...。
  2. 402 — 余额不足。个人密钥看个人余额;企业共享密钥看企业余额。
  3. 403 — 通常是成员额度用尽,或请求的模型分组不在企业允许范围内。
  4. 429 — 触发限流。网关有全局限流。
  5. 404 / 模型不存在 — 模型名不在当前可用范围内,回模型与价格 核对。

上面对应的详细说明见常见问题。

逐个客户端的配置步骤

待补充:主流客户端(终端类 CLI、编辑器插件、桌面客户端)逐个的图文配置步骤。首版只给出通用协议与通用 SDK 的接入方式。

终端类 CLI 工具这一步可以直接绕过去:用 cc-switch 就能把 AllTokens 写进 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 等工具,不用手改每个配置文件。编辑器插件与桌面客户端仍按各自的官方方式填 Base URL 与 Key。