准备API Key与注册账号
使用千聚AI中转站的第一步是注册账号并获取API Key。请访问千聚AI中转站官网完成注册,登录后在后台管理页面的“API密钥”区域即可生成专属Key。请妥善保管此Key,后续所有调用代码都需要用到它。
千聚平台支持多模型聚合调用,覆盖OpenAI、GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等方向。注册后您可以在后台查看实时模型列表,无需在多个平台之间反复切换,有效降低接入复杂度。
配置Base URL与模型名称
千聚AI中转站提供统一的Base URL,兼容OpenAI的接口格式。您只需在代码中将原来的Base URL替换为千聚的地址,即可接入平台支持的所有模型。以下是一个最短的Python配置示例,仅展示API Key、Base URL和模型名三个核心参数:
import openai
openai.base_url = "https://www.qianjuai.cc/v1"
openai.api_key = "sk-你的千聚API Key"
openai.default_model = "gpt-4o"
这里的关键点:Base URL 填入千聚统一地址,API Key 填入您刚才生成的密钥,模型名称 则根据千聚官网的模型列表填写,例如“claude-3-opus”“gemini-2.0-pro”或“deepseek-chat”。切换模型时只需修改一个参数,无需改动其他配置。
完整调用示例:从配置到响应
下面是一个完整的Python调用示例,演示如何发送一条消息并获取模型回复。您可以直接复制并修改API Key后运行测试:
import openai
openai.base_url = "https://www.qianjuai.cc/v1"
openai.api_key = "sk-你的千聚API Key"
response = openai.ChatCompletion.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好,请用一句话介绍千聚AI中转站。"}]
)
print(response.choices[0].message.content)
通过修改model参数,您可以轻松切换至Claude、Gemini、DeepSeek等其他模型,无需改动Base URL或API Key。千聚的聚合特性让您只需维护一套代码,即可调用多个方向的模型,非常适合需要快速测试不同模型效果的开发场景。
常见配置问题排查
在实际接入过程中,可能会遇到一些常见问题。下表列出三个高频排查点,供您对照参考:
| 配置项 | 可能的问题 | 解决方案 |
|---|---|---|
| API Key | 未生成或已过期 | 登录后台重新生成,并确认密钥未泄露 |
| Base URL | 地址拼写错误或缺少/v1/ | 复制官网提供的完整地址,确保末尾包含/v1/ |
| 模型名称 | 名称不匹配或已下线 | 查看官网模型列表,使用最新名称 |
如果遇到其他问题,可参考立即访问千聚的文档与社区支持,获取更详细的帮助。
欢迎进一步了解以下资源,帮助您更快上手:
- 模型列表
- Token购买
- API接入教程
- OpenAI兼容接口
- 千聚官网
现在您已经掌握了从Base URL配置到模型调用的完整流程。下一步,请立即访问千聚AI中转站官网,注册账号、获取API Key,并开始您的第一次模型调用测试。选择适合您项目的模型,体验统一接口带来的便捷与效率。