首页 / OpenAI Compatible API
OpenAI 兼容 API 接入教程：先把 Base URL 和 Key 填对
大多数客户端接统一网关时都围绕三个字段：Base URL、API Key、Model。字段简单，但错一个就会变成 401、404 或模型不可用。
三个核心字段
| 字段 | 含义 | 示例 |
|---|---|---|
| Base URL | 客户端请求入口 | https://izkl.top/v1 |
| API Key | 个人或项目令牌 | sk-... |
| Model | 网关中开放的模型名 | your-model-name |
为什么 /v1 很重要
OpenAI 兼容客户端通常会在 Base URL 后拼接具体路径。如果你填的是裸域名，客户端可能请求到错误路径；填成 https://izkl.top/v1，路径约定会更清楚。
不同客户端的差异
- Codex：通过
~/.codex/config.toml定义model_providers。 - Cursor：通过编辑器设置填 API Key 和可能的 Base URL，功能覆盖取决于版本和能力入口。
- Cherry Studio：通过模型服务商设置添加 OpenAI 兼容服务商。
- 自写程序：在 SDK 里设置
base_url和api_key。
排错口诀
401 看 Key，403 看权限，404/405 看路径，模型不可用看模型名和渠道，响应格式异常看客户端是否支持对应协议。
常见问题
OpenAI 兼容 API 是什么意思？
客户端按 OpenAI 风格的鉴权、路径和响应格式调用，但实际后端可以是统一网关或其他模型服务。
所有 OpenAI 兼容客户端都一样吗？
不一样。基础聊天通常相似，但工具调用、Responses、Agent 能力和模型列表支持差异很大。