# 计费与用量

## 人民币钱包

账户余额是已入账余额，使用中金额是未解除预留，可用余额是二者之差。1 元采用一百万分之一元的定点精度记账，这不是积分。

## 报价

POST /v1/quotes 根据具体模型、输入、规格和数量计算费用。报价默认五分钟内有效，创建任务时锁定价格版本。

## 预留与扣款

创建任务预留费用，成功交付后扣款并释放余量。失败释放占用。释放预留不是退款，已扣款后退回才是退款。

## 筛选与分页

GET /v1/billing 与 MCP billing.list 共用筛选参数：q 搜索标题、任务 ID 或模型；modality、settlement_status、connection_id 筛选类型、结算状态和来源设备。page 从 1 开始，limit 默认为 30、最多为 100；响应包含 data、total、page、limit 和 has_more。删除作品后，账单仍可查询。

created_from 为包含边界的开始时间，created_before 为不包含边界的结束时间，两者必须是带时区的 ISO 时间戳。控制台日期按浏览器本地时区计算，并包含所选结束日期全天。min_amount、max_amount 使用最多六位小数的 CNY 字符串，按扣款减退款后的实付金额筛选，边界均包含；尚未扣款的任务不参与金额筛选。

## 导出账单

控制台 CSV 导出沿用当前筛选，包含所有匹配页、费用分项和价格版本，最多 10000 条。超过上限会提示缩小范围，不会静默截断。CSV 仅用于下载，账户管理接口需要浏览器登录会话。

## 重试与渠道

上游重试不重复向用户收费，换渠道不修改已接受的费用上限。用户账单显示销售价格，上游采购成本独立核算。

## 当前充值状态

本地开发范围不包括充值支付。充值接口明确返回 RECHARGE_DISABLED，前端成功跳转不会增加余额。