常见问题与故障排查

按响应定位问题

按响应定位问题

401：检查是否使用 XHub 虚拟密钥、是否过期或被撤销。403：检查模型范围、团队关系和角色。400：核对 JSON、必填字段、公开模型名与接口协议；先保留返回正文。

操作步骤

429：检查 RPM、TPM、额度及上游限流。5xx：使用调用 ID 定位部署、上游错误和超时。浏览器网络失败但 curl 成功时检查网关地址、HTTPS 混合内容和跨域允许来源。

检查与边界

GET /models 是匿名部署发现，GET /v1/models 会应用调用方 XHub 密钥权限。工具连接失败时使用调试台显示的网关根地址，不追加 /v1，并核对工具自行拼接的路径。保留 x-litellm-call-id，媒体任务需区分创建、轮询与下载。