第一步:注册千聚账号并获取API Key
使用任何聚合平台的第一步都是获取凭证。访问千聚AI中转站官网,注册账号后进入控制台。在API Key管理页面,点击创建新密钥。系统会生成一串以“sk-”开头的字符串,这就是你的API Key,建议立即复制保存。
- 创建密钥时可以为每个Key设置别名,方便区分用途(如开发、测试、生产)。
- 密钥支持权限管理,可以限制可调用的模型范围,降低误操作风险。
第二步:配置Base URL与模型名称
千聚使用与OpenAI完全兼容的端点格式,因此你只需修改Base URL即可。例如在Python的OpenAI库中,配置如下:
import openaiopenai.api_key = "你的API Key"
openai.base_url = "https://www.qianjuai.cc/v1" # 千聚的Base URL
模型名称则根据你想调用的模型填写,例如gpt-4o、claude-3-haiku、deepseek-chat等。完整的模型列表可以在立即访问千聚的“模型文档”中查看,每天更新支持情况。
第三步:购买Token与余额管理
聚合平台按Token用量计费,你需要预先购买Token(即充值余额)。在千聚的“Token购买”页面,可以选择不同面额的套餐,支付后余额即时到账。建议首次充值少量Token进行测试,确认调用正常后再按需追加。
| 操作 | 说明 |
|---|---|
| 选择套餐 | 根据预计用量选择合适的Token包,余额长期有效 |
| 支付方式 | 支持支付宝、微信等多种国内支付方式 |
| 余额查看 | 控制台实时显示余额和消耗记录,方便成本控制 |
Token购买后无需手动分配,系统自动从余额中扣减每次调用的费用。如果你想为不同项目分别计费,可以创建多个API Key并独立管理。
第四步:测试一次模型调用(Python示例)
完成以上配置后,用一段最简单的对话测试接口是否连通:
import openaiopenai.api_key = "你的API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.ChatCompletion.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好,请用中文回复"}]
)
print(response.choices[0].message.content)
如果返回正常文本,说明API接入、Token购买、模型调用完全衔接成功。你可以在代码中切换model参数为其他模型,比如claude-3-opus或gemini-pro,体验多模型聚合的便利。
常见问题与注意事项
- Base URL拼写错误:注意末尾的
/v1/不能省略,且协议应为https。 - 模型名称不对:请从千聚官方文档获取最新模型ID,部分模型有别名。
- 余额不足:当余额低于0时调用会返回401错误,及时购买Token即可恢复。
- 网络延迟:千聚在国内部署了加速节点,相比直接访问海外API延迟更低,更适合国内开发者。
下一步行动:
如果你还想深入学习以下主题,可以直接访问对应页面(基于千聚官网内容):
- 模型列表与最新支持状态
- Token购买与充值优惠
- API接入教程(多语言示例)
- OpenAI兼容接口完整说明