问题排查
常见错误与排查
面向 NeonAPI 使用者的实际操作指南。
先查看响应内容
保留 HTTP 状态、脱敏后的响应正文、模型 ID 和请求标识。上游可能返回协议特有的错误格式，因此不能只看状态码。
| 状态 | 优先检查 |
|---|---|
| 400 | JSON 结构、必填字段、支持的参数和上下文长度 |
| 401 | 密钥、Bearer 前缀、多余空格及有效期 |
| 402／额度不足 | 账户余额、套餐和密钥额度 |
| 403 | 密钥限制、模型权限与账户状态 |
| 404 | 基础地址、接口路径和准确模型 ID |
| 429 | 并发、频率限制、额度与提供商容量 |
| 5xx | 服务状态和上游响应，适当时采用退避重试 |
缩小问题范围
- 使用 cURL 测试一条简短请求。
- 将模型 ID、密钥和地址与客户端配置逐项比较。
- 移除可选参数与附件，再逐一加回。
- 重复提交可能已经启动的任务前，先检查用量日志。
提供有效的问题信息
附上带时区的时间、接口、模型 ID 和脱敏错误。不要发送 Authorization 请求头或完整的敏感请求正文。