很多客户端支持 OpenAI-compatible API。从官方 API、New API 部署或其他中转服务迁移时，代码通常不用重写，真正容易出错的是 base URL、API Key、模型 ID 三个配置来自不同平台。
先把三个配置看成一组：base URL 要确认协议、域名和 /v1 路径；API Key 要使用当前平台创建的项目 Key；model 要从当前平台模型目录复制完整 ID。只替换 base URL、却保留旧 Key 或旧模型名，是 401 unauthorized 和 model not found 最常见的来源。
建议先用最小请求排除客户端问题，再迁回 SDK、LangChain、LlamaIndex 或业务代码。最小请求成功后，再分别测试 stream、工具调用、长输出和超时，不要一次带上全部参数。
常见排查顺序：
1. 401 或 unauthorized：检查 Bearer 格式、Key 是否完整、是否误用了其他平台的 Key。
2. model not found：重新从当前模型目录复制实际模型 ID。
3. 请求成功但业务异常：分别测试必要能力和超时。
4. 成本或路由不符合预期：检查请求日志、余额记录和实际模型名。
上线前确认：最小请求已成功；SDK 使用同一套地址、Key 和模型 ID；日志里能看到正确的项目、模型和用量；Key 只保存在服务端，没有写进前端或公开仓库。
完整中文配置与排查入口可以搜索：TackleKey OpenAI-compatible base URL 中文配置。
