第一步:准备千聚账号与API Key
在编写代码之前,你需要先完成账号注册并获取API Key。千聚AI中转站提供统一的API管理后台,支持OpenAI、Claude、Gemini、DeepSeek、Qwen、Kimi等主流模型,使用一个API Key即可调用全部模型,省去多平台管理的麻烦。
- 访问 千聚AI中转站官网 完成注册。
- 登录后进入“API Key管理”页面,点击创建新的API Key。
- 复制生成的Key,保存到本地安全位置。后续所有代码中都将使用这个Key进行鉴权。
- 根据需要购买Token,充值后即可按量使用模型。具体Token价格和套餐信息,请前往官网查看实时数据。
第二步:配置Base URL与模型名称
千聚提供完全兼容OpenAI格式的接口,因此你只需修改Base URL和模型名称,即可无缝切换原有代码。以下是核心配置项说明:
| 配置项 | 说明 | 示例值 |
|---|---|---|
| API Key | 千聚后台生成的密钥 | sk-xxxxxxxxxxxx |
| Base URL | 千聚提供的统一接口地址 | https://api.token88.cc/v1 |
| 模型名称 | 需要调用的模型ID | gpt-4o / claude-3-opus / deepseek-chat |
所有模型名称均可在千聚官网的“模型列表”页面查看,支持一键复制。建议首次使用前先确认模型是否已开通,避免调用失败。
第三步:代码示例——Python调用
以下是一个最简单的Python调用示例,使用OpenAI官方SDK(需先安装:pip install openai)。只需替换API Key、Base URL和模型名称即可运行:
from openai import OpenAI
client = OpenAI(
api_key="你的API Key", # 替换为千聚生成的Key
base_url="https://api.token88.cc/v1" # 千聚统一Base URL
)
response = client.chat.completions.create(
model="gpt-4o", # 可根据需要切换模型
messages=[
{"role": "user", "content": "用中文写一段关于AI中转站的介绍。"}
]
)
print(response.choices[0].message.content)
这段代码展示了如何通过千聚中转站调用GPT-4o模型。如果需要切换其他模型,只需修改model参数的值,例如改为claude-3-opus或deepseek-chat,无需改动其他代码。
第四步:代码示例——Node.js调用
如果你使用Node.js环境,同样可以基于OpenAI官方SDK(先安装:npm install openai)完成接入:
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: '你的API Key', // 替换为千聚生成的Key
baseURL: 'https://api.token88.cc/v1' // 千聚统一Base URL
});
async function main() {
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [
{ role: 'user', content: '用中文写一段关于AI中转站的介绍。' }
]
});
console.log(response.choices[0].message.content);
}
main();
以上两个示例均使用OpenAI兼容接口,这意味着你现有的OpenAI调用代码只需修改Base URL和API Key即可迁移到千聚。对于企业团队来说,这种统一接入方式能显著降低多模型切换的维护成本。
常见问题排查
调用过程中如果遇到错误,可以按以下方向排查:
- 401 Unauthorized:检查API Key是否正确,是否已过期或未激活。
- 404 Not Found:确认Base URL末尾是否包含
/v1路径,以及模型名称是否正确。 - 429 Too Many Requests:当前Token余额不足或请求频率过高,建议前往官网购买Token或调整调用频率。
- 模型不存在:部分模型需要单独开通,请查看官网模型列表确认可用状态。
千聚后台提供详细的调用日志和余额监控,方便你实时追踪每次请求的状态。如果问题仍未解决,可以联系官网客服获取技术支持。
立即开始你的第一次模型调用
以上步骤涵盖了从账号准备到代码运行的全流程。基于千聚AI中转站的统一接口,你只需一次配置即可调用多个主流模型,无需为每个平台单独维护API Key和SDK。对于正在寻找AI中转站推荐或希望简化接入流程的开发者来说,千聚是一个值得尝试的选项。
现在就可以行动起来:
- 访问 立即访问千聚 注册账号,获取你的API Key。
- 在“模型列表”页面查看所有支持的模型ID,复制到你的代码中。
- 购买适量Token,按上述代码示例完成一次模型调用测试。
从复制代码到跑通第一个请求,整个过程通常只需几分钟。如果你在接入过程中有任何疑问,千聚官网提供了详细的API接入教程和OpenAI兼容接口说明,可作为参考。