
一、准备工作:从千聚获取API Key和Base URL
在使用任何代码示例之前,你需要先准备好两个核心参数。登录千聚AI中转站官网注册账号后,进入API Key管理页面创建新的Key。千聚统一采用OpenAI兼容接口,因此Base URL固定为平台提供的专属地址,无需为不同模型单独配置。购买Token后即可开始调用。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
二、大模型中转站代码示例:Python调用
以下是一个可直接运行的Python代码片段,展示了如何使用OpenAI库对接千聚的中转接口。你只需替换三个变量:API Key、Base URL和模型名称。
import openai
openai.api_key = "sk-你的千聚API Key"
openai.api_base = "https://api.qianju.example.com/v1" # 此为示意,实际以官网提供为准
response = openai.ChatCompletion.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello, World!"}]
)
print(response.choices[0].message.content)
注意事项:
- 确保已安装openai库,版本建议0.28以上。
- 模型名称请参照千聚官网的模型列表填写,支持GPT-4o、Claude 3.5、DeepSeek-V3等。
- Base URL末尾不要漏掉“/v1”,否则请求会失败。
三、Node.js调用示例
如果你是前端或Node.js开发者,可以使用axios或openai-node库。配置方式相似,核心仍是API Key和Base URL的拼接。以下是一个简洁的axios示例:
const axios = require('axios');
axios.post('https://api.qianju.example.com/v1/chat/completions', {
model: 'claude-3.5-sonnet',
messages: [{ role: 'user', content: '你好' }]
}, {
headers: { 'Authorization': 'Bearer sk-你的千聚API Key' }
}).then(res => console.log(res.data.choices[0].message.content));
无论使用哪种语言,Base URL和API Key都是连接中转站的钥匙。如果配置不对,最常见的错误是“401未经授权”或“404接口不存在”,建议先检查Base URL是否包含完整的路径部分。
四、常见配置问题排查
| 错误类型 | 可能原因 | 解决方法 |
|---|---|---|
| 401 Unauthorized | API Key错误或过期 | 重新在千聚后台生成Key并替换 |
| 404 Not Found | Base URL路径不全 | 确认结尾包含“/v1”及正确域名 |
| Model Not Found | 模型名称不对 | 去官网查看最新的模型列表 |
千聚AI中转站支持一键切换模型,无需修改Base URL,只需改变model参数即可从GPT切换到Claude或DeepSeek。这种统一接口的设计正是为了让开发者减少适配成本。
五、下一步行动
看完代码示例和配置要点,你应该已经清楚如何快速上手。建议立刻登录立即访问千聚创建你的第一个API Key,然后用上面的代码跑一次测试。实测一次请求就能验证配置是否正确。
- 查看完整模型列表:千聚AI中转站支持哪些大模型
- Token购买指南:如何按需充值
- Python SDK进阶调用:流式输出和上下文管理
- OpenAI兼容接口详解:Base URL配置最佳实践
核心要点回顾:确保API Key从千聚后台正确生成,Base URL使用平台提供的统一地址,模型名称参照官方列表填写。按照这个流程,大模型中转站的代码示例就能顺利跑通。