x402 Agent API Skill 是一个专为 AI 智能体设计的技能模块，允许其通过 x402 协议安全调用付费 API 接口。该技能的核心目标是让 AI 代理能够自主完成需要支付验证的在线服务请求，例如生成二维码或托管图片资源。它基于开源的 @x402/core 和 @x402/evm 库构建，支持以太坊钱包签名与链上支付流程的无缝集成。开发者只需将配置文件放入项目根目录，并设置环境变量 EVM_PRIVATE_KEY 和 API_BASE_URL，即可让 AI 助手自动处理支付环节，无需人工干预即可完成对受保护 API 的访问。目前主要服务于 https://www.flashcode.live/ 平台上的图像与视觉处理服务，未来还将扩展更多高级功能。
核心功能特点
- 支持 QR 码生成，可自定义尺寸、纠错等级和输出格式（PNG）
- 提供图片上传托管服务，返回公开可访问的在线 URL
- 内置完整的 x402 支付流程，自动处理 402 Payment Required 响应并完成链上支付
- 使用 EVM 私钥进行身份验证与支付签名，确保交易安全性
- 支持健康检查与能力发现接口，便于客户端动态获取服务状态
- 预留多种图像与视频处理 API 接口规划，包括上色、超分辨率、背景移除等
适用场景
该工具特别适合需要为 AI 代理赋予实际网络操作能力的开发场景。例如，在一个自动化内容创作系统中，AI 助手可能需要将用户输入的文本转化为二维码图片并分享链接，此时可直接调用此技能实现端到端的自动化流程，而无需开发者手动介入支付环节。另一个典型应用是智能客服或数字人系统，当用户上传一张模糊照片时，AI 可自动将其上传至云端并返回高清链接供后续展示或处理。此外，对于构建去中心化应用（DApp）中的 AI 组件而言，x402 协议提供了一种轻量级、无需信任第三方支付网关的计费方式，使得 AI 行为本身即可作为价值交换的载体。随着计划中图像增强、OCR 识别和视频分析等功能上线，该技能将进一步拓展其在多媒体处理、智能文档解析及游戏场景理解等领域的实用价值。