快速入门
快速排错
按状态码和症状定位鉴权、余额、模型、限流、网络与解析问题。
先记录 HTTP 状态码、错误对象、请求时间和请求 ID，再按下面的顺序排查。
一分钟诊断
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
401 | 密钥、Bearer 格式、环境变量 | 重新加载环境变量，确认请求头没有多余引号或空格。 |
402 | 账户余额 | 查看消费明细并充值；确认使用的是预期账户密钥。 |
404 | URL 与模型标识 | 确认路径为 /v1/chat/completions，从模型广场复制标识。 |
429 | 并发、速率与配额 | 加入队列和指数退避，必要时申请提升配额。 |
5xx | 平台或上游节点 | 对安全请求有限重试；保留请求 ID 并联系支持。 |
| 连接失败 | DNS、代理、TLS、出口网络 | 用 cURL 验证同一环境能否访问 Base URL。 |
| 返回为空 | finish_reason、流式读取 | 流式请求读取 delta.content；同时检查工具调用结果。 |
最小化复现
移除业务框架、代理层和复杂参数，只保留一个最小 cURL 请求。若最小请求成功，问题通常位于 SDK 配置、应用中间件或网络代理。
curl -i https://api.dimleap.cn/v1/chat/completions \
-H "Authorization: Bearer $APIQIK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.1","messages":[{"role":"user","content":"ping"}]}'提交支持信息
- 请求发生时间与时区。
- 接口路径、模型标识、HTTP 状态码和请求 ID。
- 已脱敏的最小请求体与完整错误对象。
- 问题是否稳定复现，以及普通与流式请求是否都受影响。
- 运行环境、SDK 语言与版本；不要附带完整 API Key。