AI 中转站怎么用?主流工具接入配置全指南
拿到中转站给你的 base_url 和 API Key 之后,接下来要做的事情其实很简单——大多数中转站都兼容 OpenAI 或 Anthropic 的标准接口格式,你只需要在原来对接官方 API 的代码或工具里,把请求地址和密钥换掉就行。下面按常见工具分别给出配置示例。
通用原理:只改两个参数
不管用什么语言、什么工具,核心逻辑都是一样的:把原本指向官方接口地址的 base_url(或者叫 api_base、endpoint,各家工具叫法不同)换成中转站给你的域名,再把 api_key 换成中转站后台生成的那个密钥。其它请求参数、返回格式和官方接口基本保持一致,代码逻辑不需要大改。
主流工具配置示例
Python(OpenAI 官方 SDK)
from openai import OpenAI
client = OpenAI(
api_key="你的key",
base_url="https://站点域名/v1",
)
resp = client.chat.completions.create(
model="模型名称",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)Node.js(openai 包)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "你的key",
baseURL: "https://站点域名/v1",
});
const resp = await client.chat.completions.create({
model: "模型名称",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);Claude Code CLI
设两个环境变量,重新打开终端或 source 一下配置文件即可生效。
export ANTHROPIC_BASE_URL="https://站点域名"
export ANTHROPIC_AUTH_TOKEN="你的key"Codex CLI
同样是环境变量,注意这里用的前缀是 OPENAI 而不是 ANTHROPIC。
export OPENAI_BASE_URL="https://站点域名/v1"
export OPENAI_API_KEY="你的key"Cursor / Cline 等编辑器插件
在模型服务设置里找到「Custom API」或「OpenAI Compatible」相关选项,把 Base URL 填成中转站给的地址,API Key 填对应密钥,模型名手动填入该站列表里的确切名称,保存后即可在编辑器里正常调用。
curl 快速测试
改代码之前,先用一条 curl 命令确认接口本身能不能通。
curl https://站点域名/v1/chat/completions \
-H "Authorization: Bearer 你的key" \
-H "Content-Type: application/json" \
-d '{"model":"模型名称","messages":[{"role":"user","content":"你好"}]}'常见坑
base_url 要不要带 /v1
大多数兼容 OpenAI 格式的中转站需要在域名后面加 /v1,比如 https://站点域名/v1。具体以该站文档为准,少数站点的 SDK 封装会自动补全,加错了通常会直接报 404。
模型名要用该站列表里的确切名称
同一个模型在不同中转站的命名可能不完全一致(比如版本号、后缀写法有差异),照抄官方名字有时会报「模型不存在」,建议直接从该站的模型列表或后台复制模型名。
部分站点默认走流式响应
如果你的代码没有处理流式返回(Server-Sent Events),拿到的内容可能是分段的原始数据而不是一次性的完整文本,需要在请求参数里显式关闭 stream 或者按流式格式解析。
怎么确认接好了
用上面任意一种方式发一条最简单的请求,比如让模型回复「你好」,能正常收到文字回复就说明配置生效了。如果你更关心拿到的是不是真的官方模型,而不只是「能不能跑通」,建议再用固定的高难度问题在官方和中转站各测一次做对比,或者直接用本站的中转站检测工具填入 base_url 和一个临时 Key,跑一次自动检测。
常见问题
中转站的 API 和官方 SDK 兼容吗,要不要单独装包?
大多数中转站都做了 OpenAI 或 Anthropic 官方接口格式的兼容,直接用官方 SDK(比如 openai、anthropic 这两个包)就能用,不需要额外安装中转站自己的客户端库,只要把 base_url 和 api_key 换掉即可。
换了 base_url 之后一直报错,怎么排查?
先用 curl 单独测一次接口,排除是不是代码本身的问题;再检查 base_url 结尾是否需要带 /v1、api_key 是否输入正确(有没有多余空格)、模型名是否和该站列表完全一致。这三项占了大多数报错原因。
怎么知道自己接的中转站给的是不是真模型?
光看返回内容不容易判断,比较直接的办法是用固定的高难度问题在官方和中转站各测一次做对比,或者直接用本站的中转站检测工具,填入 base_url 和临时 Key 跑一次自动检测。