Skip to content

报错排查 ​

先读错误正文中的 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 错误说明。