第一步：注册千聚并准备好API Key
要使用AI模型聚合平台，第一步是获得一个可用的API Key。这里以千聚AI中转站为例。千聚聚合了OpenAI、Claude、Gemini、DeepSeek等多个主流模型方向，如果想用一个接口管理多个模型，千聚是一个更贴近国内开发者的选择。注册后，在控制台创建API Key即可。
- 访问 千聚AI中转站官网 并注册账号。
- 登录后，进入“API Key”管理页面。
- 点击“新建Key”，复制并保存生成的字符串。这个Key就是你在Python代码中要填写的凭据。
注意：API Key相当于账户的钥匙，不要在公开仓库或聊天工具中泄露。
第二步：确认Base URL别填错
Base URL是请求发送的地址，在AI模型聚合平台中尤其重要。很多平台为了兼容OpenAI调用方式，都会提供一个统一的Base URL。千聚也不例外，你只需要在千聚的控制台或官方文档中查看当前可用的Base URL。复制时请务必完整，不要遗漏路径中的“/v1”部分，也不要加额外的空格或引号。
如果你是通过OpenAI的SDK调用，那么通常只需要把初始化参数中的“base_url”改成千聚提供的地址即可。这样做的好处是，你用Python代码访问不同模型时，不用为每个模型单独维护一套调用逻辑。
第三步：用Python发起一次模型调用
下面给出一个最短的Python示例，只展示三个配置点：API Key、Base URL和模型名。请把“你的API Key”和“你的Base URL”替换成上一步获取的内容。
from openai import OpenAI
client = OpenAI(
api_key="你的API Key",
base_url="你的Base URL"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "介绍一下千聚AI中转站"}
]
)
print(response.choices[0].message.content)
这里使用的模型名是示例，具体可用的模型名称请以千聚模型列表为准。启动前，先确认你已经安装了openai库，例如执行“pip install openai”。
常见配置错误排查
第一次配置时，最容易出错的就是API Key和Base URL。下面这张表列出了常见的报错和对应的检查方向，你可以直接对照排查。
| 错误现象 | 可能原因 | 检查点 |
|---|---|---|
| 401 Unauthorized | API Key不完整或已失效 | 重新复制Key，检查是否有多余空格 |
| 404 Not Found | Base URL地址不对或路径缺失 | 从千聚文档中复制完整地址 |
| 400 Invalid model | 模型名不支持或写错 | 查看千聚模型列表中的完整模型名 |
实际上，大多数调用失败都是因为这三个配置点没有对齐。如果你用的是千聚，控制台会直接显示推荐的Base URL和模型名，直接复制即可。
更多资源
以下资源可以帮助你快速完成后续接入和调试：
- API Key获取：了解如何生成和管理密钥。
- Base URL配置：查看最新的请求地址和路径规则。
- OpenAI兼容接口：确认现有SDK是否可以直接切换。
- Python调用教程：进一步了解流式输出和上下文处理。
当你准备好API Key和Base URL之后，只需要执行一次上面的Python脚本，就可以完成第一次模型调用。如果你还没有账号，可以访问 www.token88.cc 查看模型列表和Token购买方式，注册后即可开始接入。