很多客户端支持 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\-HAuthorization: Bearer YOUR_PROJECT_KEY\-HContent-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_sourcecsdnutm_mediumarticleutm_campaignzh_openai_compatible_base_url