Gengxi API Developer Docs
故障排查
排查身份验证、模型、配额、上游和流式请求故障。
建议排查顺序
- 检查 API Key 和 Authorization Header。
- 使用同一 Key 请求 GET /v1/models。
- 在 /usage 检查余额和配额。
- 在适当时使用指数退避安全重试。
- 问题持续时携 Request ID 联系客服。
常见故障
| 现象 | 检查项 |
|---|---|
| 401 | 缺少、无效、已禁用 Key 或非活跃用户 |
| 403 | 过期 Key、余额不足或访问被拒绝 |
| 404 model | 模型标识符和当前 Key/分组模型列表 |
| 429 | Retry-After、配额、速率和滚动限制 |
| 500 | Request ID 和安全重试 |
| 502 / 503 | 临时上游或容量问题，稍后重试 |
| 流式中断 | SSE 解析、网络超时、取消和终止事件 |
流式请求检查
- 确认 Content-Type 为 text/event-stream。
- 解析完整 SSE frame。
- 处理 Responses 的 response.failed。
- 不要强制要求 Responses 返回 [DONE]。
- 只在可安全重复请求时重试。
联系客服
联系客服时提供 Request ID、大致时间、endpoint、状态码和脱敏请求摘要。不要发送完整 API Key。
联系客服 →