OpenAI-compatible API / New API 迁移排错：base URL、Key、模型名一次配对

很多客户端支持 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 或业务代码。

按错误类型排查

  1. 401或unauthorized：检查 Bearer 格式、Key 是否完整、是否误用了其他平台的 Key。
  2. model not found：重新从当前模型目录复制实际模型 ID。
  3. 请求成功但业务异常：分别测试 stream、工具调用、长输出和超时。
  4. 成本或路由不符合预期：检查请求日志、余额记录和实际模型名。

上线前检查

  • 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