ADK-TS와 Coinbase의 x402 프로토콜을 활용해 암호화폐를 벌고 소비하는 AI 에이전트를 구축하세요. 사용량 기반 결제 API와 자율적인 에이전트 경제를 가능하게 합니다.
AI 에이전트는 점점 더 똑똑하고 빠르며 유용해지고 있습니다. 하지만 여전히 어려움을 겪는 부분이 있습니다: 바로 결제입니다.에이전트가 API 호출 비용을 어떻게 지불할 수 있을까요? 개발자가 번거로운 결제 시스템을 만들지 않고 어떻게 에이전트 서비스에 요금을 청구할 수 있을까요?
이 간극을 메우기 위해 Coinbase가 만든 x402 결제 프로토콜이 존재합니다. 그리고 우리의 ADK-TS(Agent Development Kit for TypeScript) 스타터 템플릿을 통해, 개발자가 네이티브 암호화폐 결제를 지원하는 AI 에이전트를 구축할 수 있음을 보여줍니다 — 사용량 기반 결제를 현실화하는 방법입니다.
x402 프로토콜은 Coinbase가 제안한 오픈 스탠다드로, HTTP 402 Payment Required를 현대 웹에 맞게 활용할 수 있도록 합니다.
흐름은 간단합니다:
유료 리소스를 요청하면, 서버는 402 Payment Required 응답을 보내며 지불해야 할 금액, 토큰 종류(예: USDC), 그리고 지불 주소를 알려줍니다.
클라이언트는 온체인 결제를 진행하고, 지불 증명이 담긴 X-PAYMENT 헤더와 함께 요청을 재시도합니다.
서버는 결제를 검증한 뒤 콘텐츠 또는 API 접근을 허용합니다.
이로써 암호화폐 마이크로페이먼트를 기반으로 한 보편적인 인터넷 결제 시스템이 가능해집니다. 신용카드와 달리 센트 단위 이하 금액, 즉시 결제, 전 세계 접근성을 제공합니다.
ADK-TS는 AI 에이전트 구축을 위한 TypeScript 프레임워크로, 단순한 챗봇부터 복잡한 멀티 에이전트 시스템까지 안전하고 견고한 개발을 지원합니다.
여러 AI 모델(OpenAI, Claude, Gemini 등) 기본 지원
메모리, 스트리밍, 세션 관리 기능 내장
외부 서비스/API와의 매끄러운 통합 지원
즉, 단순히 에이전트를 코딩하는 것이 아니라 엔터프라이즈급 AI 시스템을 빠르고 깔끔하게 구축할 수 있습니다.
IQ AI는 에이전트 토큰화 플랫폼(ATP, Agent Tokenization Platform)을 구축하고 있습니다. 여기서 개발자는 에이전트를 발행하고, 프리미엄 기능을 노출하며, 심지어 에이전트 간 자체적으로 거래까지 가능하게 할 수 있습니다.
이를 위해서는 에이전트가 매끄럽게 요금을 청구하고 결제할 수 있어야 합니다. 그래서 ADK-TS에 x402 결제 프로토콜을 통합해, 자율적이고 수익화된 AI 에이전트를 만들 수 있도록 기반을 마련했습니다.
이 둘을 결합하면, 에이전트는 자동으로 온체인 결제를 통해 요금을 청구하고 지불할 수 있습니다.
스타터 템플릿은 이를 세 가지 핵심 요소로 보여줍니다:
서버: x402 결제 프록시 역할, 무료/유료 API 라우트 정의 및 결제 검증
에이전트: 무료 도구로 기본 작업 수행, 유료 도구로 프리미엄 기능 제공
클라이언트: axios 미들웨어 + 지갑 통합 → 결제 요청 처리, 온체인 USDC 지불, 증명 포함 재시도
사용 경험은 매우 매끄럽습니다:
에이전트가 무료 정보(예: API 가격)를 제공합니다.
유료 기능 요청 시, 가격과 결제 동의를 명확히 안내합니다.
승인 후 자동 결제가 진행되고 결과가 반환됩니다.
즉, API 키도, 구독도 필요 없습니다. 오직 암호화폐로 건별 결제만.
ADK-TS x402 템플릿은 두 부분으로 구성됩니다:
서버 컴포넌트: IQ AI API에 연결된 x402 결제 프록시. 무료/유료 라우트 정의 + 가격 조회 API 제공.
에이전트 컴포넌트: 무료 및 유료 기능을 제공하는 TypeScript 기반 에이전트. 항상 GET_PRICES 도구를 통해 가격 투명성 제공.
핵심 로직은 세 파일에 분산되어 있습니다:
server/src/index.ts: 가격 맵 및 결제 미들웨어 정의agent/src/agents/IQ-x402/tools.ts: axios + x402로 무료/유료 기능 구현agent/src/agents/IQ-x402/agent.ts: 사용자와 상호작용, 가격 안내, 결제 동의 요청
템플릿 실행 시, 브라우저 UI(adk-web)에서 에이전트와 직접 상호작용할 수 있습니다.
무료 액션(가격 조회)은 즉시 실행 → 투명성 제공
유료 액션(API 통계 조회 등) → x402 결제 플로우 작동:
서버가 402 응답 반환
지갑이 Base Sepolia 테스트넷 USDC 결제 승인 요청
승인 후, 에이전트가 요청을 재시도해 결과 제공
💡 팁: 테스트 전 Base Sepolia faucet에서 테스트용 USDC와 ETH를 받아두세요.
ADK-TS는 지능을, x402는 경제성을 담당합니다.
ADK-TS: 메모리, 워크플로우, 멀티에이전트 오케스트레이션
x402: 온체인 마이크로페이먼트
함께라면, 에이전트는 스스로 지불, 수익화, 경제 활동을 수행하는 완전한 디지털 경제 주체가 됩니다.
예시:
API 사용량 기반 결제 (구독 불필요)
에이전트끼리 서비스/데이터 거래
광고 없이 데이터/인사이트를 직접 수익화
유저가 유료 기능 요청 → 서버가 402 반환
지갑 팝업: "USDC $0.05 결제하시겠습니까?"
승인 시 자동 결제 → X-PAYMENT 헤더 포함 재요청 → 서버 검증 후 결과 반환
즉, 암호화폐 마이크로페이먼트가 커피 결제만큼 간단해지는 경험을 제공합니다.
이 템플릿은 단순한 PoC가 아닙니다.
구독 모델에서 건별 결제 모델로의 전환
에이전트 마켓플레이스 구축 가능성
탈중앙화 자율 경제 기반 마련
AI가 단순히 똑똑할 뿐 아니라, 경제적 자율성까지 가지게 되는 미래를 열어갑니다.
템플릿은 Base Sepolia 테스트넷에서 실행되며, 무료로 실험할 수 있습니다.
무료/유료 API 라우트가 있는 서버
ADK-TS 기반 에이전트 (무료/유료 기능 포함)
자동 결제를 지원하는 지갑 통합 클라이언트
레포 클론 후 pnpm run dev로 실행해보세요.
인터넷은 수십 년 동안 표준화된 사용량 기반 결제를 기다려왔습니다. Coinbase의 x402가 그 표준을 제공합니다. ADK-TS는 이를 AI 에이전트에 매끄럽게 통합합니다. 그리고 IQ AI는 이러한 수익화된 에이전트가 성장할 생태계를 구축하고 있습니다.
이것은 시작에 불과합니다. 사용량 기반 자율형 AI의 미래는 이제 여러분의 손에 있습니다.
IQ AI x402 Agent Template – ADK-TS + x402 스타터 프로젝트
IQ AI Agent Tokenization Platform – AI 에이전트 발행, 거래, 수익화 플랫폼
ADK-TS GitHub Repository – AI 에이전트 개발용 TypeScript SDK
ADK-TS Documentation – 가이드, API 레퍼런스, 예시
x402 Official Website – x402 공식 사이트 및 업데이트
x402 GitHub Repository (Coinbase) – Coinbase가 유지하는 오픈소스 구현