帮助与安全
错误排查
按HTTP状态码和排查顺序定位认证、模型、限流与上游问题。
快速对照
| 状态码 | 常见含义 | 优先检查 |
|---|---|---|
400 | 请求格式或参数错误 | JSON、必填字段、参数兼容性 |
401 | 身份认证失败 | Bearer头、Key完整性、过期或删除 |
403 | 权限或账户限制 | 分组、模型权限、账户状态 |
404 | 路径或模型不存在 | Base URL、端点、模型准确名称 |
429 | 触发速率、并发或额度限制 | 限流、并发、余额与重试策略 |
5xx | 服务或上游临时异常 | 请求ID、时间、重试与服务状态 |
推荐排查顺序
1. 检查Base URL
https://duolingai.com/v1确认没有 /v1/v1、拼写错误或未经文档确认的子域名。
2. 检查令牌
Authorization: Bearer YOUR_API_KEY确认 Bearer 后有一个空格，令牌没有多余引号或换行。
3. 获取模型列表
curl https://duolingai.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"如果模型列表正常，再用其中的准确名称测试对话请求。
4. 检查控制台日志
记录以下非敏感信息：
- 请求发生时间和时区
- HTTP状态码
- 模型名称
- 请求ID或日志ID
- 是否流式
- 客户端和SDK版本
不要在工单、截图或群聊中附上完整API Key。
429重试
对可安全重试的请求采用指数退避并增加随机抖动。流式请求已经收到部分内容后，不要自动无条件重放。
5xx重试
短暂上游异常可以有限重试，但必须设置上限。持续失败时保留时间、模型和请求ID，避免反复高频请求放大故障。
网页能打开不等于模型链路可用
健康检查只能证明服务进程可访问。最终应使用你的真实令牌、分组和模型完成一次非流式与流式请求。