先别急着怀疑模型，大多数问题都出在接入细节。

这页把最常见的状态码、流式、变量和 PowerShell 细节集中起来。你遇到问题时可以按目录快速跳到对应位置。

401 / 403：认证失败怎么办

从控制台复制出来的值如果头尾多了空格、换行，服务端通常会直接返回 401。

OpenAI 兼容入口通常使用 Authorization: Bearer ...，而不是自定义 Header。除非你的网关做了特殊约定。

把 OpenAI 兼容请求打到 Anthropic 兼容入口，或者反过来，也会表现成认证失败或请求格式错误。

不要凭印象写模型名。特别是供应商原始名字和你网关里的别名可能完全不同。

先选一个明确可用的模型，把认证和路由打通，再换成你真正想用的型号。

如果后台有限额、套餐或余额控制，429 可能表示额度耗尽，而不是接口本身崩了。

同一 Key 在短时间内并发太高，也可能触发速率限制。给客户端加指数退避会更稳。

如果你前面还套了 Nginx、CDN 或企业网关，要确认它们没有把响应缓冲起来。

如果普通 JSON 响应没问题，再单独调流式会更容易定位问题是在网关还是客户端。

PowerShell 对引号和多行转义的处理跟 Bash 不一样。先把变量单独赋值，再去调命令，通常会顺很多。

如果测试 payload 很长，可以先构造对象，再用 ConvertTo-Json。文档里为了直观展示，示例才保持在最短写法。

把你请求的是 OpenAI 兼容地址还是 Anthropic 兼容地址写清楚。

提供实际请求里的模型 ID，而不是口头描述。

至少保留状态码、错误消息和请求时间，排查速度会快很多。

一条最小可复现 curl 命令，往往比大段聊天记录更有帮助。