
什么是Base URL,为什么重要?
Base URL(基础地址)是API服务的入口。OpenAI官方的Base URL为https://api.openai.com,而大部分国内AI中转站会提供专属的接入地址,例如https://api.yourproxy.com/v1。当你使用OpenAI的SDK或HTTP客户端时,只需要将base_url替换为中转站提供的地址,其余请求逻辑完全不变。这意味着你无需修改已有代码结构,就能调用GPT-4、Claude、Gemini等多种模型——这正是“OpenAI兼容接口”带来的便利。千聚AI中转站提供统一的Base URL,开发者只需一次配置即可切换模型,大幅降低了接入成本。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
配置Base URL的常见步骤(以千聚为例)
下面以千聚AI中转站为例,演示从准备到完成一次模型调用的完整流程。你可以先访问千聚AI中转站官网注册账号并购买Token。
- 获取API Key:登录千聚后台,在“API Key管理”页面生成一个Key(例如
sk-qianju-xxxxxxxx)。 - 找到Base URL:在“接入指南”或“文档”中复制官方的接口地址,一般为
https://api.token88.cc/v1(实际以官网公布为准)。 - 确定模型名称:千聚支持多种模型,如
gpt-4o、claude-3-opus、deepseek-chat等。从官网模型列表选择合适的名称。 - 写代码调用:使用OpenAI Python库示例:
from openai import OpenAI
client = OpenAI(
api_key="sk-qianju-xxxxxxxx",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role":"user","content":"Hello"}]
)
print(response.choices[0].message.content)
以上代码中只需修改api_key和base_url,即可通过千聚调用模型。如果使用Node.js或其他语言,思路完全一致。
兼容设置与注意事项
配置Base URL时,有几点容易出错:
- 末尾斜杠:部分中转站要求Base URL以
/v1结尾,有些则不需要。建议严格按官网文档填写,不要自行增减。 - HTTPS协议:绝大多数中转站强制使用HTTPS,请勿使用HTTP,以免被拦截。
- 模型名称映射:千聚使用自己的模型标识符,例如调用Claude时可能用
claude-3-5-sonnet-20241022或简化名,记得与官网对齐。 - 备用地址:部分中转站会提供备用的Base URL,可作为网络故障时的降级方案。
如果调用返回401或404错误,请优先检查API Key是否正确、Base URL是否完整、模型名称是否支持。千聚控制台提供详细的调用日志,方便排查。
想要查看千聚支持的全部模型和最新的Base URL配置方式?立即点击立即访问千聚进入官方网站,注册后就能在“接入文档”中找到精确地址和示例代码。
推荐继续了解以下内容,帮助你更高效地使用AI中转站:
- 千聚模型列表与选型指南
- Token购买与余额管理技巧
- Python/Node.js完整接入教程
- OpenAI兼容接口常见问题
现在就去官网获取你的API Key,开始第一次调用吧!