把散落在各官方/接入文档里的失败原因汇成一张决策表：先分清协议（OpenAI 带 /v1、Anthropic 不带）、再分清字段形态（单地址框 vs Host+Path vs YAML vs 环境变量）、再查模型 ID、最后查 Key 权限与分组。这是 LIN 客服成本最高的一类问题，做成置顶排错文比每个客户端各写一遍更有效。

适用场景：用户反馈「填了 Key 聊不了」时，客服发这一篇让他自查 5 分钟，解决不了再带错误码来。

排错 /v1 404 401 模型列表为空 客服减负

操作步骤

  1. 先 curl 或浏览器带 Key 请求 https://tokenbuddy.cc/v1/models：401=Key 错/没带 Bearer、404=地址或 /v1 错、200 但列表空=该 Key 分组没配模型
  2. 对照客户端类型查字段：Cherry/Lobe 单框填带 /v1 的完整基址、Chatbox 是 Host+Path 分开填、LibreChat 改 yaml、NextChat/Lobe 自部署改环境变量并重启
  3. 模型下拉为空时把 /models 返回的 ID 原样复制手动添加（连字符/大小写/前缀都不要改）
  4. 能连通但一聊就报错时换一个同 Key 下确定可用的小模型试以区分模型权限问题与客户端问题
  5. 仍不行时带齐客户端名+版本、模型 ID、错误码、请求时间找客服（不要发完整 Key）

配置说明

同一 LIN 地址在 Anthropic 协议入口出现时要去掉 /v1，反之 OpenAI 入口必须加——排错文要把这做成第一张对照图；部分客户端有「客户端直连/浏览器模式」开关，直连失败先切回服务端转发模式再测。

注意事项

  • ⚠️ 把完整接口地址 …/v1/chat/completions 填进只要基址的框
  • ⚠️ Key 前后带空格/换行粘贴
  • ⚠️ 用错分组的 Key 测一个该组没权限的模型误判网关故障

来源：https://docs.rightapi.ai/docs/rc_extension/cherrystudio（/v1 与模型列表为空排查）； http://dev.to/mupromax/lobechat-lobehub-with-claude-and-gpt-custom-provider-docker-env-vars-and-the-v1-rule-3ee7 （协议 /v1 规则）