---
title: 常见问题与故障排查
description: 按错误信息检查密钥、分组、协议、额度和任务状态。
---

## 先做四项检查

1. 地址是否为 `https://sub.vcnovb.cn`，路径是否重复拼接 `/v1`。
2. API Key 是否启用、未过期、未耗尽额度。
3. 分组是否有目标模型及所需协议或媒体权限。
4. 普通余额、赠金或订阅是否适用于当前分组。

## 常见响应

| 现象 | 常见原因与处理 |
| --- | --- |
| 400 / 参数错误 | 核对模型、字段类型和协议。视频时长、图片尺寸与不同模型的要求不能混用 |
| 401 / 鉴权失败 | 检查 Key、请求头和客户端是否使用了旧配置 |
| 403 / 权限拒绝 | 检查分组、模型权限、IP 规则和账户状态 |
| 404 / 接口不可用 | 检查请求路径和分组功能；异步接口不可用时可改用同步接口 |
| 额度不足 / 配额耗尽 | 同时检查钱包、赠金规则、订阅和 Key 的累计/周期额度；不只看账户总余额 |
| 429 / 限流 | 降低并发、间隔重试；检查额度或限制说明，避免紧密循环 |
| 502 / 503 / 暂时不可用 | 检查错误信息，延长重试间隔，或选择其他可用分组 |
| 返回 HTML 网页 | 通常是域名或路径错误，或客户端请求到了前端页面 |

不同协议可能返回不同错误格式。HTTP 200 的流也可能包含失败事件，需要读取完整响应。

## 有余额仍然报错

赠金只可用于允许赠金的分组；订阅只覆盖对应分组和套餐范围。Key 到期、IP 不匹配或自己的额度耗尽，也会导致请求被拒绝。

## 生成超时，要不要重试

文本请求超时后查看使用记录。图片或视频已有任务 ID 时，继续查询原任务；请求断开后，已提交的任务仍可能继续生成。

## 提示内容审核失败

根据错误提示调整内容，不要不断重试相同请求。部分分组的违规附加费用会单独显示在使用详情中，是否发生以实际记录为准。

仍未解决时，按[支持页](/help/support)整理信息提交工单。