API 中转站本质上是一个代理服务:你把请求发给中转站,中转站帮你转发给 OpenAI、Claude 等官方接口,再把结果返回给你。对你的代码来说,只是换了个地址和密钥,其他完全一样。
为什么需要中转站?
| 痛点 | 中转站怎么解决 |
|---|---|
| 官方 API 在国内无法直连 | 中转站有国内可达的服务器 |
| 注册需要海外手机号/信用卡 | 中转站支持支付宝/微信注册充值 |
| 每个模型要单独申请账号 | 一个中转站密钥可调用多家模型 |
| 官方价格贵 | 部分中转站有折扣(批量采购优势) |
接入流程(4 步)
第 1 步:选择并注册中转站
在本站「API 中转站」板块浏览,选一家注册。新手建议选有免费额度的站点先体验。
注册后你会进入一个控制台/仪表盘页面。
第 2 步:获取 API Key
在控制台找到「API Keys」或「令牌管理」入口,点击「创建新密钥」。
- 给密钥起个名字(如
my-test-key),方便后续管理 - 复制生成的密钥(通常以
sk-开头),只显示一次,立即保存到安全位置 - 不要截图发给别人,不要提交到 Git
第 3 步:确认 Base URL 和支持的模型
在中转站文档或控制台找到以下信息:
- Base URL:API 请求地址,通常类似
https://api.xxx.com/v1 - 支持的模型列表:如
gpt-4o、claude-3-5-sonnet、deepseek-chat等
第 4 步:发送第一个请求
拿到 Key 和 URL 后,选择你熟悉的方式发请求。
方式一:curl(最快验证)
打开终端,粘贴以下命令(替换密钥和地址):
curl https://你的中转站地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好,请用一句话介绍自己"}]
}'
看到 JSON 响应中有 choices[0].message.content 字段,说明接入成功。
方式二:Python
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="sk-你的中转站密钥",
base_url="https://你的中转站地址/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "你好,请用一句话介绍自己"}
]
)
print(response.choices[0].message.content)
关键点:只需要改 api_key 和 base_url,其他代码和调用 OpenAI 官方完全一样。
方式三:Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的中转站密钥",
baseURL: "https://你的中转站地址/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: "你好,请用一句话介绍自己" }],
});
console.log(response.choices[0].message.content);
切换模型
中转站的一大优势是一个密钥可以调用多个模型,只需改 model 字段:
# 用 GPT-4o
response = client.chat.completions.create(model="gpt-4o", messages=messages)
# 用 Claude 3.5 Sonnet
response = client.chat.completions.create(model="claude-3-5-sonnet-20241022", messages=messages)
# 用 DeepSeek
response = client.chat.completions.create(model="deepseek-chat", messages=messages)
# 用 Gemini
response = client.chat.completions.create(model="gemini-1.5-pro", messages=messages)
模型名称必须和中转站支持列表中的完全一致,大小写敏感。
常见报错及解决
| 错误信息 | 原因 | 解决方法 |
|---|---|---|
401 Unauthorized | 密钥错误或已过期 | 检查密钥是否复制完整,是否已被删除 |
404 Not Found | URL 路径错误 | 确认 base_url 是否以 /v1 结尾 |
429 Too Many Requests | 请求太频繁,被限速 | 等待几秒后重试,或升级套餐 |
model not found | 模型名称拼错或不支持 | 对照中转站文档确认模型名 |
insufficient_quota | 余额不足 | 去控制台充值 |
| 连接超时 | 网络问题 | 检查网络,或换一个中转站试试 |
进阶用法
接入成功后,你可以:
- 接入 Cursor/VS Code:把中转站地址填入编辑器设置,用 AI 辅助写代码
- 接入 ChatGPT 类客户端:如 NextChat、LobeChat 等开源客户端都支持自定义 API 地址
- 搭建自动化工作流:用 n8n、Make 等工具定时调用 API 处理任务
- 开发自己的应用:基于 API 构建聊天机器人、内容生成工具等
中转站 vs 官方 API 的区别
| 维度 | 官方 API | 中转站 |
|---|---|---|
| 注册门槛 | 需海外手机号/信用卡 | 支付宝/微信即可 |
| 网络访问 | 国内需代理 | 国内直连 |
| 价格 | 官方定价 | 可能更低(也可能更高) |
| 稳定性 | 最稳定 | 取决于中转站质量 |
| 数据安全 | 直接与官方通信 | 经过第三方中转 |
| 模型覆盖 | 只有自家模型 | 可能聚合多家模型 |
建议:对数据安全要求高的生产环境,优先用官方 API;个人学习和开发测试,中转站更方便。