Usage 服务

Usage 事实与计量模型

理解 AI 技术用量、Credits 账务与 usage_id 的边界。

Usage 页面由两个独立事实源组成:

  • AIService 保存一次 AI 执行的最终技术计量,包括 Token、图片数、视频秒数和音频秒数。
  • CreditsService 保存已经入账的 Credits Charge。

两者通过稳定的 usage_id 关联,但不互相派生。一次执行可以有 AI 技术记录而没有扣费,也不能根据 Token 数反推出 Credits。

AI 每日字段

  • execution_count:AI 执行次数,包括没有最终计量的失败或取消执行。
  • metered_request_count:取得可信最终计量的请求数。
  • input_tokensoutput_tokensreasoning_tokenstotal_tokens:AI Service 最终返回的 Token 明细。
  • image_countvideo_secondsaudio_seconds:媒体用量。

流式请求只有在流成功结束、失败或取消后才固化最终状态。没有可信最终计量时仍计入执行次数,但不会虚构 Token 或媒体用量。

Credits 每日字段

只聚合 kind = chargestatus = applied 且 Credits 大于零的账务记录:

  • used:已消费 Credits。
  • charge_count:已入账扣费次数。

充值、退款、待处理或失败交易不会进入消费热力图。