Ai Agent Api

AI Agent API — 25 个 REST + 30 个 MCP AI 服务，支持 USDC 微支付

DeepSeek V4 Pro（1M 上下文）· x402 微支付 · 面向 AI Agent 的 MCP · 面向个人的 API 密钥

首个专为 Web3 Agent 打造的按次付费 AI API。无需订阅，无 API 套餐。每次调用支付 $0.001–$1.00 的 USDC，仅为实际使用的服务付费。

---

目录

• 为什么要做这个
• 快速开始
• 架构
• 服务
• 支付方式
• MCP 连接
• Agent 发现
• 常见问题
• 路线图
• 安全
• 贡献

---

为什么要做这个

AI Agent 需要工具。但每个 AI API 都要求提供信用卡、订阅服务，或使用中心化服务商提供的 API 密钥。Web3 Agent 使用加密货币——它们理应使用加密货币支付。

此 API 是一个供运行在 Claude Code、Cursor 或任何兼容 MCP 的客户端中的 AI Agent 使用的工具箱。每个工具只需几美分。通过 x402 按次付费（Base L2 上的 USDC——Gas 费用约 $0.001）。无需账户。

使用者

使用者	使用工具	用途
Solidity 开发者	solidity-scan + contract-verify	部署前扫描合约，检查 36 种 SWC 漏洞
DeFi 分析师	whale-tracker + smart-money + defi-research	追踪巨鲸钱包、跟单聪明钱、分析协议
代码审查者	audit + refactor + code-health-check	安全审计 → 重构 → 在一个工作流中生成文档
数据工程师	nl-to-sql + extract-data + data-pipeline	自然语言 → SQL → 结构化提取 → 格式化输出
安全研究员	agent-audit + security-score	审计 AI Agent 的提示词注入、工具滥用情况，并进行信任评分
DevOps	debug-log + git-summarize	解析 CI 错误，根据 git diff 自动生成 PR 描述

---

快速开始

面向 AI Agent（MCP + x402 加密货币支付）

# 1. Connect your agent — no API key needed
# Claude Code:
/mcp add --transport sse https://agent-api-ai.duckdns.org/mcp/sse

# 2. Call any tool — get 402 with payment details
# The tool response tells you where to send USDC and how much

# 3. Send USDC to the wallet from the 402 response
# 4. Retry — tool executes, result returned

MCP 工具使用 payment_tx 参数——发送 USDC 后粘贴交易哈希。

面向开发者（API 密钥）

# 1. Get a free API key (50 free credits = $0.05)
curl -X POST https://agent-api-ai.duckdns.org/billing/create-key
# → {"api_key": "ak-abc123...", "credits": 50}

# 2. Call any service
curl -X POST https://agent-api-ai.duckdns.org/api/audit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ak-abc123..." \
  -d '{"code": "function transfer(to, amount) { ... }"}'

# 3. Top up with crypto when credits run low
curl -X POST https://agent-api-ai.duckdns.org/billing/register-wallet \
  -H "Content-Type: application/json" \
  -d '{"api_key":"ak-abc123...","wallet":"0xYourWallet"}'
# Send USDC to 0xdE7eb04faE758055642f67f30D246CcB7136C95E on Base
# Credits appear automatically in ~60 seconds. Bonus: $10→+10%, $50→+20%, $100→+30%

无需编写代码即可体验

# Service manifest with all prices
curl https://agent-api-ai.duckdns.org/.well-known/x402

# OpenAPI 3.1 spec
curl https://agent-api-ai.duckdns.org/.well-known/openapi.json

# Trigger 402 to see payment flow
curl -X POST https://agent-api-ai.duckdns.org/api/validate-json \
  -H "Content-Type: application/json" \
  -d '{"data": "{\"name\": \"test\"}"}'
# → HTTP 402 + PAYMENT-REQUIRED header with wallet and amount

---

架构

