从 OpenAI 迁移
已有代码或客户端原本直连 OpenAI 风格接口时，通常只需要改三处：Base URL、API Key、模型 ID。改动前先备份原配置。
改动对照
| 项目 | 原来（OpenAI 官方） | 改为（牛API） |
|---|---|---|
| Base URL | https://api.openai.com/v1 | https://api.reniuniu.win/v1 |
| API Key | OpenAI 后台创建的 Key | 牛API控制台创建的专用 Key |
| 模型 ID | 官方模型名 | 牛API控制台展示的真实模型 ID |
路径部分（/v1/chat/completions 等）保持不变，只替换域名。
注意 Base URL 的两种写法
不同客户端对地址栏的要求不同，替换前先看清原来填的是哪种：
- 原来是
https://api.openai.com/v1→ 改为https://api.reniuniu.win/v1； - 原来是
https://api.openai.com（客户端自动拼/v1）→ 改为https://api.reniuniu.win。
只替换一半（路径里出现 /v1/v1/... 或缺少 /v1）是最常见的迁移错误，表现为 404，对照拼接规则检查。
认证方式不变
仍然是 Authorization: Bearer YOUR_API_KEY，只把 Key 换成牛API控制台创建的专用 Key：
- 不要继续填 OpenAI 官方 Key，它不属于牛API；
- 客户端只要求填 Key 时，不要手动加
Bearer前缀； - 建议借机按客户端拆分 Key，不再共用一个长期 Key，见 API Key 与分组。
模型 ID 不能照搬
这是迁移最容易漏掉的一步：原配置里的官方模型名不一定存在于牛API。必须打开牛API控制台，逐字复制当前可用的真实模型 ID；不同供应商的相似模型名不要混用。文档未录入真实清单前，以控制台展示为准。
迁移后验证
- 并发设为
1，发送请只回复：牛API连接正常； - 确认响应正常，并回控制台核对用量记录；
- 再逐步恢复原配置中的流式、工具调用、图片输入等能力——这些能力按模型和协议逐项验证，状态见兼容性矩阵；
- 出现错误时按常见错误定位，重点区分是地址、Key、模型 ID 还是协议问题。
迁移不等于能力一致
牛API是独立服务，协议支持范围、可用模型和行为细节与 OpenAI 官方可能存在差异。未经完整验证的能力均标记为“待验证”或“实验性”，不要假设原功能全部可用。