配置教程
OpenAI 兼容 API 配置：Base URL、API Key 和 Model ID 分别填什么
用最少概念理解 OpenAI 兼容接口的三个核心参数，并排查最常见的 401、404、429 与浏览器跨域问题。
三个参数各自负责什么
Base URL 决定请求发到哪家供应商；API Key 证明你有权限使用该账号；Model ID 指定具体模型。模型的展示名称不一定等于 API Model ID，复制时应使用供应商文档或模型详情页提供的标识。
- Base URL：例如供应商的 /v1 兼容入口。
- API Key：只保存在本地环境变量或加密 Vault。
- Model ID：区分大小写和路径，不能凭模型名称猜测。
为什么兼容 OpenAI 仍然可能不能直接运行
“兼容”通常只覆盖主要请求格式，不保证模型参数、工具调用、图像输入、流式返回和错误格式完全一致。有些供应商也会阻止浏览器跨域请求，这不代表 Key 无效，而是需要从本地工具或服务器发起请求。
按状态码快速定位问题
401 或 403 通常与 Key、权限或组织有关；404 常见于 Base URL 或 Model ID 错误；429 表示额度或速率限制；5xx 更可能是供应商暂时故障。排查时先使用最小请求，不要一开始就带复杂工具调用。
从在线测试迁移到本地工具
在 Playground 中确认供应商、模型和 Key 能工作后，使用页面下方的配置生成器复制同一组 Base URL 与 Model ID。Key 建议写入本机环境变量，而不是直接写入可同步或提交的配置文件。