flowchart TD
    A[AI Agent / Client] -->|1. Request| B[Rate Limiter<br/>10 req/min/IP]
    B --> C[Security Headers]
    C --> D[API Key Auth?]
    D -->|Yes: API key| E[Credit Check<br/>pre-deduct max]
    D -->|No| F[x402 Payment Middleware]
    F -->|No payment| G[402 Payment Required<br/>+ wallet + amount]
    F -->|Has payment| H[Facilitator.verify<br/>on-chain USDC check]
    H -->|Invalid| G
    H -->|Valid| I[Route Handler]
    E -->|Insufficient| G
    E -->|Sufficient| I
    I --> J[validate_min_price<br/>fail-closed]
    J --> K[cached_completion<br/>SHA-256 LRU cache]
    K -->|Miss| L[DeepSeek V4 Pro<br/>1M context]
    K -->|Hit| M[Cache Hit — zero tokens]
    L --> N[settle_actual_usage<br/>charge actual tokens]
    M --> N
    N --> O[Response + Cost Headers]

层	详情
支付网络	Base、Arbitrum、Optimism、BNB Chain（USDC）+ Tron（USDT）
缓存	1000 条目，TTL 为 10 分钟，以 SHA-256 为键——重复调用免费
安全	12 种正则表达式注入模式、断路器、指数退避重试、重放保护
支付协调器模式	PayAI、Direct（Transfer + EIP-3009）、CDP、ChaosChain

---

30 个 MCP 工具 + 25 个 REST 服务

AI 服务（按需定价——按实际 Token 用量付费）

服务	价格	描述
audit	$0.01–$0.05	安全扫描——OWASP Top 10 + SWC Registry
refactor	$0.01–$0.05	现代化改造旧代码（DRY、SOLID）
docs	$0.005–$0.03	根据代码生成技术文档
defi-analyze	$0.01–$0.04	DeFi 协议分析（仅基于训练数据）
trading-signal	$0.005–$0.03	加密货币市场分析（不构成财务建议）
solidity-scan	$0.02–$0.08	Solidity 漏洞扫描器（36 项 SWC 检查）
nl-to-sql	$0.005–$0.03	自然语言 → SQL
sql-to-nl	$0.005–$0.02	SQL → 通俗英语
translate-code	$0.01–$0.05	代码翻译（Python、TS、Rust、Go、Solidity）
git-summarize	$0.005–$0.02	Git diff → PR 描述

DeFi 信号（按用量定价）

服务	价格	描述
whale-tracker	$0.015–$0.03	跟踪 Base/Arbitrum 上巨鲸钱包的资金变动
smart-money	$0.025–$0.05	分析聪明钱钱包——胜率、盈亏模式
price-feed	$0.01–$0.02	AI 增强型代币价格分析，包含支撑位/阻力位

安全（按用量定价）

服务	价格	描述
agent-audit	$0.25–$0.50	全面的 AI Agent 安全审计——代码、行为、信任评分
contract-verify	$0.50–$1.00	智能合约形式化验证——36 个 SWC + DeFi 漏洞利用
security-score	$0.05–$0.10	快速安全评估——快速评分和风险级别
amm-security-check	$0.02–$0.05	AMM 池安全检查——三明治攻击、无常损失、TVL 风险

数据与 DevOps

服务	价格	描述
data-feed	$0.01–$0.02	任意主题的结构化数据源——机器可读的 JSON
debug-log	$0.01–$0.03	CI/CD 错误日志分析——根本原因和修复建议

微任务（固定定价）

服务	价格	描述
validate-json	$0.001	验证 JSON/YAML 结构
classify-text	$0.001	情感、类别、关键词
extract-data	$0.005	提取姓名、电子邮件、电话、URL
generate-regex	$0.002	根据描述生成正则表达式并提供测试
format-data	$0.003	转换 CSV/JSON/YAML
summarize	$0.002	将文本总结为 N 个词

组合技能（多步骤流水线）

服务	价格	流程
defi-research	$0.08	提取 → 分析 → 总结
code-health-check	$0.10	审计 → 重构 → 编写文档
smart-contract-audit	$0.10	扫描 → 编写文档
data-pipeline	$0.05	提取 → 格式化 → 总结
run-workflow	可变	用户注册的组合工作流

