错误码与排障
调用失败时,响应里会带一个错误码。下表按类别说明含义与处理方法。
认证错误
| 错误码 | HTTP | 含义与处理 |
|---|
401 Unauthorized | 401 | API Key 错误、缺失或格式不对。确认请求头为 Authorization: Bearer sk-nodaryx-…;或重新登录控制台。 |
missing_runtime_metadata | 400 | 用了不带会话元数据的裸 master key 调用。请改用控制台创建的 API Key。 |
权限错误
| 错误码 | HTTP | 含义与处理 |
|---|
MODEL_NOT_ALLOWED | 403 | 当前账号或 Key 无该模型权限。见「权限与模型范围」,或联系管理员开放。 |
WEB_SEARCH_NOT_ENABLED | 403 | 联网搜索为内测能力,当前账号未开通。联系管理员加入白名单。 |
余额错误
| 错误码 | HTTP | 含义与处理 |
|---|
insufficient_credit | 402 | 余额不足。查看「余额与用量」,或请管理员发放测试额度。 |
限流错误
| 错误码 | HTTP | 含义与处理 |
|---|
RATE_LIMITED | 429 | 触发限流(RPM/TPM 或搜索频率)。降低调用频率、稍后重试。 |
parallel_limit_exceeded | 429 | 并发请求数超限。减少同时进行的请求。 |
文件上传错误
| 错误码 | HTTP | 含义与处理 |
|---|
FILE_TOO_LARGE | 400 | 文件超过 2 MB。压缩或拆分后再上传。 |
FILE_EMPTY | 400 | 文件无可提取文字(如扫描版 PDF / 无文字图片)。换文字型文件。 |
FILE_TEXT_DECODE_FAILED | 400 | 文件损坏或无法解析(如加密 PDF)。检查文件后重试。 |
QUERY_BLOCKED | 403 | 搜索/输入中检测到疑似 secret(私钥、token 等),已拦截。移除敏感内容。 |
上游 / Provider 错误
| 错误码 | HTTP | 含义与处理 |
|---|
PROVIDER_UNAVAILABLE | 503 | 上游 provider 暂时不可用。稍后重试;持续不可用请联系管理员。 |
还没解决？