用途：指导 Metronome 按用量计费（usage-based billing）的集成决策与操作，包括事件摄取、计费指标、合同设计、发票生命周期、承诺与信用、Stripe 同步等。API 基址为 https://api.metronome.com，使用 Authorization 头中的 Bearer token 认证；新集成应使用 Contracts 而非旧版 Plans。
主要能力与用法：摄取用量事件用 POST /v1/ingest（批量）；定义计量用 Billable Metrics API；企业定价协议用 Contracts + Rate Cards；合同中期变更用 Contract Edits（POST /v2/contracts/edit），而非已弃用的 Amendments（/v1/contracts/amend）；发票用 Invoices API；预付或后付承诺与一次性充值用 Commits + Credits；同步发票到 Stripe 用 Stripe billing provider config；预付余额、自动充值、支出告警与阈值用 Notifications API。
关键规则：生产负载应使用批量摄取，请求体为 1 至 100 个事件对象的裸 JSON 数组；每个事件须带唯一 transaction_id 作为幂等键，重试时保持不变；计费周期用量须在宽限期（默认 billing_period_end_date 后 24 小时）内送达；同一客户有多个并行合同时须设置 usage_filter；合同级承诺或信用段不得超出 ending_before；spend_threshold_configuration 承诺不得带产品过滤；同一 Stripe 客户不得同时处理多张 Metronome 发票；不得在合同中硬编码定价；USD 金额以分为单位；Stripe 发票在税额计算完成前不得 finalize；每张 Stripe 发票不得超过 250 个行项目；付款对账以 Stripe 发票总额为准；NetSuite 不得同时作为 billing_provider_configuration 和 revenue_system_configuration。
操作流程：资料列出迁移、group_keys 设计、从零搭建目录、创建客户、创建合同、AI token 计费、PLG 计费、CSM 客户健康审查等技能；其中多项会通过 API 写入真实对象，执行前须确认 token 指向的环境（沙箱与生产共用同一基址，由 token 决定）并获得用户明确确认。
限制：具体端点、字段与单位须先阅读对应文档页；部分配置（如宽限期）无法通过 API 调整，需联系支持。