报错排障

常见 HTTP 状态码

NovelAI 绘图错误

调用 NovelAI 绘图遇到下列错误时，应按点数、权限或服务资源排查，不要直接套用文本对话的处理方式。Anlas 是 NovelAI 的点数单位。

• 402 MAX_TOKENS_EXCEEDED：通过 Chat 生图所需的额外点数超过本次预算，不是回复文字太长。确认接受费用后提高或移除预算，或降低尺寸、步数；基础费用不计入该预算。氛围转移参考图请求不受这一预算限制，条件见 Chat 点数费用上限。
• 503 NAI5_UNAVAILABLE / NO_PAID_CREDIT：服务当前缺少可用 V5 资源或点数，不等同于调用方钱包余额不足。
• 403 NAI5_NOT_ALLOWED / ANLAS_NOT_ALLOWED：请求身份缺少对应权限，请联系管理员。

错误结构分别见 OpenAI 兼容接口和原生接口。NovelAI 生图的流式响应不提供中间预览；切换流式不保证减少等待时间，降低点数预算也不是缩短生成时间的方法。

401 Unauthorized

现象：请求返回 401，提示未授权。

可能原因：

• API Key 未填写或填写错误
• API Key 已过期或被禁用
• Base URL 填错，请求到了错误的服务

解决方法：

1. 检查 API Key 是否正确复制，注意前后不要有多余空格
2. 登录主站确认 Key 状态是否正常、是否有余额
3. 确认 Base URL 填写正确，参考 使用 Key

429 Too Many Requests

现象：请求返回 429，提示请求过多。

可能原因：

• 短时间内发送了过多请求，触发了速率限制
• 上游模型本身的速率限制

解决方法：

1. 降低请求频率，在请求之间加入适当间隔
2. 如果是上游限制，稍等片刻后重试
3. 避免并发大量请求

502 Bad Gateway

现象：请求返回 502。

可能原因：

• 上游模型服务暂时不可用
• 上游返回了无法解析的响应

解决方法：

1. 稍等几秒后重试
2. 登录主站，在「模型广场」确认目标模型当前是否可用
3. 如果持续 502，尝试切换到其他线路

524 Timeout

现象：请求返回 524，连接超时。

可能原因：

• 上游模型推理时间过长（常见于长上下文、复杂推理任务）
• 使用非流式模式请求长回复，等待时间超过了网关超时阈值

解决方法：

1. 改用流式模式（"stream": true），流式模式下只要数据持续传输就不会超时
2. 缩短输入长度或减少 max_tokens
3. 如果使用加速线路超时，尝试 站点直连——直连没有中间层，超时阈值更宽松

上游错误

上游错误是指模型提供商（OpenAI、Anthropic、Google 等）返回的错误，本站会将其透传给你。常见的有：

错误信息	含义	处理方式
model not found	模型名称错误或该模型不可用	检查模型名称是否正确，在「模型广场」确认模型存在
context_length_exceeded	输入内容超过模型的上下文窗口限制	减少 messages 中的历史消息，或换用上下文窗口更大的模型
content_policy_violation	内容触发了上游的安全策略	修改输入内容
insufficient_quota	本站额度不足	前往主站「钱包管理」充值