接口配置参考
说明 Base URL、API Key、模型名称和常见客户端字段的填写方式
≡ ON THIS PAGE
三个核心字段
大多数 OpenAI 兼容客户端只需要确认三项：Base URL、API Key 和模型名称。它们分别对应接口地址、访问密钥和实际调用的模型。
| 字段 | 填写示例 | 注意事项 |
|---|---|---|
| Base URL | https://your-api-host.example | 只填写接口域名或统一入口，不要追加 /chat/completions。 |
| API Key | 服务平台 控制台创建的密钥 | 复制后检查前后没有空格、换行或多余引号。 |
| 模型名称 | gpt-5.4 | 必须和控制台可用模型完全一致，大小写和符号都不要改。 |
Base URL 怎么判断
客户端如果提供 OpenAI Compatible、OpenAI API Base、Provider URL、Endpoint 等字段，通常都填写同一个 Base URL。不要把控制台页面地址、官网地址或某个具体接口路径填进去。
API Key 怎么管理
建议每个客户端或每台设备单独创建一个 API Key。这样排查异常用量、撤销失效密钥或更换设备时，不会影响其他工具。
- 不要把 API Key 写进公开仓库、截图、群聊或工单。
- 复制后先在只读任务里测试，不要一开始就跑高消耗任务。
- 怀疑泄漏时立即在控制台禁用旧密钥，并重新创建。
模型名称怎么填写
模型名称以 服务平台 控制台展示为准。客户端内置的默认模型不一定存在，也不一定适合当前入口；出现 model not found、模型不可用或 404 时，优先检查模型名称是否完全一致。
如果你还不确定要选哪个模型，可以先使用教程示例中的通用模型完成连通性测试，再根据成本、速度和能力要求调整。
常见字段对应关系
| 客户端字段 | 对应配置 |
|---|---|
| OpenAI Base URL / API Base / Base URL | Base URL |
| API Key / Token / Secret Key | API Key |
| Model / Model ID / Default Model | 模型名称 |
| Provider Type / API Format | OpenAI Compatible 或 OpenAI |
配置后仍不可用
如果 Base URL、API Key 和模型名称都确认无误，但客户端仍然报错，可以继续查看 常见问题排查，按认证、模型、网络和配置位置逐项定位。