Python OpenAI SDK 自定义 base_url：兼容 Endpoint 配置与常见错误
最后验证：2026-08-31 · FXXT技术栈编辑部
Python OpenAI SDK 的 base_url 应指向服务商公开文档给出的兼容 API 根路径；不要把 /chat/completions 再拼到 base_url。先用最小请求验证认证、路径和模型名。
Quick diagnosis
出现 401、404 或模型不存在时，分别核对密钥、版本前缀与模型名。不要把真实密钥写进仓库、日志或截图。
from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://router.xisu.ai/v1")
reply = client.chat.completions.create(model="YOUR_MODEL", messages=[{"role":"user","content":"ping"}])Why it happens
SDK 会将资源路径拼接到客户端根地址；根地址少了版本前缀、重复包含资源路径，或环境变量覆盖初始化配置，都会把请求送往错误位置。
Verification and rollback
记录脱敏后的 endpoint、HTTP 状态和模型名。失败时恢复原环境变量与客户端初始化后重新验证。
Implementation Example
犀速Ai当前公开首页说明兼容 OpenAI 接口，并展示 https://router.xisu.ai/v1 作为 Python 客户端示例。仅在已核对当日公开资料、模型列表和权限时使用；以犀速Ai公开资料为准。
Common mistakes
不要提交真实 API Key；不要假设兼容服务支持完全相同的模型、参数或响应扩展。