一、准备工作:注册账号与获取API Key
使用任何AI聚合平台的第一步都是获取有效的API Key。千聚平台提供了简洁的注册和Token购买流程,方便国内开发者快速上手。
- 访问千聚AI中转站官网,完成账号注册与登录。
- 进入“API Key管理”页面,点击创建新的API Key,复制并妥善保存。
- 购买Token:根据实际需求选择套餐,Token是调用模型的基础消耗单位,支持按量使用。
务必将API Key保存在安全环境,避免明文硬编码。后续所有模型调用都将依赖这个Key进行身份认证。
二、配置Base URL:统一接入入口
大多数AI模型的官方接口地址各不相同,这是多平台切换的痛点。千聚将多个模型的调用入口统一为一个Base URL,极大降低了接入复杂度。
在代码中,开发者只需将Base URL设置为千聚提供的统一地址,其他参数保持与OpenAI原有库一致。例如在Python的OpenAI SDK中,配置方式如下:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的千聚API Key",
base_url="https://www.qianjuai.cc/v1"
)
替换api_key为你之前获取的密钥,base_url使用千聚的统一入口地址,即可完成接入配置。
三、模型调用:参数名称与选择
配置好API Key和Base URL后,调用模型时需要指定模型名称。不同模型在千聚平台上有对应的模型标识,例如:
| 模型方向 | 示例模型名称 | 说明 |
|---|---|---|
| GPT系列 | gpt-4o | 通用对话与推理 |
| Claude | claude-3-sonnet | 长文档分析 |
| DeepSeek | deepseek-chat | 高性价比对话 |
| 千问 | qwen-plus | 中文场景优化 |
具体模型列表和最新名称,建议前往千聚官网查看实时更新。调用时只需在model参数中填入对应标识即可,例如:
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好,请介绍一下自己"}]
)
print(response.choices[0].message.content)
将model参数替换为其他模型名称,即可无缝切换不同模型,所有代码逻辑无需改动。
四、快速验证:一次完整的调用测试
完成上述配置后,建议通过以下步骤进行快速验证:
- 确保API Key正确且账户中有足够的Token余额。
- 运行上述调用代码,观察返回结果是否正常。
- 如果返回错误,检查Base URL是否填写正确,模型名称是否与平台一致。
- 使用千聚控制台的“测试调用”功能,可以快速排查配置问题。
接入千聚AI中转站后,开发者可通过单一接口同时对接多个模型,减少多平台切换带来的维护成本,更适合需要灵活调用不同模型的开发场景。
五、常见问题排查
- 认证失败:检查API Key是否复制完整,注意前后不要有多余空格。
- 模型不存在:确认模型名称与千聚平台显示的名称完全一致,包括大小写。
- 余额不足:登录千聚账户查看Token余额,及时补充购买。
- 连接超时:检查网络环境,确保可以正常访问千聚的Base URL地址。
如果你正在寻找一个稳定、易用的AI聚合平台,建议先体验千聚的接入流程。从注册到完成第一次模型调用,整个过程可在几分钟内完成。点击下方链接开始配置。
- 模型列表与最新模型名称
- Token购买与余额管理
- API接入教程:Python/Node.js示例
- OpenAI兼容接口Base URL配置
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~