第一步：注册账号与获取API Key
使用千聚AI中转站（以下简称“千聚”）前，需要先完成注册。操作流程如下：
- 访问 千聚AI中转站官网，点击注册按钮，填写邮箱或手机号完成账号创建。
- 登录后，进入“API Key管理”页面，点击生成新的Key。系统会返回一串密钥，例如：
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。 - 复制并妥善保存Key。注意：关闭页面后Key将无法再次查看，只能重新生成。
避坑提醒：不要将API Key硬编码在公开仓库中，建议使用环境变量管理。
第二步：配置Base URL与选择模型
千聚提供了统一的OpenAI兼容接口，接入时只需修改两个配置项：Base URL和模型名称。Base URL固定为：
https://www.qianjuai.cc/v1
模型名称支持多种主流系列，以下为部分常用模型示例：
| 模型系列 | 示例模型名 | 适用场景 |
|---|---|---|
| OpenAI GPT-5 | gpt-5-turbo | 通用对话、代码生成 |
| Claude 3.5 | claude-3-5-sonnet | 长文本分析、推理 |
| DeepSeek-V3 | deepseek-chat | 性价比高、中文优化 |
| Gemini 2.0 | gemini-2.0-pro | 多模态理解 |
完整模型列表请以千聚官网实时展示为准，不同模型名称大小写敏感，配置时务必核对。
避坑提醒：部分模型名称可能带有版本号或日期后缀，建议直接从控制台复制，避免手动输入出错。
第三步：Python调用示例
千聚完全兼容OpenAI的Python SDK，以下是一个完整的调用代码示例：
from openai import OpenAI
client = OpenAI(
api_key="sk-你的API Key",
base_url="https://www.qianjuai.cc/v1"
)
response = client.chat.completions.create(
model="gpt-5-turbo",
messages=[
{"role": "user", "content": "用中文介绍千聚AI中转站"}
]
)
print(response.choices[0].message.content)
运行后，如果配置正确，你会收到模型返回的回复。如果遇到错误，参照下面的避坑指南排查。
避坑指南：常见问题与排查
| 错误现象 | 可能原因 | 解决办法 |
|---|---|---|
| 401 Unauthorized | API Key错误或过期 | 重新生成Key并更新 |
| 404 Not Found | 模型名称不存在或已废弃 | 核对官网模型列表 |
| 超时或连接失败 | 网络限制或Base URL地址错误 | 检查环境变量，确保Base URL包含/v1 |
| 余额不足 | Token耗尽 | 前往千聚购买Token |
千聚作为国内AI中转站，接口稳定、多模型聚合，是降低接入复杂度的不错选择。如果你在配置中遇到上述问题，建议优先检查Base URL和模型名是否与官网示例一致。
现在，你可以直接开始行动了：