用途：为 Metronome 现有客户依据已签署订单条款创建合同，包含承诺消费（commits）、信用额度（credits）和费率覆盖（rate overrides）。流程为两步：先预览，再确认，读取检查与写入均直接调用 API。基础地址为 https://api.metronome.com/v1。
前置条件：需提供客户 ID（可来自 metronome-create-customer，或通过 GET /v1/customers 按 name 匹配）；承诺或信用额度所需的产品 ID 必须是 FIXED 类型产品，需先执行 metronome-setup-catalog 第 2 步创建。
主要步骤：一、从订单表单收集条款，包括客户 ID、合同起止日期（ISO 8601，ending_before 为排他，即最后一天加一）、净付款期限、费率卡 ID、预付承诺金额、包含额度、平台费、单价覆盖、产品 ID。二、用 POST /v2/contracts/list 检查是否已有生效合同；v2 合同 API 无状态字段，需以 starting_at ≤ 今天且（ending_before 为空或大于今天）判断生效。三、输出预览，金额以美分展示，回复 confirmed 后创建。四、调用 POST /v1/contracts/create 创建，成功返回合同 ID。五、再次检查合同生效，并摄入一条测试事件，确认草稿发票出现行项目。
关键限制：金额单位为美分，美元需乘 100；ending_before 排他；信用额度先于承诺消费消耗，信用额度优先级设为 50、承诺设为 100；信用额度必须通过 applicable_product_ids 限定产品范围；包含事件转美元按 event_count × rate_per_1K / 1000 计算；多年可变费率需按年分别创建覆盖条目；产品 ID 无法通过此 API 流程发现，需询问用户或查看现有合同；覆盖仅对费率卡上已有产品生效，否则返回 No such product in rate card；若折扣仅适用于承诺消费，需使用 is_commit_specific 并引用 commit_ids，仅设日期范围会同时折扣超额用量。is_commit_specific 默认为 false，设置 commit_ids 等而未置 true 会被 API 拒绝。