字段与统计口径
收入、退款、模型估算成本、功能成功率及分页同步规则。
查询窗口
所有数据接口默认 period=today。可选 month、year、days:N（1–366）；历史年度使用 period=year&year=2025。自定义日期必须同时提供 start_date、end_date，结束日期包含全天，单次不超过 366 天。请求和响应均为 JSON，未知、重复或非法查询参数返回 422。
window.start_at 包含、window.end_at 不包含，window.timezone=Asia/Shanghai。汇总快照缓存最多 30 秒，generated_at 表示实际生成时间；响应 Cache-Control: no-store，客户端不可把长期缓存当作实时结果。
收入与退款
支付金额单位为千分之一币种单位，以十进制整数字符串返回。例如 paid_milli="9000" 表示人民币 9 元。使用整数或 Decimal 计算，金额和标识不要转换成浮点数。
| 字段 | 口径 |
|---|---|
paid_count / paid_milli | 服务端确认支付成功的事件次数／金额，即用户实际支付额 |
refund_requested_count / refund_requested_milli | 已受理退款申请次数／金额，尚不表示到账 |
refunded_count / refunded_milli | 业务退款完成次数／金额 |
refund_reversed_count / refund_reversed_milli | 退款撤销次数／金额 |
net_milli | 支付额 − 已确认退款 + 退款撤销；看板可命名为平台净交易收入 |
unconfirmed_amount_events | 金额或币种缺失的事件数；不能当成已知零金额 |
currencies | 已记录的币种列表；按 currency 分别查询，不混合相加 |
本接口没有扣除支付手续费、税费，也不提供渠道结算或银行到账数据。自 9.2.77 起，微信按产品规则在渠道明确受理成功时计入业务已完成退款，独立审计保留 channel_acceptance 依据；这一口径不表示银行已到账。银行结算仅由独立凭证确认，不能用看板净交易额替代银行对账。Apple 的退款确认规则保持不变。
汇总和流水按服务端确认事件时间归属；订单明细按订单创建时间归属，状态为查询时最新状态。一笔订单可能跨月支付和退款，因此不能仅用当月创建订单推算当月收入。退款撤销单独列示，订单 refunded_milli 表示当前有效的已确认退款金额。
payment-events 使用 paid、refund_requested、refunded、refund_reversed 事件；同一订单可以有多个事件，按 event_id 去重。payment-orders 按 order_id 去重。金额、币种或支付／退款时间为 null 时表示未知或尚未发生。未知币种记录在各币种明细中保留，跨币种采集须按 ID 去重。
AI 功能与成本
每个已创建的功能 Job 计一次调用，重试、模型回退不增加功能调用量；独立后续功能操作会形成新 Job。按 Job 创建时间查询，状态和费用为截至查询时的已记录值，迟到完成会改变原日期的统计。
failed包含failed和expired。cancelled单列；cancel_requested、等待输入、等待外部结果及其他未终止状态计入active。- 成功率 =
succeeded / (succeeded + failed)；失败率 =failed / (succeeded + failed)，返回 0–1。分母为零时返回null，不显示 100% 或 0%。 estimated_cost_micros是提交时的任务预算估算，不能当作已消费金额。metered_estimated_cost_micros是已记录模型调用按价格快照计算的费用估算，包含失败后回退的已知费用及已记录的历史生成估算。它与预算估算分别展示，不相加。- 成本单位为百万分之一币种单位，以整数字符串返回；例如
"270000"表示 0.27 元。汇总及功能、每日成本为 CNY；模型分组另带cost_currency，不同币种不换算或混合相加。 - 模型调用次数可能多于功能调用次数。熔断、未发送请求的跳过不计模型调用，独立后台恢复探测不在该数据集内。
unpriced_calls>0表示存在未定价调用，可能实际收费。已计量估算不等于完整成本，更不是供应商最终账单。
calls 明细仅包含 call_id、feature_code、feature_name、status、created_at、started_at、completed_at。没有任务详情查询接口，也不返回失败原文、照片和输入输出。支持 feature_code 和原始 status 筛选；汇总失败包含过期，明细过期状态仍为 expired。
明细分页与更新
明细支持 page（从 1 开始）、page_size（1–200，默认 50）。第一页返回 snapshot_at，后续页须原样带回，固定新增记录的排除水位；按创建／事件时间倒序，并以 ID 打破同一时间的并列。返回 total 为该水位下匹配条数，超出页数时 items=[]。
水位固定新增记录范围，不冻结旧记录的状态，不是数据库历史快照。订单和功能状态可能随后变化。落库按 ID upsert；定期重取近期日期以及未终止调用／待确认退款所属日期，替换原汇总，不把相邻刷新结果累计相加。events 是确认流水，跨周期退款按事件时间同步。单次分页建议拆成较小日期窗口，避免在高页码上做长时间连续扫描。
当前接口不提供 updated_since 增量游标，也不保证任意分页期间的数据库历史状态一致性。需要完整历史时按日期分片，并持续回补未完成记录。