请求频率限制
每个密钥有两项限制：每分钟请求数和每天请求数（按 UTC 计算日期）。您的密钥对应的数值由 GET /me 的 rateLimit 字段给出（rpm 和 rpd）。
每个带密钥的调用的响应都携带更接近耗尽的那项限制的状态，文件下载也不例外（下载同样计入频率限制）。在检查密钥或限制之前给出的响应不带这些响应头：无效密钥（401）、格式错误的请求体（400）、未知路径（404）、无效的查询参数（400 validation）、缺少权限范围（403 forbidden_scope）、测试密钥被拒绝的写操作（403）。
在浏览器中（CORS）可以读取 RateLimit-*、Retry-After、Grem-Sandbox、X-Request-Id 和 Content-Range 响应头。
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| 请求头 | 含义 |
|---|---|
RateLimit-Limit | 当前窗口允许的请求数 |
RateLimit-Remaining | 剩余请求数 |
RateLimit-Reset | 距窗口重置的秒数 |
超出限制时返回 429，带 title: rate_limited 和 Retry-After 请求头。请求频率限制是技术保护措施，从不扣费。
关注 RateLimit-Remaining，把请求分散开。轮询任务状态虽然免费，也计入频率限制：间隔不要短于几秒，或改用 webhooks。
计费
没有单独的 API 套餐：访问权包含在您的订阅中，收费操作与后台一样从同一个钱包扣款。
一次收费调用由两部分组成：
- API 调用。 从套餐内含的调用额度中扣除。超出部分按用量计费。
- 工具价格：与后台中同一操作的价格相同（从内含额度或钱包中扣除）。
各套餐的 API 调用额度：
| 套餐 | 每月 API 调用 |
|---|---|
| Free | 100 |
| Start | 5,000 |
| PRO | 25,000 |
| MAX | 100,000 |
| Agency Start | 50,000 |
| Agency Growth | 250,000 |
| Agency Scale | 合理使用范围内不限 |
其他套餐以及工具的当前额度和价格，请见后台的套餐页面。
哪些收费，哪些免费
每个操作的计费类别写在 /openapi.json 的 x-grem-billing 字段中：free、api_call 或 api_call+sku:...（调用加工具价格）。
| 收费 | 免费 |
|---|---|
启动工具（向估价、文案、视频、照片、PDF、网站等发送 POST）：调用 + 工具价格 | 所有读取操作（GET），包括任务轮询和下载 |
| 传单和报告审核确认：仅调用 | 房源：创建、编辑、删除 |
| 对话消息：调用 + 消息价格 | 线索和 Swipe Match：创建、编辑、事件 |
| 创建、编辑和删除对话会话：仅调用 | 上传图片 |
| 管理 webhooks |
被拒绝的请求（4xx 或 5xx）不消耗 API 调用。例外是超时后的 502 provider_error：工作可能仍会完成并扣费，请查看 GET /works（照片优化、网站和草稿：在后台或您的房源中查看）。快速估价使用同一个 Idempotency-Key 重试会返回结果且完全免费（估价和 API 调用都不扣费）；其他工具在超时后该键会被占用 15 分钟，请先查看结果，不要重复请求。
每个密钥的调用、花费和错误可在后台 API 页面的 分析 标签中查看。