問題排查
常見錯誤與排查
面向 NeonAPI 使用者的實際操作指南。
先檢視響應內容
保留 HTTP 狀態、脫敏後的響應正文、模型 ID 和請求標識。上游可能返回協議特有的錯誤格式，因此不能只看狀態碼。
| 狀態 | 優先檢查 |
|---|---|
| 400 | JSON 結構、必填欄位、支援的引數和上下文長度 |
| 401 | 金鑰、Bearer 字首、多餘空格及有效期 |
| 402／額度不足 | 帳戶餘額、套餐和金鑰額度 |
| 403 | 金鑰限制、模型許可權與帳戶狀態 |
| 404 | 基礎地址、介面路徑和準確模型 ID |
| 429 | 併發、頻率限制、額度與提供商容量 |
| 5xx | 服務狀態和上游響應，適當時採用退避重試 |
縮小問題範圍
- 使用 cURL 測試一條簡短請求。
- 將模型 ID、金鑰和地址與客戶端配置逐項比較。
- 移除可選引數與附件，再逐一加回。
- 重複提交可能已經啟動的任務前，先檢查用量日誌。
提供有效的問題資訊
附上帶時區的時間、介面、模型 ID 和脫敏錯誤。不要傳送 Authorization 請求頭或完整的敏感請求正文。