AI故障手册Content-Type 漏 charset（xAI）
中文 body 被网关误解析。 场景：xAI。charset=utf-8。
阅读(5)赞 (0)
配置指南 第5页
API Key、Base URL、环境变量、模型 ID
API 用了 http:// 被重定向丢头（Qwen）
强制 https。 场景：Qwen。http API。
阅读(3)赞 (0)
路径写成 /v1/v1（OneAPI）
根地址已含 /v1 又拼一次。 场景：OneAPI。/v1/v1。
阅读(4)赞 (0)
Base URL 末尾 # 导致路径丢失（Dify）
Cherry 常见。 场景：Dify。Base URL hash。
阅读(4)赞 (0)
Key 放错头：Authorization vs x-api-key（Ollama）
Anthropic 和 OpenAI 头不同。 场景：Ollama。x-api-key。
阅读(6)赞 (0)
客户端 timeout 设太短会误报网络错误
本地 15s 超时碰上慢模型，看起来像 Network Error。
阅读(6)赞 (0)
ALL_PROXY=socks5 时 CLI 不认 DNS
socks5 和 socks5h 差在是否远程解析。
阅读(5)赞 (0)
HTTP_PROXY 指到 HTTPS 端点会握手失败
代理环境变量协议和上游不一致。
阅读(4)赞 (0)
代理乱解 gzip 导致 JSON 花了
中间盒对 API 做了错误解压，body 会变成乱码而不是 401。
阅读(4)赞 (0)
OpenAI Organization 和 Project 头不要填错租户
organization 头指向无权限项目时像 401。
阅读(7)赞 (0)