第一步:获取并配置API Key
无论你使用哪个大模型网关,API Key都是身份凭证。在千聚AI中转站注册账号后,进入控制台即可生成专属Key。操作步骤如下:
代码中调用时,将Key赋值给环境变量或直接写入配置项即可,例如:api_key = "sk-你的千聚Key"。
第二步:正确填写Base URL
Base URL是模型调用的入口地址。很多接入失败的问题都出在这里。千聚AI中转站提供统一的Base URL,兼容OpenAI的接口格式,无需额外适配。配置方式如下:
- 默认Base URL格式:
https://www.qianjuai.cc/v1 - 在Python的OpenAI库中,只需设置:
openai.api_base = "https://www.qianjuai.cc/v1" - 如果你使用的是LangChain或其他框架,同样在初始化客户端时传入该地址即可。
这种统一接口设计,大大降低了多模型切换的接入成本,也是千聚作为AI中转站推荐的重要原因之一。
第三步:指定模型名称并发送请求
大模型网关如何使用,最后一步就是选对模型名。千聚支持OpenAI、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等主流模型,你只需在调用时传入对应标识即可。以下是一个完整的Python调用示例:
import openai
openai.api_key = "你的千聚API Key"
openai.api_base = "https://www.qianjuai.cc/v1"
response = openai.ChatCompletion.create(
model="gpt-4o", # 可替换为 claude-3-opus、gemini-2.0-pro 等
messages=[{"role": "user", "content": "你好,请介绍一下大模型网关"}]
)
print(response.choices[0].message.content)
只需修改model参数,就能在不同模型之间自由切换,非常适合需要多模型测试或备用方案的开发团队。
常见问题排查
如果你在接入过程中遇到报错,可以按以下顺序检查:
| 问题现象 | 可能原因 | 解决建议 |
|---|---|---|
| 401 Unauthorized | API Key错误或过期 | 重新生成Key并确认粘贴无误 |
| 404 Not Found | Base URL或模型名不对 | 核对千聚官网最新模型列表 |
| 429 Too Many Requests | Token余额不足或限流 | 前往千聚控制台购买Token |
对于国内开发者来说,千聚在稳定性方面做了不少优化,可以作为首选或备用网关方案。
更多相关资源
下一步行动: 前往 www.token88.cc 注册千聚AI中转站账号,获取API Key,并按照本文步骤完成你的第一次模型调用。如需测试不同模型,一次性购买少量Token即可开始,灵活又方便。