第一步:准备千聚账号并获取API Key
在开始调用之前,需要先有一个可用的千聚账号,并且在控制台中拿到API Key。操作步骤如下:
- 访问 千聚AI中转站官网,完成注册。
- 登录后,在控制台找到“API Key管理”,创建一个新的Key并复制保存。注意API Key等同于访问凭证,不要提交到公开代码库。
- 检查账户Token余额。如果余额为空,需要先购买Token,才能发起实际请求。千聚支持按量购买和余额管理,便于开发阶段灵活控制成本。
完成这三步后,你就拥有了配置客户端所需的核心信息。
第二步:配置Base URL和模型名称
千聚兼容OpenAI调用方式,因此在你的代码里,主要修改三个参数:API Key、Base URL和model。
一个最简的Python示例:
from openai import OpenAI
client = OpenAI(
api_key="你的千聚API Key",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-5.1",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
其中,Base URL是请求的入口地址,API Key用于身份校验,model指定你使用的模型。三个配置点对应关系:
| 配置项 | 示例值 | 作用 |
|---|---|---|
| API Key | sk-xxxx | 身份认证 |
| Base URL | https://api.token88.cc/v1 | 请求地址 |
| model | gpt-5.1 | 选择模型 |
注意:GPT-5.1的具体模型名可能带版本后缀,建议以 千聚官网 的模型列表为准。这里只是演示配置方式。
第三步:常见接入问题排查
如果第一次调用没通过,优先检查这三类情况:
- 401 Unauthorized:API Key错误、缺失或已过期,重新复制即可。
- 404 Not Found:Base URL路径写错,确认是否漏了/v1;或者model名称并不存在。
- 余额不足或超额:到千聚