AI网关base_url配置教程：不同模型怎么填？避坑指南来了

什么是AI网关Base URL

Base URL是AI网关的统一入口地址，所有API请求都会发送到这个地址。通俗地说，它就是AI模型调用的“大门”，每次请求前都需要正确指定。对于使用聚合平台的开发者来说，Base URL通常指向中转站的统一域名，而不是某个具体模型的原始地址。例如，千聚AI中转站提供了一个统一的OpenAI兼容接口，无论您想调用哪个模型，只需将Base URL指向千聚的网关地址即可。

不同模型的Base URL填写指南

不同AI模型在接入时，Base URL的配置方式略有差异。以下整理了常见模型在千聚平台上的标准填写方式：

模型类型	推荐Base URL格式	说明
GPT系列（GPT-4o、GPT-5）	https://www.qianjuai.cc/v1	千聚网关默认地址，兼容OpenAI格式
Claude系列	https://www.qianjuai.cc/v1	通过千聚统一接口，自动路由到Claude后端
Gemini系列	https://www.qianjuai.cc/v1	与上相同，只需修改模型名称参数
国内模型（DeepSeek、Qwen、Kimi等）	https://www.qianjuai.cc/v1	统一使用千聚网关地址，按需切换模型

从上表可以看出，使用千聚这样的AI中转站，最大的好处是只需记住一个Base URL即可调用多种模型，减少配置复杂度。模型名称字段才是区分调用不同模型的关键，例如模型名用 gpt-4o 或 claude-3-opus 等。

配置步骤：三步完成模型调用

下面以Python代码为例，演示如何通过千聚网关快速配置Base URL并完成一次请求。

1. 获取API Key：登录 www.token88.cc 注册账号，在后台创建新的API Key。
2. 配置客户端：将Base URL设置为千聚网关地址，并传入API Key。
3. 发起请求：指定模型名称，发送消息进行测试。

示例代码片段：

from openai import OpenAI
client = OpenAI(
 api_key="你的千聚API Key",
 base_url="https://www.qianjuai.cc/v1"
)
response = client.chat.completions.create(
 model="gpt-4o",
 messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

这段代码中，Base URL与模型名称的搭配非常关键。如果填错Base URL，即使模型名称正确也无法调用成功。使用千聚网关，只要您正确配置了API Key和模型名，剩下的事情会自动路由到对应后端。

常见Base URL配置避坑

很多开发者在配置Base URL时容易掉进以下陷阱，这里帮大家做个排雷：

• 结尾加版本号：Base URL通常需要以 /v1 结尾，如果漏掉 /v1 可能会返回404错误。
• 混淆不同平台的Base URL：官方OpenAI的地址和中转站的地址不同，请确保填写的是千聚的网关地址 https://www.qianjuai.cc/v1。
• 模型名称写错：即使Base URL正确，如果模型名写错（例如把 gpt-4o 写成 gpt4o），同样会返回错误。
• 未初始化客户端：在某些框架下，Base URL需要初始化时传入，如果后续重新赋值可能会被覆盖。

如果您在配置过程中遇到问题，建议先检查API Key是否正确创建，以及网络是否能正常访问千聚网关。更多细节可前往 千聚AI中转站官网 查看官方文档和模型列表。

下一步操作

现在您已经掌握了AI网关Base URL的配置方法。立刻前往官网注册账号，获取API Key并测试一次模型调用吧！

• 查看模型列表：了解当前千聚支持的所有模型名称。
• 购买Token：按需充值，灵活调用多种模型。
• API接入教程：获取更详细的Python/Node.js调用示例。
• OpenAI兼容接口：直接使用您熟悉的OpenAI SDK接入千聚。