---

付款方式

x402 协议（AI Agent）

在 Base、Arbitrum、Optimism、BNB Chain 上使用 USDC，或在 Tron 上使用 USDT。无需 API 密钥——您的 Agent 使用加密货币付款。

网络	代币	钱包
Base	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
Arbitrum	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
Optimism	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
BNB Chain	USDC	0xdE7eb04faE758055642f67f30D246CcB7136C95E
Tron	USDT	TADavZEHddjYMQcL2cnaFadFVKAUmP9wMw

REST 流程： 调用 → 收到包含 PAYMENT-REQUIRED 标头 + 钱包 + 金额的 402 响应 → 发送 USDC → 携带 payment-signature 标头重试 → 链上验证 → 获取结果

MCP 流程： 不带 payment_tx 调用工具 → 收到包含付款详情的错误 → 发送 USDC → 使用 payment_tx=<tx-hash> 重试 → 链上验证 → 获取结果

EIP-3009（免 Gas）： 客户端在链下签署 EIP-712 ReceiveWithAuthorization → 服务端在链上提交（Gas 费约为 $0.001，由服务端支付）。触发 AuthorizationUsed 事件——可供索引器查看。

API 密钥（开发者）

# Create key (50 free credits)
curl -X POST https://agent-api-ai.duckdns.org/billing/create-key

# Check balance
curl "https://agent-api-ai.duckdns.org/billing/balance?key=ak-YOUR_KEY"

# Register wallet for auto-top-up
curl -X POST https://agent-api-ai.duckdns.org/billing/register-wallet \
  -H "Content-Type: application/json" \
  -d '{"api_key":"ak-...","wallet":"0x..."}'

# Call with key
curl -X POST https://agent-api-ai.duckdns.org/api/audit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ak-YOUR_KEY" \
  -d '{"code": "function transfer(to, amount) { ... }"}'

充值奖励： $10→+10%，$50→+20%，$100→+30%。链上确认后约 60 秒自动入账。

---

Docker

docker build -t agent-api .
docker compose up -d
curl http://localhost:8000/health

---

MCP（AI Agent 连接）

SSE 端点： https://agent-api-ai.duckdns.org/mcp/sse

一键安装

客户端	安装方式
Smithery	npx -y smithery mcp add antoNYak0/ai-agent-api
Cursor	添加到 Cursor
Claude Code	/mcp add --transport sse https://agent-api-ai.duckdns.org/mcp/sse
VS Code	在 MCP 设置中添加 https://agent-api-ai.duckdns.org/mcp/sse

上架平台

市场	状态	发现方式
Smithery.ai	✅ 已上线	smithery.yaml + /.well-known/mcp/server-card.json
Glama.ai	✅ 已上线	/.well-known/glama.json（自动索引）
mcp.so	⏳ 审核中	mcp.json + Issue #2453
MCP Registry	📋 计划中	server.json（PR 待处理）
PulseMCP	🔄 Registry 上线后	自动从 MCP Registry 导入

---

Agent 发现

7 个众所周知的端点，供市场和 Agent 框架自动发现：

端点	用途
/.well-known/x402	x402 支付清单（全部 25 项服务及价格）
/.well-known/openapi.json	含 x402 扩展的 OpenAPI 3.1 规范
/.well-known/mcp/server-card.json	Smithery 服务卡片（30 个工具）
/.well-known/glama.json	Glama 自动发现
/.well-known/agent-card.json	A2A Agent 卡片
/.well-known/agentic-market-services.json	Agentic Market 条目
/.well-known/agent.json	AP2 Agent 支付协议

---

常见问题

问：upto 定价如何运作？ 你授权一个最高金额（例如 $0.05）。我们只按实际使用的令牌收费——如果 AI 回复使用了 100 个令牌，而不是 3000 个，你只需支付约 $0.01。最高金额是上限，而非实际价格。这与按固定价格收费的微任务不同。

