Open WebUI 模型计费机制深度解析与配置指南

Open WebUI 模型计费机制深度解析与配置指南

open-webui User-friendly AI Interface (Supports Ollama, OpenAI API, ...) 项目地址: https://gitcode.com/gh_mirrors/openweb/open-webui

计费异常现象分析

在Open WebUI项目使用过程中，开发者可能会遇到模型调用不扣费的情况。通过实际案例观察，当用户配置了请求价格为0.1时，系统并未按预期扣除相应积分。这种现象往往源于对计费机制的理解偏差。

核心计费原理

Open WebUI采用双轨制计费模式：

1. 请求价格：每次API调用的固定费用
2. Token价格：基于实际消耗计算的可变费用

关键设计要点在于：

• 当两者同时配置时，系统优先采用请求价格计费
• 所有价格单位均基于百万(1M)Token进行计算
• 请求价格字段实际表示"每百万次请求的价格"

典型配置误区

常见错误配置场景包括：

1. 单位误解：将"0.1"理解为单次请求价格，而实际系统将其视为"0.1/百万次"
2. 字段冲突：同时配置请求价格和Token价格时，Token价格实际上不会生效
3. 零值处理：请求价格填0表示不启用固定费用计费

最佳实践建议

1. 单一计费模式选择：

   • 纯按量计费：仅配置Token价格，请求价格设为0
   • 混合计费：合理设置请求价格(需×1M)和Token价格

2. 配置示例：

   期望单次调用收费1积分 → 实际应配置为1000000
   期望每千Token收费0.002积分 → 实际应配置为2
   

3. 版本演进：新版系统已增加提示信息，明确标注价格单位为"每1M请求"

技术实现解析

底层计费逻辑采用科学计数法处理：

• 前端输入值会自动除以1,000,000
• 数据库存储原始值
• 计费时直接使用存储值进行比较

这种设计保证了：

• 高精度计算能力
• 支持微支付场景
• 系统性能优化

故障排查指南

当遇到计费异常时，建议检查：

1. 配置界面单位提示
2. 数据库中的原始存储值
3. 实际调用日志中的计费计算过程
4. 版本兼容性(特别是跨版本升级时)

通过深入理解Open WebUI的计费机制，开发者可以更精准地控制API使用成本，避免因配置不当导致的计费异常问题。

open-webui User-friendly AI Interface (Supports Ollama, OpenAI API, ...) 项目地址: https://gitcode.com/gh_mirrors/openweb/open-webui