客户端配好了，一测连不上；或者聊天框转半天，最后蹦出一个看不懂的报错。十次里九次不是客户端坏了，而是中间某一环没对上。这篇把最常见的几类问题汇成一张速查清单，按现象对号入座，多数问题两分钟内能自己解决。
先分清：问题出在哪一段？
一个 AI 客户端要跑通，中间隔着几段：客户端配置 → 本地网络 → API 地址 → 服务端。排查的正确姿势是先看返回信息再动手：有明确报错码（比如 401、429），说明请求已经到了服务端，问题出在密钥或额度上；一直转圈、超时、connection refused，多半是地址填错或本地网络、代理在作怪。先定位在哪一段，再对症下药，比挨个乱试快得多。
口诀：有报错码查密钥和额度，连不上查地址和代理，回复为空查模型名。
高频问题速查
连不上、一直转圈：先检查 API 地址有没有漏掉 /v1 后缀或多写了尾斜杠；再确认本地代理设置——客户端里该开代理没开、不该走代理却强制走了，都会断连。一个小技巧：用浏览器直接打开 https://www.aigcbreeze.cn 能正常访问，说明本机网络没问题，问题大概率在客户端的地址或代理配置上。
报 401 Unauthorized：密钥复制时带了空格或换行符、令牌用错、或者令牌已被删除。回到控制台重新完整复制一遍密钥，注意别多选首尾字符。
报 429 或提示限流：短时间内请求太密。把并发数降下来，或隔一会儿再试。
回复为空或秒断：模型名写错最常见——大小写、拼写、版本号都要和模型列表页逐字一致；另外给不带 vision 能力的模型发图片，也会直接报错或返回空。
常见问题
换个网络就连不上，家里可以公司不行？
大概率是公司网络的防火墙或代理策略拦了请求。先在客户端里手动配置公司代理试试；或者切手机热点验证一次——热点下正常、公司网络下不通，就可以确定是网络环境的问题，找 IT 开白名单即可。
客户端提示余额不足，但账户里明明还有钱？
查两件事：一是客户端里填的令牌是不是单独设了额度上限——令牌额度是独立于账户余额的，用完令牌就停；二是所选模型的单价是否远超预期，长上下文模型跑长文时消耗会被放大，换轻量模型对比一下消耗就清楚了。
流式输出到一半卡住不动怎么办？
先关掉客户端的「流式输出」开关再测一次：能正常出全文，说明是流式链路被中间层（常见于某些代理环境）缓冲截断了，换网络或调整代理即可；关掉流式也没反应，那就回到上面的地址、密钥排查从头走一遍。