常见问题¶
额度相关¶
Q：额度是怎么计算的？
- GPT-3.5 补全倍率：1.33
- GPT-4 补全倍率：2（与官方一致）
Q：账户有余额但提示额度不足？
令牌额度和账户额度是独立的。请检查令牌的额度限制是否充足。用户可以自行调整令牌额度上限。
渠道配置¶
Q：渠道的优先级和权重怎么理解？
- 优先级：数值越大越优先。高优先级渠道不可用时自动降级
- 权重：同优先级渠道之间按权重比例分配请求
Q：提示"无可用渠道"？
请检查：
- 用户分组设置是否正确
- 渠道分组是否包含该用户分组
- 渠道的模型列表是否包含请求的模型
Q：渠道测试报错 invalid character '<'？
返回了 HTML 而非 JSON，通常是 IP 或代理节点被 CloudFlare 封禁。
Q：提示"倍率或价格未配置"？
在「系统设置 > 运营设置 > 模型倍率设置」中配置，或开启「自用模式」。
部署与连接¶
Q：ChatGPT Next Web 报错 "Failed to fetch"？
请检查：
- 部署时不要设置
BASE_URL - 确认接口地址和 API Key 填写正确
- 检查是否启用了 HTTPS（浏览器会拦截 HTTPS 下的 HTTP 请求）
Q：提示"当前分组负载已饱和"？
上游渠道返回了 429 错误（请求过多），请稍后重试或增加渠道。
数据库与升级¶
Q：升级后数据会丢失吗？
- MySQL：不会丢失
- SQLite：需要通过 volume 挂载持久化
one-api.db，否则容器重启后丢失
Q：升级前需要手动改数据库吗？
一般不需要，系统启动时自动迁移。特殊情况会在更新日志中说明。
Q：手动改数据库后报"一致性已被破坏"？
ability 表中存在无效的渠道 ID。删除 channel 记录时需同步清理 ability 表。