文档计费与积分消耗
了解 API 请求的计费方式以及基于请求体大小的积分消耗规则。
本文档介绍了平台的计费模型，以及当您通过 API 或平台执行数据转换请求时，系统是如何扣除积分 (Credits) 的。
标准计费规则
我们计费系统的核心指标是 积分 (Credits)。
对于绝大多数标准使用场景：1 次 API 请求 = 1 个积分。
当您发送 POST /api/v1/transform 请求以处理您的 JSON 或 XML 数据时，系统会评估请求的复杂度和大小。默认情况下，单次执行将从您的账户余额中扣除 1 个积分。
AI 映射建议
使用 AI 映射建议 功能（根据源与目标 schema 自动推荐字段映射）时，每次请求将消耗 10 个积分。
大文件请求体 (Payload Size) 计费
为了保证公平使用并维持平台的高性能运行，处理超大体积数据的请求将消耗额外的积分。
标准的 1 积分可覆盖最大 2 Megabytes (2MB) 的请求体大小。
超额计算规则
如果您的请求体超过了 2MB 的阈值，系统将根据请求体的总大小收取额外的积分。具体规则如下：
- 每额外增加 2MB（或不足 2MB 的部分），将额外收取 1 个积分。
这意味着，系统会将请求体的总大小除以 2MB，并向上取整，得出最终需要扣除的积分数。
计算公式
总消耗积分 = Math.ceil(请求体大小 (MB) / 2MB)(注：Math.ceil 表示向上取整)
计算示例
以下是基于不同请求体大小的积分扣除示例：
| 请求体大小 | 计算过程 | 最终消耗积分 |
|---|---|---|
| 800 KB (0.8 MB) | Math.ceil(0.8 / 2) | 1 个积分 |
| 1.99 MB | Math.ceil(1.99 / 2) | 1 个积分 |
| 2.1 MB | Math.ceil(2.1 / 2) | 2 个积分 |
| 3.5 MB | Math.ceil(3.5 / 2) | 2 个积分 |
| 5.0 MB | Math.ceil(5.0 / 2) | 3 个积分 |
| 9.8 MB | Math.ceil(9.8 / 2) | 5 个积分 |
查看使用量与余额
您可以直接在控制台 (Dashboard) 的 账单 (Billing) 或 API Keys 页面中查看您的剩余积分余额和 API 调用历史记录。
如果您的账户积分耗尽，后续的 API 请求将返回 429 Too Many Requests 或 402 Payment Required 状态码，直到您补充余额或订阅自动续期。