问：REST 端点和 MCP 工具有何区别？ 提供的是相同的 AI 服务，但接口不同。REST 使用带有 x402 标头的 HTTP POST（/api/audit）。MCP 则通过 SSE 使用 Model Context Protocol（/mcp/sse），专为 Claude Code、Cursor 等环境中的 AI Agent 设计。MCP 工具将 payment_tx 作为参数传递；REST 使用 HTTP 标头。

问：如果我多付了怎么办？ 对于 Transfer 支付：多付的部分会留在服务端（相当于小费）。请使用准确金额。对于 EIP-3009：按准确金额结算，不会多付。

问：支付验证有多快？ 在 Base L2 上约需 1-3 秒（确认 1 个区块）。Tron 可能需要 5-10 秒。

问：可以退款吗？ 不予退款——AI 计算会立即消耗。请先用小额金额进行测试。

问：如果 AI 出错怎么办？ 你只需为出错前已消耗的令牌付费。响应标头 X-Actual-Cost 始终会显示你支付的金额。

问：我的代码会被存储或记录吗？ 不会。代码会经过哈希处理以供缓存（SHA-256，10 分钟 TTL），但不会以明文形式存储。缓存条目仅保存在内存中。

问：支持哪些链？ Base、Arbitrum、Optimism、BNB Chain（USDC）和 Tron（USDT）。推荐使用 Base，其 Gas 费用最低。

问：没有 AI Agent 时，可以通过脚本使用吗？ 可以——使用 API 密钥。POST /billing/create-key 可为你提供 50 个免费额度。

问：组合技能如何运作？ 它们会将 2-3 次 AI 调用串联成一个流水线。例如，code-health-check 会依次运行 audit → refactor → docs。只需支付一笔固定费用，即可获得全部三项结果。

问：需要 KYC 吗？ 使用 x402 加密货币支付或 API 密钥无需 KYC。只有 Coinbase CDP facilitator 模式需要 KYC（且该模式并非默认模式）。

---

路线图

• x402 USDC 支付（Transfer + EIP-3009）
• 支持加密货币自动充值的 API 密钥额度系统
• 30 个 MCP 工具 + MCP SSE 传输
• 在 Smithery + Glama 市场上架
• 7 个众所周知的发现端点
• LRU 缓存（10 分钟 TTL，重复调用免费）
• MCP Registry 官方上架（PR 待处理）
• 在 mcp.so 上架
• 在 PayAI Bazaar 上架（因俄罗斯地区的 KYC 要求受阻）
• 多 Agent 工作流市场
• 通过 SSE 提供流式响应（/api/stream/{service}）
• 结果市场——购买其他 Agent 缓存的 AI 结果

---

响应格式

所有服务均返回一致的 JSON 封装：

{
  "result": "{\"valid\": true, \"errors\": [], \"warnings\": []}",
  "payment_network": "eip155:8453",
  "payment_tx": "0x..."
}

响应标头包含 X-Actual-Cost（实际收取的费用）和 X-Cache-Hit（结果是否来自缓存）。

---

安全

• SECURITY.md — 完整的安全策略，包含攻击检测
• /health/security — 实时安全状态端点
• /health/metrics — Prometheus 指标（速率限制、重放拦截、注入尝试、收入）
• 12 个正则表达式模式 — 提示词注入防护（越狱、角色切换、提示词泄露）
• 速率限制 — 每个 IP 每分钟 10 个请求 + 累计拦截计数器
• 重放保护 — 基于 SQLite 的支付交易去重（30 分钟 TTL）
• API 密钥 — 静态存储时使用 SHA-256 哈希，原子文件写入

---

贡献

请参阅 CONTRIBUTING.md，了解贡献指南，包括架构概览、PR 检查清单以及如何添加新的 AI 服务。

快速链接：

• 报告错误
• 请求功能
• 提问

---

链接

• 仪表板 — 实时服务状态 + 加密货币充值
• Swagger 文档 — 交互式 API 参考
• 健康检查
• OpenAPI 规范
• x402 清单
• 安全状态
• Prometheus 指标
• AGENTS.md — 连接到此服务的 AI Agent 的说明