Skip to content

用量与费用 ​

用量与费用选项卡总结了此项目已发出的已计费模型 API 调用——包括后来被丢弃的重试——并附带令牌计数和单一美元成本。

相同的聚合数据可在命令行中以 ai-i18n-tools usage 的形式获取。

使用它可以回答:我们进行了多少次调用,哪些模型和操作消耗了令牌,以及费用是多少?

记录了什么 ​

每个详细信息行都是一个返回了用量的 HTTP 完成(即使翻译后来因解析/脚本/质量问题被拒绝,并尝试了下一个备用模型)。未产生计费主体的传输失败不会被记录。

调用 API 的命令执行完毕后,超过七个完整 UTC 日历日(即今天往前推 7 天的 UTC 00:00 之前)的记录行将汇总至月度总计(api_totals)并从详细日志中移除。最近一周的数据仍保留为单独的api_calls行。汇总表会针对所选时间范围合并这两个数据源。

费用报告 ​

每次调用、摘要卡片和表格都显示一个美元成本:

  1. 当响应包含提供商的 usage.cost 时(目前为 OpenRouter 和 Cheaper Inference)。已报告的成本(包括 0)绝不会被替换。
  2. 否则,使用来自 providers.<name>.modelPricing 或提供商范围 pricing 默认值的金额,应用于该调用的输入和输出令牌。
  3. 否则,使用该模型 ID 的 models.dev 标价(每 100 万个令牌的输入和输出美元金额),该价格来自 suggest-models 维护的相同缓存。suggest-models --refresh 会更新该缓存。翻译或此报告不会仅仅为了给调用定价而下载 languagebench 或 Arena。

新的调用会将该金额存储在 api_calls 行中。在打开报告时,以相同方式对没有存储成本的旧行进行定价,然后将其添加到相同的“成本”数值中——它们不会显示为第二列。如果这三个来源均不适用,则该单元格为 —,绝不会是 $0.00。更改已配置的费率或后续的 models.dev 刷新不会重写已经具有存储成本的行。月度汇总仍然会保留已存储成本的调用计数(ncost_acc / ncost_dis),因此 $0.00 在压缩后仍与“未知”保持区分。

筛选器 ​

按时间窗口、提供商、模型、操作 (translate-docs、translate-ui、translate-json、translate-svg、proofread-ui、bench-models)、区域设置和结果(接受与丢弃)进行筛选。

时间窗口:

  • 短范围(Last 30 minutes 到 Last 30 days)使用滚动持续时间。随时间变化的用量显示该范围内仍有详细信息的每个 UTC 日历日的一行。
  • Last 2 months / Last 3 months 从当前日历月减去 1 / 2 个月的第一天的 UTC 00:00 开始。随时间变化的用量显示保留的每日行以及每月的一行。
  • All time 包括所有每月总计和保留的每日行。

要清除旧用量数据,请在“删除早于以下时间的条目”下选择一个时间范围(> 1 month、> 2 months、> 3 months、> 6 months、> 1 year 或 all data (clear)),然后执行“删除数据”。该菜单默认值为 -,在选择时间范围前,“删除数据”处于禁用状态。相同的时间范围也可通过 ai-i18n-tools usage --clear [--older-than 1mo|2mo|3mo|6mo|1y|all] 获取。日历截止时间会保留当月(1mo)或当月及之前月份的数据。

命令行 ​

bash
ai-i18n-tools usage
# ai-i18n-tools usage --since 7d --operation translate-docs
# ai-i18n-tools usage --since 2mo
# ai-i18n-tools usage --clear --older-than 3mo --dry-run

基于 MIT 许可证发布。