官方订阅只能在官方的入口里用。可很多好用的工具——桌面聊天客户端、编程工具、你自己写的小脚本——都支持"自己填 API"。这一讲讲清楚 API 是怎么回事,再手把手把模型接进 Cherry Studio、Claude Code 和 Codex。学会一次,以后看到任何"填写 API"的地方都不慌。
- 接口地址
- API 密钥
- 模型名
不管什么工具,都是填这三样
- 兑换额度
- 建密钥
- 填进工具
- 小请求测试
- 看用量
按这个顺序走
- 能填进工具|绝对不能填
- API 密钥
- 接口地址
- 模型名
- ChatGPT 登录密码
- Claude 账号密码
账号密码永远不是密钥
- 密钥就是钱包钥匙
三件套
不管什么工具,接模型永远是填这三样:
接口地址(Base URL)+ API 密钥(Key)+ 模型名。地址告诉它去哪儿,密钥证明你是谁,模型名说明要哪个大脑。
另外还要分清一件事:接口格式。主流有两种——OpenAI 格式和 Anthropic(Claude)格式。工具让你选"提供商类型"时,选对格式,地址也要配套填。
以本站中转站为例:
| 要填的 | 在哪儿拿 |
|---|---|
| 额度 | 商城买 模型额度卡,在中转站控制台「兑换」 |
| API 密钥 | 控制台左侧「API 密钥」,新建一个 |
| 接口地址 | 以「API 密钥」页面显示的为准。Anthropic 格式一般填 https://api.fxisv.com,OpenAI 格式一般填 https://api.fxisv.com/v1 |
| 模型名 | 控制台里能看到可用的模型;工具里通常也能"获取模型列表" |
中转站的入口在网站顶部导航的「模型」,已登录商城会直接进入控制台。
接进你的工具
- Cherry Studio
最适合新手的桌面聊天客户端。
- 打开设置,进入「模型服务」,点「添加服务商」。
- 起个名字,提供商类型选 OpenAI(或 Anthropic),填 API 密钥和接口地址。
- 保存后打开右上角的开关启用。
- 点「获取模型列表」,或者手动添加模型名。
- 点「检查」测一下,然后回到对话页选这个服务商和模型。
- Claude Code
用环境变量指向中转站。启动前在终端设置:
export ANTHROPIC_BASE_URL=https://api.fxisv.com export ANTHROPIC_AUTH_TOKEN=你的密钥 claude想长期生效,可以写进
~/.claude/settings.json的env里。频繁切换不同账号和服务商的,可以用 CC Switch 这类切换工具。- Codex
在
~/.codex/config.toml里加一个服务商:model_provider = "fxisv" [model_providers.fxisv] name = "fxisv" base_url = "https://api.fxisv.com/v1" env_key = "FXISV_API_KEY" wire_api = "responses"然后在终端里
export FXISV_API_KEY=你的密钥再启动codex。- 自己的脚本
用官方 SDK,改一下地址就行。OpenAI 的 SDK 设置
base_url,Anthropic 的 SDK 设置base_url,密钥从环境变量读。不会写?把这一讲丢给 Claude Code,让它帮你写。
先跑一次小请求
配完别急着跑大任务,先发一句最短的话确认通了。在终端里也能直接测:
# 把密钥放进环境变量,别直接写在命令里 $ export FXISV_API_KEY=你的密钥 # 列出可用模型:能返回一串模型名,说明地址和密钥都对 $ curl https://api.fxisv.com/v1/models -H "Authorization: Bearer $FXISV_API_KEY" ✓ 返回了模型列表 # 如果返回 401:密钥不对;404:地址多写或少写了 /v1
测通以后,回控制台看一眼"用量记录",确认扣费正常,再放开用。
你在工具里填好了中转站,一发消息就报"401 Invalid API key"。最先该检查什么?
- 换一个模型名试试
- 密钥是不是复制完整了、有没有多复制空格,是不是填成了别的平台的密钥
- 重装工具
- 把接口地址后面的 /v1 删掉
401 说的就是"不认识你这把钥匙"。最常见的原因是密钥没复制全、前后带了空格,或者把 ChatGPT、Claude 的账号密码当成了密钥。地址写错一般报 404 或连不上。
管好你的密钥
- 它就是钱包钥匙。别人拿到能直接花你的余额。不进截图、不进直播画面、不进代码仓库。
- 一个工具一把。给不同工具各建一个密钥,哪个泄露了就单独删掉,不影响别的。
- 泄露了立刻删。在控制台把那把密钥删除,再新建一个换上。
- 账号密码不是密钥。ChatGPT、Claude 的登录密码永远不要填进任何第三方工具。
课后动手
- 在中转站控制台兑换额度,新建一个专门给本次练习用的密钥。
- 用 curl 测一次模型列表,确认能通。
- 接进 Cherry Studio、Claude Code 或 Codex 中的一个,发一句话。
- 回控制台看用量记录,确认这次请求被记上了。
地址、密钥、模型名,三件套填对,任何支持 API 的工具都能为你所用。