AI网关API Key到底是什么？为什么需要它？
API Key相当于你调用AI模型的“身份凭证”。无论是OpenAI、Claude还是DeepSeek，每个模型服务商都要求你在请求头中携带一串秘钥，服务器才能识别你的账户、计量使用量并扣费。对于同时使用GPT、Gemini、Qwen等多个模型的团队来说，管理多套API Key和账单非常繁琐——这正是AI网关的价值所在。
千聚AI中转站提供了一个统一的平台：你只需在千聚注册并购买Token，就能拿到一套API Key，使用这一套Key即可调用多个主流模型，包括GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等。这大大减少了多平台切换的成本，也更便于集中管理余额与用量。
填写API Key的正确姿势：从千聚获取
第一步当然是注册账户。访问千聚AI中转站官网，完成注册后登录后台。在用户中心或API管理页面，你可以创建新的API Key。创建后，请务必完整复制并妥善保存（页面通常只会展示一次）。
配置时，常见的报错原因有几种：
- 格式错误：API Key一般以“sk-”开头，复制时不要多复制空格或换行符。
- 权限不足：确保该Key已绑定允许调用的模型，或账户余额充足。
- 环境变量：如果是Python或Node.js项目，建议将Key写入.env文件，而非硬编码在代码中。
配置示例如下（Python环境）：
import os
api_key = os.getenv("QIANJU_API_KEY") # 从环境变量读取
Base URL和模型名称怎么填？
除了API Key，另外两个关键配置是Base URL和模型名称。千聚AI中转站兼容OpenAI的接口格式，因此所有支持OpenAI SDK的工具（如LangChain、AutoGPT等）都可以直接适配。
| 配置项 | 含义 | 千聚示例值 |
|---|---|---|
| Base URL | API服务地址 | https://www.qianjuai.cc/v1 |
| 模型名称 | 你要调用的模型ID | gpt-4o / claude-3-opus / deepseek-chat |
具体模型ID列表，请前往立即访问千聚查看最新文档。配置时只需将原来指向OpenAI的base_url替换为千聚的地址，将API Key替换为你从千聚获取的Key，模型名称按需填写即可。
常见错误排查
- 401 Unauthorized：检查API Key是否复制完整，或该Key是否已被禁用。
- 404 Not Found：确认Base URL末尾是否多了“/”或用错了版本路径。
- Model Not Found：确认填写的模型名称是否在千聚支持的列表中。
开始你的第一次模型调用
完成上述配置后，你可以用以下Python代码快速测试，该代码兼容千聚AI中转站的接口：
import openai
openai.api_key = "你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)
如果顺利返回结果，说明你的AI网关API Key配置完全正确。后续你可以根据需要切换模型，只需修改model参数即可，无需更换Key或重新配置。