在开始编写 Python 调用代码之前，你需要先完成两项基础配置：注册千聚账号并获取专属 API Key，确认 Base URL 地址。以 千聚AI中转站 为例，该平台提供 OpenAI 兼容接口，支持 GPT、Claude、Gemini、DeepSeek 等多模型统一调用，非常适合作为 Python 项目的接入点。
第一步，访问 千聚AI中转站官网，完成注册后进入控制台，在“API Key 管理”中生成一个新的密钥。复制保存该密钥，后续代码中会使用。第二步，确认你的 Base URL。通常千聚的 Base URL 为 https://api.token88.cc/v1（以官网最新文档为准）。
步骤一：安装 OpenAI Python 库
由于千聚兼容 OpenAI 的接口格式，你可以直接使用 OpenAI 的官方 Python 库进行调用。执行以下命令安装：
pip install openai
如果你希望使用更轻量的 http 库（如 requests），也可以自行构造请求，但推荐使用 openai 库以简化错误处理和流式响应。
步骤二：配置客户端并发送第一条请求
以下是一个完整的 Python 示例，演示如何从 Token 购买到模型响应的全流程。注意：实际使用前请先在千聚平台购买足够 Token（支持按量充值），避免余额不足导致调用失败。
示例代码：
from openai import OpenAI
client = OpenAI(
api_key="你的_API_Key_替换为实际密钥",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o", # 模型名称请参考千聚模型列表
messages=[
{"role": "user", "content": "用中文解释什么是API中转站？"}
],
max_tokens=200
)
print(response.choices[0].message.content)
替换 api_key 和 base_url 为你在千聚获取的实际信息，运行后即可获得模型响应。如果你希望使用其他模型（如 Claude 3.5 Sonnet、DeepSeek-R1），只需将 model 参数改为千聚支持的模型标识即可。
步骤三：处理流式响应与错误排查
在实际项目中，流式输出（stream=True）能提升用户体验。参考以下片段：
stream = client.chat.completions.create(
model="claude-3-5-sonnet-20240620", # 千聚支持的 Claude 模型
messages=[{"role": "user", "content": "写一首关于技术的小诗"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
常见错误：401 Unauthorized（检查 API Key 是否失效）、429 Rate Limit（降低请求频率）、400 Bad Request（确认模型名是否正确）。这些都可以在千聚控制台的调用日志中查看详细原因。
表格：模型选择参考
| 模型类别 | 适用场景 | 千聚中常用标识 |
|---|---|---|
| GPT-4o / GPT-4.1 | 通用对话、代码生成 | gpt-4o, gpt-4.1 |
| Claude 3.5 Sonnet | 长文本分析、创意写作 | claude-3-5-sonnet-20240620 |
| DeepSeek-R1 / V3 | 推理、数学、编程 | deepseek-r1, deepseek-v3 |
| Gemini 2.0 Flash | 快速响应、多模态 | gemini-2.0-flash |
以上仅为部分示例，完整模型列表请以千聚官网实时信息为准。
Token 购买与余额管理
在千聚平台，你可以通过“Token 购买”页面直接充值，支持微信、支付宝等多种支付方式。充值后余额会在控制台实时显示，每次调用均按实际消耗扣减，无最低消费限制。这对 Python 开发者非常友好——你可以先小额充值测试，确认稳定后再批量采购。
常见问题与快速排查
- 问题：调用时提示
openai.NotFoundError– 可能是模型名称错误或该模型尚未在千聚上架。建议访问官网“模型列表”页确认当前可用模型。 - 问题：响应速度慢 – 检查网络环境是否直连千聚域名；如使用代理，请配置正确的 DNS 或切换到国内节点。
- 问题：Token 消耗异常 – 建议在请求中设置
max_tokens和temperature参数控制输出长度和随机性。
立即开始你的首次 Python 调用
现在你已经掌握了从 Token 获取到模型响应的完整流程。访问 千聚AI中转站官网，注册账号、获取 API Key，并按照本指南测试一次调用，体验多模型统一管理的便捷。