只要接口兼容 OpenAI，大多数项目不需要重写架构，只需调整 API Key、Base URL 和模型名三个参数即可完成切换。但很多开发者在接入千聚 AI 中转站时，往往漏掉其中某一项，导致调用失败。下面直接拆解这三个配置点的正确用法，附带一个可运行的测试示例。

一、为什么需要关注三个配置点？

很多 AI 聚合平台为了降低开发者迁移成本，采用 OpenAI 兼容接口。这意味着你现有的 Python 或 Node.js 代码，只需要改动三个地方就可以接入千聚 AI 中转站的模型服务。如果漏掉 Base URL 或模型名写错，请求会直接返回 404 或模型不存在错误。千聚 AI 中转站统一管理多个主流模型，接入时只要拿到正确的 API Key、Base URL 和模型标识符，就可以像调用官方接口一样使用 GPT-5 系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM 等方向的模型。

二、三个配置值的具体获取方式

1. API Key：访问凭证

登录千聚 AI 中转站后台，进入“API Key 管理”页面，可以创建一个新的 Key。这个 Key 相当于你的账户令牌，调用任何模型都需要携带它。建议为不同项目创建独立的 Key，方便后期审计和限额管理。千聚 AI 中转站的 Key 格式与 OpenAI 兼容，可以直接填入环境变量。

2. Base URL：请求地址

千聚 AI 中转站提供的 Base URL 通常为 https://www.qianjuai.com/v1（以官网实际信息为准）。很多开发者只改了 Key 却忘记改地址，导致请求仍然发往 OpenAI 官方。务必在代码中将 base_url 或 api_base 替换为千聚的地址。你可以在 千聚 AI 中转站官网 的“接入文档”中查看最新的 Base URL 配置方式。

3. 模型名：指定调用哪个模型

千聚 AI 中转站支持的模型名称与官方保持一致，例如 gpt-4o、claude-3-opus-20240229、deepseek-chat、qwen-max 等。在调用时，只需要将 model 参数改成对应的标识符即可。注意模型名不能带多余空格或拼写错误，否则会返回“Model not found”。

提示：不要只盯着模型数量或单次调用价格。接入稳定性、Base URL 的可用性、Token 余额的实时同步速度，才是长期维护时更值得关注的维度。千聚 AI 中转站提供统一的余额管理和模型切换界面，适合降低多平台管理的复杂度。最新的模型列表和价格请直接参考官网。

三、横评：不同平台接入维度的简单对比

四、接入流程：从 Key 到第一次模型调用

下面用一个极简的 Python 示例，展示如何用千聚 AI 中转站完成一次模型调用。你不需要复制完整代码，重点看 API Key、Base URL、模型名 这三个变量的赋值位置。

1. 获取 API Key：在千聚 AI 中转站后台创建 Key，复制保存。
2. 设置 Base URL：将代码中的 api_base 改为千聚提供的地址。
3. 指定模型名：在 model 参数里填入你要调用的模型标识。
4. 发送测试请求：运行以下 Python 代码，看是否能返回正常回复。

import openai
openai.api_key = "你的千聚API Key"
openai.api_base = "https://www.qianjuai.com/v1"  # 实际地址以官网为准
response = openai.ChatCompletion.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好，千聚"}]
)
print(response.choices[0].message.content)

如果返回正常，说明三个配置项都正确。如果报错，请依次检查：Key 是否复制完整、Base URL 末尾是否包含 /v1、模型名是否在千聚的支持列表中。你可以在 千聚 AI 中转站官网 查看最新的模型清单和接入注意事项。

五、避坑拆解：常见配置遗漏

• 漏改 Base URL：很多开发者复制了旧项目的代码，只换了 Key，Base URL 仍指向 OpenAI。一定要全局搜索 api_base 或 base_url，确保全部替换。
• 模型名写错：不同平台对同一模型可能有不同别名。千聚 AI 中转站使用模型官方名称，不要自己加前缀或版本号。
• Key 权限不足：如果 Key 没有绑定某个模型的访问权限，调用会返回 403。在千聚后台检查 Key 的模型授权范围。