故障排查
排查鉴权、请求参数和连接错误。
同时阅读 HTTP 状态码和错误正文。用最简单的请求复现，并确认密钥、模型和接口与应用中的设置一致。
| 现象 | 检查方法 |
|---|---|
| 401 · 身份认证失败 | 检查 API Key 是否完整、已启用且未过期，确认客户端将 Zashmodel 密钥发送到 Zashmodel 接口地址。 |
| 403 · 无访问权限 | 检查账号状态、密钥限制、IP 白名单和模型分组权限，并根据错误正文定位被拒绝的权限。 |
| 404 · 模型或接口不存在 | 检查准确的模型 ID 和请求路径，去掉重复的 /v1。endpoint_not_enabled 表示站点尚未启用该接口。 |
| 400 · 请求参数错误 | 先尝试最小请求，检查模型协议、必填字段、上下文长度，以及模型是否支持工具、图片等可选参数。 |
| 429 · 请求频率或并发超限 | 降低并发请求数，逐步延长重试间隔；如果响应带有 Retry-After，请遵循该等待时间。连续立即重试会加重负载。 |
| 余额或密钥额度不足 | 同时检查钱包余额和密钥剩余额度。提高密钥额度不会增加账号余额。 |
| 5xx、超时或流式响应中断 | 重试前先查看请求日志：超时并不代表请求没有被处理。限制重试次数，问题持续时联系客服。 |
仍然需要帮助？
请提供请求 ID（如有）、时间和时区、模型 ID、接口路径、HTTP 状态码及脱敏后的错误信息。不要发送 API Key、账号密码或支付凭据。
联系客服 →