一、注册账号并获取API Key
使用千聚AI中转站的第一步是注册账号。直接访问千聚AI中转站官网,在首页点击注册按钮,输入邮箱或手机号完成验证即可。注册过程快捷,无需复杂审核流程,适合个人开发者以及企业团队快速上手。
登录后,在控制台左侧导航栏找到”API Key管理”页面,点击”创建新API Key”。你可以为Key设置名称,例如”开发环境”或”生产环境”,方便后续区分。千聚支持创建多个Key,并可为每个Key配置独立的调用限额和IP白名单,这些功能对于团队协作和安全管理非常实用。
创建成功后,请务必复制并保存Key。如果遗失,可以在控制台重新生成,但旧Key将立即失效,需注意更新应用中的配置。
二、确认Base URL与模型名称
千聚AI中转站采用兼容OpenAI的接口格式,这意味着你不需要单独学习新的调用方式。Base URL格式为:https://www.qianjuai.cc/v1(具体地址请以官网最新文档为准)。在配置时,只需将原OpenAI的Base URL替换为千聚提供的地址,并保持其他参数不变,即可完成切换。
模型名称方面,千聚汇聚了GPT-5系列、Claude系列、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等主流模型。每个模型的具体名称(如gpt-5-turbo、claude-3-opus、deepseek-chat等)可以在官网的模型列表页面找到。建议在调用前先确认对应模型的名称格式,避免因大小写或符号差异导致调用失败。
这种统一接口设计,让你只需维护一套代码即可调用多个模型,显著降低了多平台切换的复杂度,也减少了API密钥管理的成本。
三、使用Python发起首次模型调用
以下是一个基于OpenAI官方SDK的Python调用示例,仅需几行代码即可完成一次模型请求。请确保已安装openai库(pip install openai):
import openai
配置千聚API Key和Base URL
openai.api_key = "sk-你的API Key" # 替换为真实Key
openai.base_url = "https://www.qianjuai.cc/v1"
发起对话请求
response = openai.chat.completions.create(
model="gpt-5-turbo", # 请以官网模型列表为准
messages=[
{"role": "system", "content": "你是一个专业的AI助手。"},
{"role": "user", "content": "你好,请介绍一下AI模型聚合平台如何接入?"}
]
)
输出模型回复
print(response.choices[0].message.content)
注意:请务必将API Key替换为你在千聚生成的真实Key,并确认模型名称存在于千聚的模型列表中。如果使用Node.js,调用逻辑类似,只需使用openai的Node.js SDK并修改对应配置即可。千聚对所有支持OpenAI SDK的语言都兼容,包括Python、Node.js、Java、Go、PHP等。
成功运行后,你将看到模型返回的回复内容。如果遇到错误,请参考下一节的常见问题排查。
四、购买Token与余额管理
完成首次调用后,你可能需要为后续项目准备更多Token。千聚AI中转站支持按量购买Token,无需订阅固定套餐,也无需预存大额资金。你可以在控制台实时查看当前余额,并根据需求随时充值。这种模式对于阶段性测试、项目开发初期或流量波动较大的场景更加灵活,避免了资源浪费。
此外,千聚还提供API调用统计功能,帮助开发者分析各模型的使用量和成本分布。你可以按日、周、月查看调用趋势,便于优化调用策略和预算规划。Token余额不足时,系统会通过邮件或站内信提醒,避免因欠费导致服务中断。
五、常见问题排查
如果在调用过程中遇到错误,建议按以下顺序检查:
- API Key问题:检查Key是否完整复制,是否含有多余空格、换行或引号。建议重新生成一次Key后重试。
- Base URL问题:确认URL以https://开头,且以/v1结尾。注意不要遗漏末尾斜杠。
- 模型名称问题:确认模型名称与官网列表完全一致,注意大小写和符号。
- 余额问题:登录控制台查看余额是否充足,如果Token已用完需要及时充值。
- 网络问题:确保服务器或本地网络可以正常访问千聚的API地址,必要时可配置代理。
如果以上检查均无误但问题依旧,建议前往千聚官网查看最新的API文档或联系技术支持团队获取帮助。
推荐阅读
- 千聚AI模型列表与支持模型详解
- Token购买与充值操作指南
- OpenAI兼容接口接入教程
- Python/Node.js调用示例集合
现在你已经掌握了从注册到API调用的完整流程。快速测试一次模型调用,即可体验千聚AI中转站带来的便捷。立即访问千聚AI中转站官网,注册账号、获取API Key,并开始你的AI模型调用之旅。