一、注册千聚账号并获取API Key
首先,你需要一个可用的API Key。访问 千聚AI中转站官网 完成账号注册(支持邮箱或手机号),登录后进入控制台的“API Key管理”页面。点击“创建新密钥”,系统会生成一串以 sk- 开头的密钥。请复制并妥善保存,后续所有请求都需要用它进行身份验证。
- 密钥权限:千聚的API Key默认支持所有已购买模型的调用,无需单独申请权限。
- 安全提示:建议将密钥存储在环境变量中,不要硬编码在代码里。
二、配置Base URL与模型名称
千聚AI中转站完全兼容OpenAI的客户端库,你只需修改Base URL即可。在代码或配置文件中,将原来的 https://api.openai.com/v1 替换为千聚提供的接入地址:
https://www.qianjuai.cc/v1
模型名称请从千聚官网的“模型列表”页面获取最新清单。例如,要调用GPT-4o,模型参数填写 gpt-4o;要调用Claude 3.5 Sonnet,则填写 claude-3.5-sonnet。以下是一个示例配置文件(环境变量方式):
OPENAI_API_KEY=sk-your-qianju-key
OPENAI_BASE_URL=https://www.qianjuai.cc/v1
MODEL_NAME=gpt-4o
通过统一Base URL,你可以在同一个代码库中轻松切换不同模型,极大降低多平台维护成本。
三、用Python调用模型(示例代码)
以下是一个完整的Python调用示例,展示如何独立站接入模型中转站并进行一次对话请求。请确保已安装 openai 库(pip install openai)。
from openai import OpenAI
client = OpenAI(
api_key="sk-your-qianju-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)
运行后,你将收到模型返回的文本。如果返回正常,说明独立站接入工作已基本完成。如需调用其他模型(如DeepSeek、Gemini等),只需修改 model 参数即可。
四、常见问题与排查
即使配置正确,有时也会遇到连接失败或认证错误。以下表格列出了几种典型问题及解决方法:
| 错误信息 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key无效或未正确设置 | 检查密钥是否完整复制,并确认未过期 |
| 404 Not Found | 模型名称不存在 | 前往千聚官网确认模型名称最新列表 |
| Connection Timeout | 网络无法访问千聚服务器 | 尝试更换网络环境或使用代理 |
| Insufficient Balance | Token余额不足 | 在千聚控制台购买Token套餐 |
如果以上无法解决,可以在千聚官网的工单系统或技术社区提问,通常半小时内会有反馈。
五、开始你的第一次调用
配置完成后,建议先使用简单的“Hello World”请求验证链路通畅,然后逐步接入你独立站的实际业务(如客服、内容生成等)。千聚AI中转站支持多种主流模型,且提供灵活的Token购买方式,更适合需要降低接入复杂度的开发者团队。
立即前往 千聚AI中转站官网 查看最新模型列表、购买Token并获取你的专属API Key,开启高效接入之旅。