第一步:在千聚获取API Key
首先要在千聚平台完成账号注册和登录。登录后进入控制台,找到“API Key”或“令牌管理”入口,点击创建即可生成属于你的Key。这个Key通常是一串类似 sk-xxxxxxxx 的字符串,它相当于调用模型时的身份凭证。
在 千聚AI中转站官网 上,API Key的管理页面通常会提供复制按钮,建议创建后立即保存到本地,注意不要泄露给他人。如果后续Key有异常,也可以在同一个页面进行重置或删除。
第二步:理解三个关键配置项
无论你使用的是OpenAI官方接口、各类AI中转站,还是类似千聚这样的聚合平台,在代码里需要填的核心配置始终是这三个:
| 配置项 | 含义 | 示例值 |
|---|---|---|
| API Key | 身份认证凭证 | sk-xxxxxx |
| Base URL | 接口请求地址 | https://api.example.com/v1 |
| Model | 你要调用的模型名称 | gpt-4o、claude-3-5-sonnet等 |
在千聚这类兼容OpenAI接口的平台上,Base URL通常就是一个固定地址,而模型名需要参考平台提供的模型列表。不同平台的命名可能有差异,所以“怎么填”的关键,是先去查阅平台最新的模型列表文档。
第三步:在代码中正确填写API Key
下面以OpenAI Python SDK为例,展示如何把千聚的配置填进去。注意大多数中转站都支持OpenAI格式,因此代码结构几乎一致:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的千聚APIKey",
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 填的就是你从千聚获取的Key,base_url 填千聚提供的接口地址,model 则根据你想用的模型来写。记住,很多聚合平台要求模型名必须是“平台内部名称”,比如可能写作 gpt-4o-2024-11-20,建议在千聚官网查询对应列表。
第四步:从“能填”到“能用”的衔接技巧
很多用户卡在API Key填完却调用失败,问题往往不是Key本身,而是配置衔接出了问题。比如:
- Base URL尾部忘了加
/v1,导致路径不匹配。 - 模型名使用的是OpenAI官方名称,但聚合平台里实际名称略有不同。
- 服务器时钟偏差较大,导致签名校验失败。
- 本地网络无法直连部分境外接口,可能需要使用代理或国内可访问的入口。
千聚把多模型调用统一到一个Base URL下,并保留OpenAI的请求格式,对开发者来说,最大的好处是无需为每个模型维护独立的SDK或鉴权逻辑。你只需要在代码里切换model字段,就能调用不同方向的大模型,比如GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi等。这种模式下,API Key的填写只需要一次,后续基本就是换模型名的事。
第五步:验证是否配置成功
填写完成后,建议先用一个最小的请求做连通性测试,比如上面那段代码。如果返回内容正常,说明API Key、Base URL和模型名已经对齐。如果报错,优先检查三件事:
- API Key是否复制完整 —— 前后有没有多空格,或者少字符。
- Base URL是否与千聚文档一致 —— 有些平台改版后会更新地址。
- 模型名是否存在于平台列表中 —— 可在千聚的控制台或模型列表页面确认。
另外,千聚也支持Token购买和余额管理。当你需要测试不同模型时,建议先少量充值,确认调用链路跑通后再按需使用。这样可以避免因配置问题导致不必要的消耗。
现在就可以开始接入:访问 立即访问千聚 注册账号,获取你的专属API Key,然后查看模型列表,选一个模型发起你的第一次调用。如果你需要更详细的Base URL配置说明和不同语言的接入示例,也可以直接在官网文档中找到对应教程。
- 千聚官网
- 千聚模型列表与Token购买入口
- OpenAI兼容接口配置教程
- Python/Node.js调用千聚的示例