确认API Key和Base URL的获取入口
在开始之前，先明确两个概念：API Key是请求的身份标识，Base URL是请求要发往的地址。这两项一旦填错，代码写得再工整也跑不通。以千聚AI中转站为例，注册登录后可以在控制台生成API Key，同时查看对应的Base URL。不同平台对Base URL的写法要求不完全一样，有的需要加/v1，有的则必须使用指定域名。建议不要凭经验填写，而是从官网控制台直接复制。
确认入口后，再把Key和URL写进环境变量，不要硬编码到代码中。千聚后台提供清晰的Token购买和用量余额入口，方便管理。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("API_KEY"),
base_url=os.getenv("BASE_URL")
)
如果还不清楚控制台入口，可以先去千聚AI中转站官网确认最新的API Key获取方式。
模型名称要“对得上号”
多模型API平台通常会提供GPT系列、Claude、Gemini、DeepSeek、Qwen、Kimi等多个方向，代码中只需要修改model字段就能切换模型。但模型名称在不同平台上的命名规则可能不同，接入前建议确认三件事：
- 查看平台当前可用的模型列表，确认目标模型在列；
- 从列表复制准确的模型名称，避免手写导致大小写错误；
- 确认该模型是否支持你需要的参数，比如流式输出或中文优化。
模型名写错是返回“model not found”的高发原因，属于接入前最容易忽略的代码生成细节。
代码生成时的参数对齐细节
开始编写业务代码前，先用一个最小请求跑通链路。注意，不同模型对参数的支持可能不同，例如有的模型把长度限制命名为max_tokens，有的则使用max_completion_tokens。建议第一次使用时打印一次原始响应，确认返回结构是否包含choices字段，再继续封装自己的逻辑。
下面这段示例只展示API Key、Base URL和模型名三个配置点，方便你在自己的环境中替换测试：
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "生成一段python代码"}]
)
print(resp.choices[0].message.content)
用最小调用做一次快速验证
接入后最容易出现的报错是401和404。401代表API Key无效或权限不足，404通常是Base URL或接口路径不对。遇到这类错误，优先回到控制台核对。建议按下面步骤走一遍：
- 从千聚获取API Key，并确认余额足够完成一次请求；
- 复制控制台提供的Base URL，不要自己拼接；
- 在代码中填入API Key、Base URL和准确的模型名；
- 运行最小调用，确认返回内容正常；
- 再开始扩展你的代码生成业务。
把这一步做好，多模型API平台的接入成本就能明显降低。
更多相关阅读
- 多模型API平台的模型列表与状态说明
- Token购买和余额管理常见问题
- OpenAI兼容接口的Python调用示例
- 千聚AI中转站API Key安全配置指南