主题
报错排查
先读错误正文中的 error.message、error.code;若有 error.taleapi_code,也一并查看。不同接口的错误结构可能不同,同一个 HTTP 状态码也可能代表不同原因,不能只看 429、503 等数字判断。
如果返回的 error.retryable 或 error.taleapi_retryable 为 false,不要自动重试;没有这些字段也不代表可以重试。重新提交通常是新请求,可能再次产生费用。
| 正文或现象 | 怎么处理 |
|---|---|
| 正文明示内容安全拒绝或禁止内容 | 按提示检查内容或附件;不要自动重试或换 Key |
| 正文明示本站余额或 Key 额度不足 | 查看账户和 Key 的可用额度;上游账户不足不等于本站钱包不足,保留错误并反馈 |
| 临时限流或上游繁忙 | 先检查是否允许重试;允许时按正文或 Retry-After 等待,降低并发后有限重试 |
| 正文明示 Key 无效、过期或禁用 | 检查完整 Key、有效期、启用状态和请求头;登录会话与 API Key 不可混用 |
401 / 403,正文指向上游认证或含 UPSTREAM_AUTH_INVALID | 保留错误正文和请求 ID 并反馈;不能据此判断本站 Key 无效 |
| 401 / 403,但正文未说明原因 | 核对 Key 和请求方式;仍无法判断时反馈,不反复新建或更换 Key |
| 模型不可访问或不存在 | 检查当前 Key 的模型列表、分组、模型 ID 和最终请求路径 |
| 上下文过长、图片格式、参数或 JSON 错误 | 按正文指出的字段缩短或修改请求;这类错误不等于内容安全拒绝,原样重试不会解决 |
| 429 / 503 或无可用渠道,但正文未说明原因 | 保留正文和请求 ID 并反馈,不仅凭状态码反复提交 |
| 超时 / 流中断 | 先查使用日志是否已有消费与结果,避免连续重发 |
仍无法判断时,私下向支持人员提供发生时间、模型、请求 ID、完整错误正文和脱敏截图。遮挡完整 Key、Authorization 请求头和敏感提示词。NovelAI 专用错误见 API 错误说明。
