EstimateModelPricingRequest 计费表达式 dry-run 入参。

tokens 字段命名与后端 billingexpr.TokenParams 对齐 (与结算路径同一源代码), 前端 UI 只暴露常用的 p/c/cr/cc/cc1h, 其它可选字段留空。

语义:

• mode 必须是合法 billing_mode; MVP 仅支持 "tiered_expr" (其它 mode 的估算走前端本地既可, 不需要 API)
• expr 必填, 空串或语法错误返回 400
• 表达式价格系数单位为积分/百万 token
• tokens 全部 optional, 缺省视为 0
• 口径契约 (DEF-7): 各 token 字段为 canonical disjoint 口径——p/c 为纯 文本 token (已剔除缓存与多模态子类别); cr/cc/img/img_o/ai/ao 与 p 互斥, 各自独立填真实 token 数, 不与 p 重叠。后端按 disjoint 语义求值 (不再从 p 扣减子类别), 与生产结算的 anthropic/disjoint 路径同口径, 使 dry-run 忠实 预览真实结算金额。 注意 cc/cc1h 是包含关系, 非互斥: cc 为 cache-creation token 总量, cc1h 是其中 1h TTL 的子集 (cc1h ⊆ cc), 5m 部分 = cc - cc1h。填写时 cc 必须填总量, 常见表达式如 (cc - cc1h) * 5 + cc1h * 10 据此区分两档单价; 若把 cc 只填 5m 部分会导致 len 漏算 1h 部分并算错金额。 len 由后端按 p+cr+cc+img+ai 重算 (完整上下文长度, cc 已含 cc1h 故不再单加), 管理员直接填的 len 仅作参考、以重算值为准 (与生产一致: 档位由真实 token 决定, 不接受人工强制)。

EstimateModelPricingReply dry-run 结果。

• cost_micros: 与生产结算一致的 CRD 基础金额, 单位 micros CRD (int64). 1 CRD = 1_000_000 micros; 与其它金额 API (balance_micros / billed_micros / amount_micros 等) 单位完全对齐, 前端统一走 microsToCreditsDisplay 展示。 不含渠道销售倍率 (真实计费时才乘, 估算只展示基础价).
• matched_tier: tier(...) 命中的档位 name; 表达式未使用 tier() 时为空串
• used_vars: 表达式 AST 内省识别到的子类别变量集, 前端用来提示"你写了 cc1h 但没在 UI 里填对应 token 数"这类边界