第一步:注册千聚账号并获取API Key
在使用千聚之前,你需要在官网完成注册。注册过程非常简单:
- 访问 千聚AI中转站官网,点击右上角的“注册”按钮。
- 填写邮箱和密码,完成邮箱验证后即可登录。
- 登录后进入控制台,在“API Key管理”页面点击“创建新Key”。系统会生成一串以“sk-”开头的密钥,请妥善保存。
这个API Key就是后续所有模型调用的唯一凭证,搭配千聚的统一Base URL使用。
第二步:确认Base URL和模型名称
千聚的接口完全兼容OpenAI的调用格式,因此Base URL和模型名是固定的配置项:
- Base URL:
https://www.qianjuai.cc/v1 - 模型名称:例如
gpt-4o、claude-sonnet-4、deepseek-chat等。完整的模型列表请查看官网文档。
你只需要将原本指向OpenAI的Base URL替换为千聚的地址,并将API Key换成千聚的密钥,即可无缝切换。这样你的独立站无需修改任何业务逻辑,就能调用多个模型。
第三步:使用Python测试一次调用
以下是一个简短的Python示例,展示了如何使用千聚的API Key和Base URL完成一次对话:
import openai
openai.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 Key替换为你实际获取的密钥,运行后即可看到模型返回的结果。如果一切正常,说明你的独立站已经成功接入了千聚AI中转站。
第四步:为独立站配置持久化调用
在独立站的后端服务中,你需要将上述调用逻辑封装成接口或函数。常见做法是:
- 在环境变量中设置
OPENAI_API_KEY和OPENAI_BASE_URL。 - 调用时直接读取环境变量,避免硬编码。
- 根据用户请求动态切换模型名称(例如在管理后台提供模型选择下拉框)。
千聚支持按量计费,你可以在控制台随时查看Token消耗和余额,非常适合独立站按需使用。更多配置细节可参考 www.token88.cc 上的开发者文档。
常见问题与排查
在接入过程中可能遇到的一些小问题:
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| 401 Authentication Error | API Key错误或未激活 | 检查控制台中的Key是否复制完整 |
| 404 Model Not Found | 模型名称拼写错误 | 对照官网模型列表核对名称 |
| 429 Rate Limit | 短时间内请求过多 | 适当增加请求间隔或升级套餐 |
如果遇到其他错误,可查看千聚的API文档或联系技术支持。
适合继续扩展的标题方向
- 独立站接入模型中转站:API Key与Base URL配置详解
- 千聚AI中转站Token购买指南:从充值到调用
- 独立站如何用千聚实现多模型切换:Python调用教程
下一步行动:现在就前往 千聚AI中转站官网 注册账号,获取你的API Key,查看完整模型列表,购买Token后开始你的首次调用。让独立站接入AI变得像配钥匙一样简单。