统一 AI 模型接口SuperToken
一个 Key，连接全球主流 AI 模型
统一接入 GPT、Claude、Gemini 以及图片、视频模型。兼容主流 API 格式，让开发和工具配置都从同一个入口开始。
选择适合你的接入方式
用 CC-Switch 快速接入
适合第一次配置 Claude Code、Codex 等本地工具。跟着视频完成安装、添加 SuperToken 服务商并验证连通。
- 1安装 CC-Switch
- 2添加 SuperToken 配置
- 3切换模型并测试
找到你正在使用的 AI 工具
第一次使用，按什么顺序配置？
注册并登录后，先在控制台创建 API Key，再选择账号实际可用的分组和模型；需要充值时进入钱包管理，最后按工具或 API 文档填写地址和 Key。可以从 快速入门 开始。
API Key 和 Base URL 分别填什么？
API Key 从控制台的 API Keys 页面复制，只保存完整值到密码管理器或受控配置中。Base URL 要按协议填写：Codex、Cursor 和 OpenAI 兼容客户端通常带 /v1；Claude Code、Anthropic 兼容客户端通常不带 /v1。不要填官网首页，也不要把 /chat/completions 等完整接口路径粘进去。详见 Base URL 说明。
模型名应该怎么选？
不要只按宣传名称猜模型 ID。以控制台模型广场或 GET /v1/models 返回的当前可用列表为准；Cursor 还要使用对应的 gateway-oai-* 专用别名。按任务选择性价比、强编程、推理或多媒体模型，参考 模型选择指南。
充值后怎么确认额度和费用？
充值入口在控制台的“钱包管理”。实际消耗取决于模型、输入输出用量、分组倍率，以及图片或视频的专用计费方式；不要根据单次请求自行估算长期成本。以控制台用量日志和模型广场的当前配置为准，详见 分组与计价 和 充值说明。
工具能打开，但请求没有进入 SuperToken，怎么办？
先关闭工具的 Auto、内置模型或回退选项，明确选择自定义模型；再检查 Base URL 开关和模型别名，并在控制台核对同一时间的请求记录。能对话不等于已经保存配置或走了网关，按 四关验收 验证。
遇到 401、404 或 429，先查哪里？
401 优先查 Key 和鉴权字段，404 优先查协议与 /v1 是否多写或漏写，429 查速率、并发、余额和分组额度。先用最小请求或 /v1/models 验证，再回到工具配置；完整决策表见 疑难杂症。