a2apay

a2apay

适用于 a2apay.io 的 Python 客户端——为自主 Agent 提供按次付费的 AI 答案 和持久记忆。无需账户，也无需 API 密钥。

pip install a2apay-io          # free-tier only
pip install "a2apay-io[paid]"  # adds real payment support (eth-account)

（PyPI 发行包名为 a2apay-io——另一个无关软件包已占用单独的 a2apay 名称。可导入的模块仍为 a2apay。）

快速开始（免费层级，零配置）

每次调用都会自动优先尝试免费层级——每位调用者每天 5 次请求， 无需钱包：

from a2apay import Agent

agent = Agent()
answer = agent.ask("What's 7 times 8?")
print(answer)

agent.remember("last_task", "processed invoice #4471", tags=["billing"])

使用真实付款（免费层级用尽后）

from a2apay import Agent

agent = Agent(private_key="0x...")  # or set A2APAY_PRIVATE_KEY
answer = agent.ask("What's 7 times 8?")

钱包需要在 Base 主网上有少量 USDC 余额（每次调用 $0.028）。私钥仅用于在本地签署付款授权——绝不会发送到任何地方。

检查点／恢复（任务记忆）

写入带版本、按任务划分的状态，之后再读回——即使是在不同进程中也可以。对同一个键调用 checkpoint() 时会新增一个版本，而不是覆盖；resume() 始终返回最新版本。

from a2apay import Agent

agent = Agent(private_key="0x...")
agent.checkpoint("invoice-batch-7", key="status", value="processed rows 1-400")

# ...process dies, or a second process picks up later...

agent2 = Agent(private_key="0x...")  # same wallet
records = agent2.resume("invoice-batch-7")
print(records[0]["value"])  # "processed rows 1-400"

resume() 始终需要付费（每次调用 $0.014）——目前读取没有免费层级，因此即使是首次调用，也需要配置钱包。checkpoint() 的行为与 remember() 相同：先尝试免费层级，用完后再付费。

本工具的实际功能与限制

• ask() 会返回由真实 AI 生成的答案。
• remember() 会存储扁平的键／值记录，可选添加标签——这是简单的文本存储，不是文档数据库。值以文本形式存储。
• 只有在免费层级返回 402 时才会改用真实付款；如果此时未配置 private_key，则会清楚地抛出 A2ApayError，而不是静默失败。
• 付款签名使用 eth-account（由 Ethereum Foundation 生态系统维护），按 x402 协议规范 实现真实的 x402 “exact” EVM 方案。

MCP 服务

MCP 服务（mcp_server.py）会将 ask 和 remember 作为 MCP 工具开放给任何支持 MCP 的 Agent 或框架（如 Claude Desktop）：

pip install "a2apay-io[mcp]"
python mcp_server.py

添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "a2apay": {
      "command": "python",
      "args": ["/absolute/path/to/mcp_server.py"],
      "env": {"A2APAY_PRIVATE_KEY": "0x..."}
    }
  }
}

关于功能范围的说明：remember 只能写入——由于线上 API 尚无读取路由，因此没有记忆读取工具。

完整 API 参考

有关此客户端封装的底层 HTTP API，请参阅 a2apay.io/openapi.yaml。