2026-07-11 · 约 6 分钟
互补导出:Metronome、Orb 与层级预留
发票平台擅长合同、批价与资金流转,却系统性欠投资于 Agent 循环的请求前硬拒绝与流中切断。FluxMeter v2.8.0 完成 Phase 4,明确站在这条分界线上:我们管热路径拦截;Metronome、Orb、Stripe 仍是发票账本。
一等公民合作方导出
通过 BILLING_EXPORT_TARGETS=stripe,metronome,orb 启用目标(默认 stripe)。api/billing_export.py 中的共享导出器发送幂等增量,并对 Stripe 做了强化重试。
用 POST /admin/billing/{id}/link 一次性关联客户,platform 设为 stripe、metronome 或 orb。合作方配方在引擎仓库 docs/integrations/stripe.md、metronome.md、orb.md — 含环境变量与字段映射。
外部导出 schema 的互操作映射见 spec/schema/external-export-mappings.md,无需猜测字段名。
层级 reserve-confirm
v2.7 已提供 POST /budget/{id}/cap 与 check?parent_span_id= 硬封顶。v2.8 补上预留:POST /budget/{id}/reserve?parent_span_id= 会原子占用客户钱包与 span 封顶池。
Python SDK 1.5.0 对应 reserve(parent_span_id=) 与 reconcile(parent_span_id=),流式与多步 Agent 可像占用客户余额一样占用层级预算。
按 Key 预算与 metadata 维度
转售场景常需要「每个下发的 API Key」单独预算,而不只是客户钱包。POST /admin/customers/{id}/apikeys/{key_id}/budget 设置限额;该 Key 鉴权时 /check 会一并执行。
若要在没有数仓的情况下做产品分析,在 /ingest 传 metadata(键由 FLUXMETER_USAGE_DIMS 白名单),再用 GET /usage/dim/{key}/{value}?period=YYYY-MM 按功能或工作流切片。
本地试用
运行 make demo,用 /admin/billing/{id}/link 关联测试客户,练习 reserve?parent_span_id=,并在带 metadata 的 ingest 后 curl /usage/dim。完整合作方配方与 API 细节见引擎仓库文档。