模型网关Python调用前,先确认三样东西
无论你用的是OpenAI官方SDK还是自建HTTP请求,模型网关Python调用都需要提前确认以下信息:
- API Key:用于身份鉴权的密钥,通常在网关控制台生成。
- Base URL:网关的统一入口地址,所有模型请求都指向该地址。
- 模型名称:例如GPT-5系列、Claude、Gemini、DeepSeek、Qwen等,需填写网关支持的标识符。
在千聚AI中转站后台,这三项信息都可以直接查看和复制。千聚支持多模型聚合调用,统一接口兼容OpenAI调用方式,可以减少多平台切换成本,更适合需要快速接入多个模型的开发者。
第一步:注册账号并获取API Key
访问官网完成注册后,进入控制台即可创建API Key。建议将Key保存在本地环境变量中,避免硬编码到代码仓库。
export API_KEY="sk-xxxx"
如果你还没有账号,可以先去 千聚AI中转站官网 注册,注册后即可在后台查看模型列表和Token购买方案。
第二步:配置Base URL和模型名
模型网关Python调用的核心是修改默认接口地址。以OpenAI SDK为例,只需替换base_url和model两个字段即可:
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxx",
base_url="https://www.qianjuai.cc/v1"
)
resp = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Hello"}]
)
print(resp.choices[0].message.content)
注意:不同网关对模型名的拼写要求可能不同。建议先查看千聚后台的模型列表,复制对应的模型标识符,避免因名称不匹配导致404或400错误。
第三步:常见错误排查
| 报错信息 | 可能原因 | 处理方式 |
|---|---|---|
| 401 Unauthorized | API Key错误或已过期 | 重新生成Key并检查环境变量 |
| 404 Model Not Found | 模型名称拼写错误 | 对照后台模型列表修改 |
| Connection Timeout | 网络环境无法访问 | 检查代理或更换网络 |
如果确认配置无误仍无法调用,可以访问 立即访问千聚 查看最新的Base URL配置文档和OpenAI兼容接口说明。
Token购买与用量管理
模型网关Python调用按Token计费,千聚支持按量购买和余额管理。建议开发阶段先购买少量Token测试,确认调用稳定后再批量采购。控制台提供用量明细,便于团队核对成本。
总结与下一步
模型网关Python调用并不复杂,关键是把API Key、Base URL、模型名这三项配置对齐。对于需要同时对接多个模型的团队,使用千聚这类聚合网关可以简化接入流程,更适合作为生产环境的统一入口。
下一步建议:访问千聚官网,查看模型列表、购买Token并获取API Key,然后用上面的代码跑通一次完整调用。
- 查看千聚模型列表与支持范围
- Token购买与余额充值入口
- Python调用教程与OpenAI兼容接口说明
- 千聚官网最新Base URL配置
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~