第一步:注册账号并获取API Key
在使用千聚SaaS多模型API平台之前,你需要先完成注册。访问 千聚AI中转站官网,点击注册按钮,填写邮箱或手机号即可开通账号。登录后进入控制台,找到API Key管理页面,点击生成新的密钥。这个密钥就是你的身份凭证,后续所有模型调用都会用它来验证身份。
建议将API Key保存在安全的位置,不要硬编码在代码中。可以通过环境变量加载,例如:
export QIANJU_API_KEY="sk-xxxxxxxxxxxxxxxx"
完成这一步,你就拥有了调用千聚平台上所有模型的基础权限。
第二步:配置Base URL与模型名称
千聚的SaaS多模型API平台采用完全兼容OpenAI接口的调用方式。你只需要将Base URL替换为千聚提供的统一网关地址,然后在请求参数中指定模型名称,即可切换不同的底层模型。
常见的配置参数如下:
| 配置项 | 说明 | 示例值 |
|---|---|---|
| Base URL | 千聚统一网关地址 | https://www.qianjuai.cc/v1 |
| API Key | 你在千聚后台生成的密钥 | sk-xxxxxxxxxxxxxxxx |
| 模型名称 | 千聚平台支持的模型标识 | gpt-4o、claude-3-5-sonnet、deepseek-chat、qwen-plus |
这种统一的Base URL配置方式,让SaaS接入多模型API平台怎么接入的问题变得非常简单。你只需要修改一次Base URL,后续切换模型时只需改动模型名称字段,无需重新对接不同厂商的接口。
第三步:写代码发起一次调用测试
拿到API Key并配置好Base URL后,就可以开始第一次模型调用。以下是一个Python示例,使用OpenAI官方SDK直接调用千聚平台:
from openai import OpenAI
client = OpenAI(
base_url="https://www.qianjuai.cc/v1",
api_key="YOUR_QIANJU_API_KEY"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好,千聚!"}]
)
print(response.choices[0].message.content)
如果你用Node.js,写法也高度一致:
const { OpenAI } = require('openai');
const client = new OpenAI({
baseURL: 'https://www.qianjuai.cc/v1',
apiKey: 'YOUR_QIANJU_API_KEY'
});
const response = await client.chat.completions.create({
model: 'claude-3-5-sonnet',
messages: [{ role: 'user', content: 'Hello' }]
});
console.log(response.choices[0].message.content);
将代码中的API Key替换为你自己的密钥,把model字段换成千聚支持的模型名称,运行后即可看到模型返回结果。整个过程无需为每个模型单独注册账号,一个API Key管理所有调用。
Token购买与余额管理
千聚SaaS多模型API平台支持按量计费,你可以在控制台实时查看Token消耗和余额。当余额不足时,通过官网的Token购买入口充值即可继续使用。这种模式特别适合需要控制成本、灵活分配预算的SaaS团队。你可以随时查看每个模型的使用量,对不同模型进行合理的资源规划。
此外,千聚平台还提供了API Key的权限管理功能,支持创建多个子密钥,分别赋予不同的模型权限或额度限制,方便企业团队协作管理。
常见问题与排查思路
在实际接入过程中,可能会遇到一些常见问题,这里整理了一份快速排查清单:
- 401 Unauthorized:请检查API Key是否填写正确,或是否在千聚后台重新生成了新密钥而未同步更新代码。
- 404 Not Found:确认Base URL是否包含
/v1路径,以及模型名称是否在千聚支持的模型列表中。 - 请求超时:检查网络环境是否能够正常访问千聚的网关域名,部分地区可能需要配置代理。
- 模型返回错误:确认Token余额是否充足,或模型是否处于维护状态,可登录千聚控制台查看状态公告。
如果以上排查仍无法解决,可以访问 立即访问千聚 查看最新文档或联系客服支持。
接下来,你可以这样做:
- 前往千聚官网查看完整的模型列表,了解当前支持的模型名称和版本。
- 在控制台购买Token,为你的API Key充值,确保可以正常调用。
- 阅读更详细的API接入教程,了解流式输出、函数调用等高级用法。
- 将Base URL配置文档分享给团队成员,统一接入标准。
通过以上三个核心步骤——注册获取API Key、配置Base URL与模型名称、编写代码发起调用,SaaS接入多模型API平台怎么接入的问题已经得到了清晰的解答。千聚AI中转站通过统一的接口设计,降低了多模型调用的复杂度,让开发者可以把更多精力放在业务逻辑上。现在就开始你的第一次测试调用吧。
- 千聚官网与模型列表
- Token购买与充值指南
- API接入教程与代码示例
- OpenAI兼容接口配置说明
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~