Credits、预留与 Receipt

AntAPI 使用 Credits 为已发布 API 能力定价。调用前查看具体操作的当前价格与计费单位，不同能力可以分别定价。操作首次创建时冻结价格版本和数量合同；重试原操作不会切换到新价格。

三种计费规则

规则	产生费用的条件
free	不预留、不 Debit，也不生成扣费 Receipt。
per_request	一次成功的同步请求为一个单位。
per_item	以可信完成事实确认的成功离散处理项数量为准。

同步 per_request 以成功的上游 HTTP 响应计一个请求单位。per_item 按产品声明的成功定义计量，HTTP 请求成功不代表每个条目都应计费。异步 HTTP 202 表示已受理并预留资金，不触发最终 Debit。

免费接口仍要求有效 Key、访问权限并遵守限流，但不要求正 Credits 余额。

先预留，再执行

付费操作执行前，Gateway 预留授权范围内的最高费用。这笔 Hold 会占用可用 Credits，项目 UTC 月预算也在同一事务中预留。

当适用 Credits 或项目预算无法覆盖最高费用时，操作可能被拒绝。Credits 的有效期还必须覆盖所需预留期限，因此账户可见余额不一定全部适用于长任务。

平台取得并验证终态后，扣除成功数量对应费用，释放其余预留。没有成功项时全额释放，不生成扣费 Receipt。批次跨 UTC 月份完成时，仍结算到原提交月份的预算预留。

产品的成功定义

每个产品分别定义成功处理单位。不要仅根据 HTTP 成功、结果行或缓存命中判断是否属于计费项，先阅读对应接入指南和 API 参考。例如，WHOIS 数据质量指南说明了明确的注册结果与重复域名处理规则。

核对最终记录

在 Console 中查看用量、Credits 和 Receipt。预留不等于最终扣费；任务执行进入终态后，平台结算记录可能稍后更新。

Gateway 返回最终付费结算结果时，可以通过以下响应头识别：

响应头	含义
X-Request-ID	用于排查问题的请求标识。
X-AntAPI-Receipt-ID	权威扣费 Receipt 标识。
X-AntAPI-Credits-Debit-Atoms	此操作扣除的 Credits atoms。

不要根据产品业务正文字段或结果行数自行判断扣费，最终以平台结算记录为准。HTTP 超时或客户端断开不会取消已授权工作，平台会恢复原执行状态。如果到安全期限仍无法确认可信终态，平台释放剩余预留并关闭结算，之后不再补扣。