❓ 常见问题¶
💰 额度相关问题¶
额度是什么？怎么计算的？
额度计算公式如下：
额度 = 分组倍率 * 模型倍率 * （提示 token 数 + 补全 token 数 * 补全倍率）
补全倍率说明：
-
GPT3.5：固定为 1.33
-
GPT4：固定为 2（与官方保持一致）
注意事项：
-
非流模式下，官方接口会返回消耗的总 token，但提示和补全的消耗倍率不同
-
New API 的默认倍率与官方倍率一致，已经过调整
账户额度足够为什么提示额度不足？
这是因为令牌额度和账户额度是分开的：
- 令牌额度仅用于设置最大使用量限制
- 用户可以自由设置令牌额度
- 请检查您的令牌额度是否充足
🔧 渠道配置问题¶
渠道中的权重和优先级是什么？
权重和优先级是控制渠道使用顺序和分配的两个重要参数：
-
优先级（Priority）：数字越大优先级越高，优先级高的渠道会优先被使用
-
权重（Weight）：在同优先级的渠道中，按权重比例分配请求
例如：
-
优先级为2的渠道会优先于优先级为1的渠道被使用
-
同为优先级1的两个渠道，权重比为2:1时，请求会按照2:1的比例分配
提示无可用渠道？
请检查以下设置：
- 用户分组设置
- 渠道分组设置
- 渠道的模型设置
渠道测试报错：invalid character '<' looking for beginning of value
此错误表示返回值不是合法的 JSON，而是一个 HTML 页面。
最可能的原因是：您的部署站的 IP 或代理节点被 CloudFlare 封禁。
渠道测试报错：倍率或价格未配置，请联系管理员设置
请检查是否在'系统设置-运营设置-模型倍率设置'中配置了倍率或价格。
或者在'系统设置-运营设置'开启'自用模式'。
🌐 部署与连接问题¶
ChatGPT Next Web 报错：Failed to fetch
请检查以下几点：
- 部署时不要设置 BASE_URL
- 确认接口地址和 API Key 填写正确
- 检查是否启用了 HTTPS（浏览器会拦截 HTTPS 域名下的 HTTP 请求）
报错：当前分组负载已饱和，请稍后再试
这表示上游渠道出现了 429 错误（请求过多）。
📦 数据库与升级问题¶
升级之后我的数据会丢失吗？
根据数据库类型有所不同：
- MySQL：数据不会丢失
- SQLite：需要按照部署命令挂载 volume 来持久化 one-api.db 数据库文件，否则容器重启后数据会丢失
升级之前数据库需要做变更吗？
一般情况下不需要，系统会在初始化时自动调整。
如需特殊处理，会在更新日志中说明并提供相应脚本。
手动修改数据库后报错：数据库一致性已被破坏，请联系管理员？
此错误表示在 ability 表中检测到无效的渠道 ID 记录。常见原因：
- 删除 channel 表记录时未同步清理 ability 表中的无效渠道
- 每个渠道支持的模型都需要在 ability 表中有对应记录