401、无效令牌或未授权？
确认应用读取到完整 API Key，没有空格、引号或掩码字符。检查启用状态、期限与认证格式，查看API 鉴权。
403、禁止访问或模型无权限？
核对账户、密钥模型限制、分组与出口 IP 白名单。生成新密钥不能自动获得不存在的模型权限。
404 或 Unexpected token <？
检查是否填成控制台或文档地址、是否重复 /v1、是否拼错端点。返回 HTML 页面时先修正地址，再排查密钥。
提示没有可用模型或渠道？
重新复制完整模型 ID，检查当前密钥对应分组、模型能力和维护公告。模型广场展示不等于该密钥可通过所有协议调用。
操练场能用，客户端不能用？
对比协议、分组、模型和参数；在线工具可能使用账户登录会话。客户端先关闭搜索、工具、图片和长历史，再测试普通文本。
429 一定是请求太快吗？
不一定。先看错误正文，区分频率、并发、用量或余额限制。临时限流可以退避；额度不足需修正资金或密钥限制。
回复慢、卡住或者中途断开？
缩短上下文，比较首字与总耗时，检查代理缓冲及读取超时。已开始生成时不要无限重发，可能产生重复费用。
HTTP 200 但没有文本？
检查协议对应字段、工具调用和完成原因。异步接口可能只返回任务 ID；流式接口需要按事件解析，不能用普通 JSON 一次性读取。
如何向客服描述问题？
提供时间与时区、模型、协议、应用或 SDK 版本、状态码、脱敏错误、请求 ID。不要提交完整密钥、Cookie 或用户敏感内容。