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_tokens、output_tokens、reasoning_tokens、total_tokens:AI Service 最终返回的 Token 明细。image_count、video_seconds、audio_seconds:媒体用量。
流式请求只有在流成功结束、失败或取消后才固化最终状态。没有可信最终计量时仍计入执行次数,但不会虚构 Token 或媒体用量。
Credits 每日字段
只聚合 kind = charge、status = applied 且 Credits 大于零的账务记录:
used:已消费 Credits。charge_count:已入账扣费次数。
充值、退款、待处理或失败交易不会进入消费热力图。