实用手册

复制过去第一次就能跑通的范例

每篇范例只解决一个明确的问题，展示完整的调用顺序，并在你花费任何东西之前告诉你成本。先从基础篇掌握计费契约，再进入服务端工作流与智能体接口。

API 基础

逐块掌握计费契约。这里的每篇范例都可用测试密钥运行，零积分消耗。

在运行任何操作之前，免费获得它精确的积分成本。

免费 —— 这些端点从不计费 · ~5 分钟

直接从响应中审计每一笔扣费，无需月底对账。

1 (最坏情况) · ~5 分钟

区分「没找到」和「失败」，只重试真正该重试的那一类。

5 (最坏情况) · ~10 分钟

一次调用取代五次。串联任务在我们这边执行，按步计费且仅在成功时计费。

搜索、找到邮箱、核验邮箱 —— 一次调用取代三次，按步计费。

7 每位找到的人 (最坏情况) · ~15 分钟

批量核验一份名单并拿回衰减报告，无需自己手写队列。

1 每个已核验地址 (最坏情况) · ~15 分钟

同一套目录，通过 Streamable HTTP 上的 JSON-RPC 暴露，只读且可在运行前报价。

把智能体指向托管的 MCP 服务器，让它先为自己的工作报价。

免费 —— 这些端点从不计费 · ~10 分钟

积分数字是最坏情况的上限，也正是预估器给出的报价。实际运行通常更便宜，因为没有找到结果的查询按零计费。

创建密钥、预估一次调用，在花掉一个积分之前，就从响应头里读完整份计费契约。