当 AI Agent 需要免 API Key…

适用于用加密钱包按请求付费，让 AI Agent 免 API Key 调用 Frames Registry 的 10 个服务（Twitter、Exa、OpenRouter、CoinGecko 等）。

适用场景

解决思路

1. 设置基础 URL 为 https://registry.frames.ag。
2. 准备付费钱包：付费端点需要一个已充值 USDC 的加密钱包。可选 AgentWallet（推荐，用于 AI Agent 的服务端钱包，自动处理 402 检测、支付签名和重试，无需自己管理私钥）或自管钱包（任意 EVM/Base 或 Solana 钱包，持有 USDC，直接签署 x402 支付头）。
3. 快速开始：1）创建 AgentWallet 或给自己的钱包充值 USDC；2）发现服务：GET https://registry.frames.ag/api/services；3）阅读服务文档：GET https://registry.frames.ag/api/service/{slug}/skill.md；4）检查价格：GET https://registry.frames.ag/api/pricing；5）发起付费请求：通过 AgentWallet 的 /x402/fetch 或直接使用 x402 头。
4. 使用 AgentWallet（推荐）集成：1）用 AgentWallet 认证（邮箱 OTP → API token），参考 https://frames.ag/skill.md；2）在 Base 或 Solana 上给钱包充值 USDC；3）通过 POST https://frames.ag/x402/fetch 调用任意 Frames Registry 端点，请求体包含 url、method、body，例如 url 为 https://registry.frames.ag/api/service/twitter/api/search-tweets、method 为 POST、body 为 {'query':'AI agents'}；AgentWallet 自动检测 402、签署支付并重试。
5. 直接使用 x402（自管钱包）：1）向付费端点发起请求；2）从 402 响应解析 PAYMENT-REQUIRED 头（Base64 JSON，包含 price、network、payTo）；3）为准确金额签署支付授权；4）带 PAYMENT-SIGNATURE 头重试同一请求；5）收到响应和 PAYMENT-RESPONSE 确认头；失败请求会自动退款。
6. 免费的平台端点：GET https://registry.frames.ag/api（平台信息和版本）；GET https://registry.frames.ag/api/services（列出所有服务及元数据）；GET https://registry.frames.ag/api/services/:slug（单个服务详情）；GET https://registry.frames.ag/api/pricing（所有定价策略）；GET https://registry.frames.ag/api/networks（支持的支付网络）；GET https://registry.frames.ag/api/health（健康检查）；GET https://registry.frames.ag/api/packages（skill/agent 包目录）；GET https://registry.frames.ag/api/packages/:slug/bundle（下载包 bundle）；GET https://registry.frames.ag/.well-known/x402（x402 发现文档）；GET https://registry.frames.ag/docs（交互式文档 HTML）。
7. 每个服务的基础路径为 https://registry.frames.ag/api/service/{slug}，通用子端点：GET /（服务信息）、GET /health（健康检查）、GET /docs（交互式 API 文档）、GET /openapi.json（OpenAPI 3.x 规范）、GET /skill.md（面向 Agent 的文档）。
8. 支持的网络：Base（eip155:8453，EVM，主网）、Base Sepolia（eip155:84532，EVM，测试网）、Solana（solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp，主网）、Solana Devnet（solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1，开发网）。接受的代币：USDC、USDT、CASH（可用性因网络而异）。
9. 可用服务共 10 个，slugs 为：twitter、ai-gen、test、exa、wordspace、openrouter、jupiter、near-intents、agentmail、coingecko；端点分别为 /api/service/{slug}，文档为 /api/service/{slug}/skill.md。
10. Twitter API（slug: twitter，基础 /api/service/twitter，26 个端点，价格 $0.005-$0.02）：POST /api/user-info（$0.005，按用户名查询资料）；POST /api/user-tweets（$0.01，按用户名或用户 ID 获取近期推文，可选包含回复和 cursor 分页）；POST /api/user-followers（$0.01，列出关注者，每页最多 200，cursor 分页）；POST /api/user-following（$0.01，列出正在关注，每页最多 200，cursor 分页）；POST /api/verified-followers（$0.01，按用户 ID 列出仅认证蓝标关注者，cursor 分页）；POST /api/search-users（$0.01，按关键词搜索用户，匹配名称、简介、用户名）；POST /api/user-mentions（$0.01，获取 @ 提及用户的推文，可用 sinceTime/untilTime unix 时间戳过滤）；POST /api/check-follow（$0.005，检查一个用户是否关注另一个）；POST /api/batch-users（$0.02，按逗号分隔用户 ID 批量获取资料）；POST /api/tweets-by-ids（$0.01，按逗号分隔推文 ID 获取完整推文）；POST /api/tweet-replies（$0.01，获取推文回复，可按 Relevance、Latest、Likes 排序并 cursor 分页）；POST /api/search-tweets（$0.01，高级推文搜索，支持 from:、to:、has:media、日期范围、互动过滤和布尔逻辑）；POST /api/tweet-quotes（$0.01，获取转推引用，可选时间范围和回复包含过滤）；POST /api/tweet-retweeters（$0.01，列出转发推文的用户，cursor 分页）；POST /api/tweet-thread（$0.01，获取推文完整会话线程，父推文和回复上下文）；POST /api/list-tweets（$0.01，按 list ID 获取 Twitter List 推文，可选时间范围和回复过滤）；POST /api/list-followers（$0.01，列出 Twitter List 关注者，cursor 分页）；POST /api/list-members（$0.01，列出 Twitter List 成员，cursor 分页）；POST /api/community-info（$0.005，获取 Twitter Community 元数据：名称、描述、成员数、规则、创建日期）；POST /api/community-members（$0.01，列出 Community 成员，cursor 分页）；POST /api/community-tweets（$0.01，获取 Community 内推文，cursor 分页）；POST /api/space-detail（$0.005，获取 Twitter Space 详情：标题、主持人、参与者、日程、状态 live/scheduled/ended）；POST /api/article（$0.01，按包含文章的推文 ID 获取长文 Twitter Article/Notes）；POST /api/trends（$0.01，按 WOEID 获取趋势话题，1=Worldwide、23424977=US、2459115=NYC）；POST /api/invoke（$0.01，搜索推文，旧版，建议用 /api/search-tweets）；POST /api/search（$0.01，搜索推文，旧版，建议用 /api/search-tweets）。
11. AI Generation API（slug: ai-gen，基础 /api/service/ai-gen，1 个端点，$0.01 起）：POST /api/invoke（运行 AI 模型预测，价格随请求体中的 model 字段动态变化）。
12. x402 Test Service（slug: test，基础 /api/service/test，2 个端点，$0.001）：POST /api/invoke（测试 x402 支付流，支持 Base Sepolia & Solana Devnet）；POST /api/echo（带支付验证回显数据）。用它验证 x402 客户端集成是否正确。
13. Exa API（slug: exa，基础 /api/service/exa，4 个端点）：POST /api/search（$0.01，语义网页搜索）；POST /api/find-similar（$0.01，查找相似页面）；POST /api/contents（$0.002，提取 URL 内容）；POST /api/answer（$0.01，AI 驱动回答）。
14. Wordspace Agent（slug: wordspace，基础 /api/service/wordspace，1 个端点）：POST /api/invoke（$2，运行 wordspace AI agent 循环，带沙箱执行和 OpenProse skills）。
15. OpenRouter（slug: openrouter，基础 /api/service/openrouter）：端点数为 0，价格 free；用于通过 300+ 模型（OpenAI、Anthropic、Google、Meta 等）进行文本生成。
16. Jupiter API（slug: jupiter，基础 /api/service/jupiter，4 个端点）：POST /api/swap（$0.01，获取交换报价和未签名交易）；POST /api/price（$0.002，代币价格查询）；POST /api/tokens（$0.002，代币搜索和元数据）；POST /api/portfolio（$0.005，钱包持仓）。
17. NEAR Intents API（slug: near-intents，基础 /api/service/near-intents，1 个端点）：POST /api/quote（$0.01，跨链交换报价和存款地址，通过 1Click deposit addresses）。
18. AgentMail API（slug: agentmail，基础 /api/service/agentmail，5 个端点）：POST /api/inbox/create（$0.01，为 AI Agent 创建新邮箱收件箱）；POST /api/send（$0.01，从 Agent 收件箱发送邮件）；POST /api/messages（$0.005，列出收件箱中的消息）；POST /api/message（$0.005，按 ID 获取特定消息）；POST /api/threads（$0.005，列出收件箱中的邮件线程）。
19. CoinGecko API（slug: coingecko，基础 /api/service/coingecko，5 个端点）：POST /api/price（$0.002，获取任意法币/加密货币计价的价格）；POST /api/token-info（$0.005，获取详细代币信息和市场数据）；POST /api/trending（$0.005，获取当前趋势代币）；POST /api/markets（$0.005，获取代币市场数据，支持排序和分页）；POST /api/search（$0.003，按名称或符号搜索代币）。
20. AI 模型定价（ai-gen）由请求体中的 model 字段动态决定。图像模型价格：flux/schnell $0.004/image；flux/2-pro $0.02；flux/kontext-pro $0.05/image；bytedance/seedream-4 $0.04/image；google/nano-banana $0.05/image；google/nano-banana-2 $0.09/image (1K)、$0.13/image (2K)、$0.19/image (4K)；google/nano-banana-pro $0.18/image；google/imagen-4-fast $0.03/image；ideogram/v3-turbo $0.04/image；prunaai/z-image-turbo $0.006/image；prunaai/p-image $0.006/image；fofr/sdxl-emoji $0.01；qwen/qwen-image-edit-2511 $0.04/image；openai/dall-e-3 $0.15/image；nightmareai/real-esrgan $0.003/image。
21. 视频模型价格：google/veo-3 $0.48/sec (audio)、$0.24/sec (no audio)；google/veo-3-fast $0.18/sec (audio)、$0.12/sec (no audio)；google/veo-3.1 $0.48/sec (audio)、$0.24/sec (no audio)；google/veo-3.1-fast $0.18/sec (audio)、$0.12/sec (no audio)；openai/sora-2 $0.12/sec；openai/sora-2-pro $0.36/sec (720p)、$0.60/sec (1080p)；kwaivgi/kling-v2.5-turbo-pro $0.09/sec；kwaivgi/kling-v2.6 $0.09/sec；kwaivgi/kling-v2.6-motion-control $0.09/sec (std)、$0.15/sec (pro)；bytedance/seedance-1-pro $0.04/sec (480p)、$0.08/sec (720p)、$0.18/sec (1080p)；bytedance/seedance-1-lite $0.03/sec (480p)、$0.05/sec (720p)、$0.09/sec (1080p)；bytedance/seedance-1-pro-fast $0.02/sec (480p)、$0.03/sec (720p)、$0.08/sec (1080p)；bytedance/seedance-1.5-pro $0.04/sec (720p)、$0.07/sec (720p+audio)；minimax/video-01 $0.60；wan-video/wan-2.2-t2v-fast $0.12；wan-video/wan-2.2-i2v-fast $0.07；wan-video/wan-2.5-i2v-fast $0.09/sec (720p)、$0.13/sec (1080p)；runwayml/gen4-turbo $0.06/sec；runwayml/gen4-aleph $0.22/sec；veed/fabric-1.0 $0.10/sec (480p)、$0.18/sec (768p)；shreejalmaharjan-27/tiktok-short-captions $0.002/sec。

适用边界 · 注意事项

• 无法持有或充值 USDC/USDT/CASH 加密钱包时，付费端点不可用。
• 必须使用传统 API Key、订阅计费或非 x402 协议的服务时，不适用。
• 需要法币结算、发票、企业采购或合规审计且未确认 Frames/x402 支持时，不适用。