计费与成本控制

钱从哪里扣

统一从账户余额扣费。查询 GET /v4/account/balance,流水 GET /v1/transactions/list。不存在代币双轨或订阅抵扣。

提交 ──受理(按预估扣费)──► 执行 ──完成(按实际校正)──► 差额回补

失败或无产物的任务不计费;已在途任务不受余额波动影响。

手段	机制
单 Key 限额	为每把 API Key 设置配额,触顶 `402`(`1013`);隔离失控重试的爆炸半径
幂等键	三个付费 `POST`(workflows / chat runs / world builds)携带 `Idempotency-Key`,网络重试不会重复扣费(同键异体 `422`/`1012`)
目录刷新	模型不在目录 `400`(`1002`)、缺价格行 `400`(`1014`)在扣费前拒绝
预估	socket estimate 端点返回结构完整的零报价(`preview`),实际扣费以受理时价格规则为准
余额告警	监控 `GET /v4/account/balance` 并设阈值;余额不足时提交在扣费前被拒(`402`/`1005`)

流水 GET /v1/transactions/list 分页(limit/offset,next 游标);按 Key 拆分的用量在控制台 Key 列表。
回放记录可把每次任务的参数与种子归档,支撑事后复现与审计。

下级账户的余额由分销商充值,费率沿链连乘;分销商毛利报表见分销体系。