注册账号并获取API Key
首先,需要在千聚AI中转站完成注册。访问 千聚AI中转站官网 后,点击注册按钮,填写邮箱并设置密码即可创建账号。注册成功后,登录控制台,在“API Key管理”页面可以生成专属的API Key。这个Key相当于你的身份凭证,后续所有模型调用都需要用它进行鉴权。
获取API Key的步骤非常简单:
- 登录千聚控制台,进入“API Key”菜单。
- 点击“新建API Key”,系统会自动生成一串密钥字符串。
- 复制并保存好Key,页面关闭后无法再次查看完整内容。
建议将API Key存储在环境变量中,避免硬编码在代码里,提高安全性。
配置Base URL和模型名称
API聚合平台的核心优势在于统一入口。使用千聚时,你不需要为每个模型单独配置不同的接口地址,只需要记住一个Base URL即可。千聚的Base URL通常格式为:https://api.token88.cc/v1。注意,这个地址末尾的/v1不能省略,它对应的是OpenAI兼容接口的路径。
模型名称则根据你实际需要调用的模型来填写。例如,如果你需要调用GPT-4o,模型名就是gpt-4o;如果需要调用Claude 3.5 Sonnet,模型名就是claude-3-5-sonnet-20241022。千聚支持市面上绝大多数主流模型,具体模型列表可以在 立即访问千聚 查看最新文档。
以下是一个简单的配置对照表,帮助你快速理解:
| 配置项 | 千聚示例值 | 说明 |
|---|---|---|
| Base URL | https://api.token88.cc/v1 | 所有模型通用,无需切换 |
| API Key | sk-xxxxxxxxxxxxxxxxxx | 在控制台生成,每个账号唯一 |
| 模型名称 | gpt-4o / claude-3-5-sonnet / deepseek-chat | 根据需求选择对应模型名称 |
这种统一配置方式,大幅降低了接入多个模型的复杂度,尤其适合需要频繁切换模型的开发团队。
用Python发起一次模型调用
配置好API Key、Base URL和模型名称后,就可以开始测试了。以下是使用Python的openai库进行调用的示例代码,代码已精简,只展示核心三个参数:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的API Key",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "你好,请介绍一下你自己。"}
]
)
print(response.choices[0].message.content)
运行这段代码后,如果配置正确,你会收到模型返回的回复。如果遇到报错,请检查以下几点:
- API Key是否包含多余空格或换行。
- Base URL是否以
/v1结尾。 - 模型名称是否与千聚官方文档中列出的名称完全一致。
从注册账号到成功调用,整个过程不超过十分钟。千聚的兼容设计让熟悉OpenAI接口的开发者可以无缝迁移,无需学习新的调用方式。
管理Token余额与模型切换
在千聚控制台中,你可以实时查看Token消耗情况和账户余额。当余额不足时,可以购买Token继续使用。千聚支持按量计费,适合不同规模的调用需求。同时,你可以在代码中随时切换模型名,例如将gpt-4o改为claude-3-5-sonnet,就能调用不同模型,而无需修改Base URL或API Key,非常便于统一管理。
对于企业团队,千聚还提供了多Key管理和权限控制功能,让不同成员各自使用独立的Key,方便审计和成本分摊。
立刻开始你的第一次调用
API聚合平台的接入并不复杂,关键在于理清API Key、Base URL和模型名称这三个参数。千聚AI中转站通过提供统一的OpenAI兼容接口,让你在几分钟内完成配置并开始调用多种主流模型。如果你还没有尝试过,现在就可以访问官网,获取API Key并测试一次模型调用。