API 常见报错排查：401、403、413、429 与超时

先记录错误码、请求时间、模型和分组，再按下面的顺序排查，通常比反复重试更快。

401：密钥或认证问题

检查是否使用本站创建的 API Key，是否已停用或过期；程序请求需要 Authorization: Bearer …。复制时不要带额外空格，也不要把后台登录令牌当 API Key 使用。

核对该密钥绑定的分组是否允许所请求模型或功能。如果错误明确写着 Image generation is not enabled for this group，应检查图片生成权限和生图账号绑定。重复请求同一个未开放功能通常不会解决问题。

检查客户端是否自动补上 /v1，以及是否重复拼接路径。查询 GET /v1/models，使用当前分组实际返回的完整模型名称。聊天接口与图片接口是不同路径。

减少一次提交的图片数量或文件体积，整理过长的对话历史。错误可能发生在客户端、网关或上游任一层，需要结合日志判断具体限制。把大请求原样重发通常仍会报错。

等待后重试，降低并行任务数量；如响应带有 Retry-After，优先遵循其提示。客户端、本站分组、账号和上游都可能有限流，本站提高限制也不会解除上游限制。重试应有间隔与次数上限。

检查渠道状态和请求记录，分辨是连接失败、暂时没有可调度账号还是等待超过客户端时限。生图耗时可能明显长于文本；超时后先核实是否已经生成或计费，再决定是否发起新请求。

能逐字显示回复，只说明某种流式输出正常，不能单凭这一点判断 Responses WebSocket 已接通。图片工具缺失属于客户端能力或配置问题，须与图片接口认证失败分别检查。

提供客户端名称与版本、发生时间和时区、模型名称、分组、错误码以及请求 ID（如有）。日志和截图先遮住 API Key、登录令牌及私人对话内容。联系入口以本站首页和控制台为准。

重新配置可参考GPT API 接入教程；图片问题可参考生图 API 指南。