中转站基础知识
用最简单的话说清楚:中转站是干什么的、API 地址填哪里、请求怎么走、用的时候要注意什么。
这一页面向第一次用 API 的同学。看完你只需要记住三样东西:API 地址、API Key、模型名称。
中转站是干嘛的
官方模型(GPT、Claude、Gemini 等)价格很贵,中转站通过各种渠道让用户获得低价模型调用。
中转站就是中间的统一入口:
- 你在本站充值、拿一把钥匙(API Key)
- 软件把问题发给本站,本站再转给对应的模型
- 模型的回答经本站回到你的软件
你能得到什么
在聊天软件、编程工具里低价使用多家模型。
API 地址是干嘛的
API 地址就是软件往哪里发请求,相当于快递单上的「仓库地址」。
聊天软件、编程工具(如 Codex、Claude Code、Cursor、Cherry Studio)不会自己知道该连哪,需要你填这个地址。填对了,请求才能到达本站;填错了,就会连不上或报 404。
本站提供多条加速线路,网络不好就换一条。具体地址见 API 地址。连不上或超时,按 网络错误问题 排查。
换线路只换地址
Key 不用换。同一个 API Key 可以配任意一条本站线路。
API 调用逻辑
一次正常调用,大致是这样:
- 你在网站【控制台】按 创建 API Key 的步骤拿一把 Key
- 在软件里填上:API 地址 + API Key + 模型名称
- 你提问,软件把内容打包,发到本站地址
- 本站核对 Key、扣除额度,转给对应模型
- 模型生成回答,经本站返回到你的软件
你平时只和软件打交道。本站负责验钥匙、转发、记账。
调用时的注意事项
/v1 后缀
本站地址一般长这样:https://某域名/v1。
/v1 表示「第 1 版接口」,大多数 OpenAI 兼容软件都认这个结尾。
容易踩坑的地方:
- 大部分软件不会自动补:这时必须带上
/v1 - 有的软件会自动补
/v1:这时只填域名,例如https://esa.ezaigc.cn,不要再加/v1
连不上时先查这一项
报 404、提示找不到接口时,先试着给地址加上或去掉 /v1,多数情况就能对上。
API Key
- 按 创建 API Key 的步骤在控制台创建,不要随便编一个
- 复制时不要多空格、少字符
- 不要发给别人,别人用了会扣你的额度
- 泄露了就在控制台删除,再新建一把
- 本站地址必须配本站 Key。不能拿官方 OpenAI / Claude 的 Key 填到本站,也不能拿本站 Key 去填官方地址
其他常见问题
- 模型名称要填本站提供的名字,不要自行改写
- 余额不足时调用会失败,先确认额度
- 软件里如果还要填「接口类型 / API 格式」,按下一节选择即可
几种主流 API 格式
不同软件走的「窗口」不一样。中转站通常同时开了这几个窗口,按软件要求选对应格式就行。看不懂细节也没关系,对上名字即可。
OpenAI 兼容(Chat)
- 常见后缀:
/v1/chat/completions - 谁在用:绝大多数客户端、浏览器插件、旧版对接
- 怎么填:地址填到
/v1这一层,软件会自己拼后面的/chat/completions - 详细步骤见 OpenAI 接口说明
OpenAI Responses
- 常见后缀:
/v1/responses - 谁在用:较新的 OpenAI 接口、部分新客户端
- 和 Chat 的区别:还是 OpenAI 家的,但是「新版点餐单」,字段不太一样
- Codex 默认使用该接口访问模型,配置步骤见 Codex 配置
- 详细步骤见 OpenAI 接口说明
Claude 格式
- 常见后缀:
/v1/messages - 谁在用:要求 Anthropic / Claude 官方格式 的软件
- 怎么填:多数情况地址仍然填到
/v1,软件会自己拼/messages - Claude Code默认使用该接口访问模型,配置步骤见 Claude Code 配置
- 详细步骤见 Anthropic 接口说明
Gemini 格式
- 常见后缀:类似
/v1beta/models/模型名:generateContent - 谁在用:要求 Google Gemini / Google AI 官方格式的软件
- 和前面几个不一样:路径里常常带模型名,也不一定以
/v1结尾 - 详细步骤见 Gemini 接口说明
对照表
| 格式 | 常见后缀 | 什么时候用 |
|---|---|---|
| OpenAI Chat | /v1/chat/completions | 兼容性最好 |
| OpenAI Responses | /v1/responses | 软件写明要用 Responses |
| Claude | /v1/messages | 软件要求 Claude / Anthropic 格式 |
| Gemini | /v1beta/models/... | 软件要求 Gemini / Google 格式 |
上手记这三步
- 按 创建 API Key 在控制台拿一把 Key
- 从 API 地址 复制一条线路
- 软件里选对格式(多数选 OpenAI Chat),填上地址、Key 和模型名