常见错误排查

先找到你遇到的现象#

状态码是线索，不是唯一原因。具体错误正文、当前账户配置与请求记录才是定位依据。

有响应但没有完整输出#

SSE 连接建立后仍可能出现错误事件。检查是否收到 response.completed，以及客户端是否因超时、代理缓冲或手动停止而提前结束。仅看初始 HTTP 200 会漏掉后续失败。

限流时怎样重试#

• 先检查额度；额度不足不能靠快速重试解决。
• 限制同时运行的请求数，给重试设置最大次数与总时长。
• 存在 Retry-After 等提示时优先遵循；否则使用带随机抖动的退避。
• 长任务中断后先核对用量，避免无意重复触发相同的昂贵生成。

最短排查顺序#

1. 核对 Base URL 与最终接口路径。
2. 核对密钥状态、分组和模型列表。
3. 用本站最小请求示例排除客户端附加参数。
4. 对比使用记录，再提交脱敏信息。

仍未解决时使用支持信息模板，不要公开完整配置与凭据。