AI故障手册prompt cache 头写错导致 400
cache_control 字段版本要配对。
阅读(26)赞 (0)
配置指南 第49页
API Key、Base URL、环境变量、模型 ID
system 写成第一条 user 的差别
OpenAI 用 system 角色，Anthropic 用 top-level system。
阅读(34)赞 (0)
给 CLI 指定 DNS（Bedrock）
系统 DNS 被 fake-ip 污染。 场景：Bedrock。custom DNS。
阅读(24)赞 (0)
关掉校验证书只作临时对照（Together）
长期关校验不安全。 场景：Together。verify SSL。
阅读(22)赞 (0)
客户端 max_retries=0 看起来像一次性失败（Gemini）
先开有限重试。 场景：Gemini。max_retries。
阅读(24)赞 (0)
429 要读 Retry-After（Kimi）
狂重点火会更久。 场景：Kimi。Retry-After。
阅读(22)赞 (0)
超时单位秒和毫秒写反（OpenRouter）
15 被当成 15ms。 场景：OpenRouter。timeout unit。
阅读(30)赞 (0)
tool_choice=required 但没定义 tools
required 却空 tools 数组会 400。
阅读(26)赞 (0)
logprobs 该模型不支持
补全模型才有 logprobs，聊天模型会 400。
阅读(28)赞 (0)
stop_reason=max_tokens：输出被自己截断
把 max_tokens 加大，不是模型删了后半。
阅读(24)赞 (0)