很多客户端支持 OpenAI-compatible API，所以从官方 API、New API 部署或其他中转服务迁移时，代码往往不用重写。真正容易出错的是：base URL、API Key、模型 ID 分别来自不同平台。
先把三个配置看成一组
- base URL：确认协议、域名和
/v1路径。 - API Key：使用当前平台创建的项目 Key，不混用旧平台或官方 Key。
- model：从当前平台模型目录复制完整 ID，不凭记忆填写别名。
只替换 base URL、却保留旧 Key 或旧模型名，是401 unauthorized和model not found最常见的来源。
第一步：用最小 cURL 排除客户端问题
curlhttps://api.tacklekey.com/v1/chat/completions\-H"Authorization: Bearer YOUR_PROJECT_KEY"\-H"Content-Type: application/json"\-d'{"model":"MODEL_ID_FROM_DIRECTORY","messages":[{"role":"user","content":"ping"}]}'最小请求能成功，再把相同的baseURL、apiKey和model迁回 SDK、LangChain、LlamaIndex 或业务代码。
按错误类型排查
401或unauthorized：检查 Bearer 格式、Key 是否完整、是否误用了其他平台的 Key。model not found：重新从当前模型目录复制实际模型 ID。- 请求成功但业务异常：分别测试 stream、工具调用、长输出和超时。
- 成本或路由不符合预期：检查请求日志、余额记录和实际模型名。
上线前检查
- cURL 最小请求已成功。
- SDK 使用同一套地址、Key 和模型 ID。
- stream 等业务能力已单独验证。
- 日志中的项目、模型和用量正确。
- Key 只保存在服务端，没有写进前端或公开仓库。
完整中文配置与排查入口：https://tacklekey.com/zh/guides/openai-compatible-base-url?utm_source=csdn&utm_medium=article&utm_campaign=zh_openai_compatible_base_url