OpenAI 兼容接口接入指南
现在不少模型服务都会提供 OpenAI 兼容接口，但“兼容”不等于“完全一样”。如果你不先确认 baseURL、模型名和字段差异，接入时很容易卡在细节上。
拿到 OpenAI 兼容地址后，怎么替换 baseURL、鉴权和模型名，快速跑通最小调用。
适合谁看
适合正在接第三方模型 API、做兼容层、排线上报错的开发者和团队。
这篇会回答
• 最先要改的是地址、Key 和模型名
• 兼容层通常不是所有字段都一致
• 把兼容接口当成一层可替换能力
这篇在专题里的位置
围绕 401、402、429、503、504、流式输出、兼容接口、Key 管理和网关接入，先解决“能不能稳定跑起来”。
Claude API 接入清单
从模型选择、请求结构到限流与日志，梳理一份更稳的接入流程。
Claude acceleration limits 是什么，为什么刚放量就 429
根据 Anthropic 官方文档，拆开讲 acceleration limits、短时间突发流量和 rate limit 的区别，方便你判断为什么总量没超、请求还是被卡。
Claude API 401 authentication_error 怎么排查
根据 Anthropic 官方错误文档和 API 接入说明，拆开讲 Console Key、请求头、版本头和代理转发问题，方便你快速定位 Claude API 的 401 authentication_error。
最先要改的是地址、Key 和模型名
如果你已经有一套基于 OpenAI SDK 的代码，首轮改造通常只需要替换 baseURL、API Key 和模型标识。
但这里最容易忽略的是模型名，很多服务虽然兼容请求格式，模型 ID 却和你原来的写法完全不同。
兼容层通常不是所有字段都一致
有些服务支持基础聊天接口，但不一定完全支持函数调用、结构化输出或特定参数。
因此不要默认高级能力也能直接平移，最好先从最小聊天请求开始，再逐项验证你依赖的能力。
先跑最小 messages 请求
再检查流式输出是否可用
再确认结构化输出字段是否支持
最后再接入业务里的复杂链路
把兼容接口当成一层可替换能力
工程上更稳的做法，是把上游模型封装成统一 provider 层，而不是把 SDK 调用散落在业务代码里。
这样未来换模型、换供应商或上多模型路由时，你只需要调整一层适配，而不用全站回收。
常见问题
OpenAI 兼容是不是表示可以 100% 原样替换？
不能这么理解。兼容通常指基础请求格式接近，但模型能力、参数支持范围和返回细节仍可能不同。
SDK 提示某个字段不支持怎么办？
先回退到最小可用请求，确认接口本身通了，再逐步加回你依赖的字段，定位到底是兼容层差异还是 SDK 封装问题。
继续沿着这条主线看
这部分不再重新给你一堆大卡片，而是直接把下一步阅读顺序列出来，方便继续往下走。
Claude API 接入清单
从模型选择、请求结构到限流与日志，梳理一份更稳的接入流程。
Claude acceleration limits 是什么，为什么刚放量就 429
根据 Anthropic 官方文档，拆开讲 acceleration limits、短时间突发流量和 rate limit 的区别，方便你判断为什么总量没超、请求还是被卡。
Claude API 401 authentication_error 怎么排查
根据 Anthropic 官方错误文档和 API 接入说明，拆开讲 Console Key、请求头、版本头和代理转发问题，方便你快速定位 Claude API 的 401 authentication_error。
Claude API 529 overloaded 怎么处理
根据 Anthropic 官方错误文档、Rate Limits 和状态页，拆开讲 529 overloaded 与 429、401 的区别，以及线上更稳的重试、降级和观察路径。