AI 에이전트를 위한 자판기: x402 + IteraTools가 자율 마이크로결제를 가능하게 하는 방법
I’m ready to translate the article for you, but I need the full text you’d like translated. Could you please paste the content (or the portion you want translated) here? I’ll keep the source line exactly as you provided and translate the rest into Korean while preserving all formatting and technical terms.
The Problem: AI Agents Need a Simpler Way to Pay for Tools
When an AI agent needs a tool, it shouldn’t have to:
- Fill out a form
- Wait for API‑key approval
- Manage a monthly subscription
It should just pay $0.001 and get what it needs.
Current Workflow for Every External API Call
- Create an account with the API provider
- Enter a credit card (often with KYC)
- Buy credits or a subscription plan – prepaying for a commitment
- Store and manage an API key (security risk)
- Handle billing, renewals, rate limits
This was fine when humans were integrating. AI agents don’t have credit cards, can’t click “Agree to Terms,” and can’t manage rotating keys in a vault.
The internet was built for humans. But agents are using it now.
HTTP 402 “Payment Required” 소개 – x402 프로토콜을 통해
- HTTP 402는 1991년에 예약 상태 코드로 정의되었으며 – “향후 사용을 위해” 지정되었습니다.
- 30년 이상 사용되지 않은 채로 남아 있었습니다.
- 2024: Coinbase가 x402를 공개 표준으로 발표하면서 HTTP 402에 비로소 목적을 부여했습니다.
전체 x402 흐름
- Agent가 HTTP 요청을 전송 → Server가
402와 결제 요구 사항을 응답합니다. - Agent가 가스‑없는 USDC 승인(EIP‑3009, 가스 필요 없음)에 서명합니다.
- Agent가
X-Payment헤더를 포함해 다시 요청합니다. - Server가 검증 → Base에서 정산 →
200 OK를 반환합니다.
계정도 없고, API 키도 없고, 구독도 없습니다.
에이전트는 지갑을 가지고 호출당 비용을 지불하며 리소스를 얻습니다 – 인터넷을 위한 자판기와 같습니다.
402 응답 예시
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 1,
"error": "X-Payment header is required",
"accepts": [
{
"scheme": "exact",
"network": "base",
"maxAmountRequired": "1000",
"resource": "https://api.iteratools.com/qrcode",
"description": "QR code generation",
"payTo": "0xa81Dbd562436511dE5268BF70cF124C2689Ab11a",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
]
}- 결제 금액은 기계가 읽을 수 있는 형태로 제공됩니다.
- 지갑 주소는 응답에 포함됩니다.
- 에이전트는 별도로 누구에게 물어볼 필요 없이 바로 결제하면 됩니다.
전통적인 API가 AI 에이전트에 맞지 않는 이유
| 인간 중심 요구사항 | AI 에이전트 현실 |
|---|---|
| 서비스 약관을 읽을 수 있음 | 읽고 수락할 UI 없음 |
| 신용카드 보유 | 신용카드 없음 |
| 승인 이메일을 기다림 | 즉각적인 응답 필요 |
.env 파일에 자격 증명 저장 | 프로그램 방식의 온체인 결제 필요 |
AI 에이전트가 필요로 하는 것
- 자율적인 코드 실행
- 암호화폐 지갑 보유 능력 (CDP, viem 등 활용)
- 추론 루프 내에서 밀리초 단위 결제
- $0.001 API 호출에 인간 개입 전혀 없음
x402는 에이전트의 사고 모델과 완벽히 일치합니다:
“이 리소스가 필요합니다. 비용이 얼마인가요? 여기 결제합니다. 리소스를 주세요.”
이는 자동 판매기의 논리와 정확히 같습니다: 돈을 넣으면 → 제품을 받는다. 계정도, 구독도, 서류도 필요 없습니다.
IteraTools: AI 에이전트를 위해 구축된 41가지 유틸리티 도구 (x402‑호환)
| 카테고리 | 도구 | 시작 가격 |
|---|---|---|
| 텍스트 | TTS, 번역, 요약, 감성 | $0.001 /call |
| 웹 | 검색, 스크래핑, 스크린샷 | $0.001–$0.002 /call |
| 이미지 | QR 코드, 생성, 분류 | $0.001–$0.005 /call |
| 데이터 | CSV 파싱, 차트, 추출 | $0.001–$0.002 /call |
| 커뮤니케이션 | WhatsApp 전송, 이메일 | $0.002 /call |
| 코드 | Python/JS 샌드박스 실행 | $0.001 /call |
- 구독이 필요 없음 시작하려면.
- 관리할 API 키가 없음.
- USDC 몇 센트만 있는 Base 지갑만 있으면 됩니다.
전체 Node.js 에이전트 예제 (인간 개입 없음)
import { withPaymentInterceptor } from '@x402/fetch';
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';
// ---------------------------------------------------
// 1️⃣ Agent’s wallet – loaded from environment
// ---------------------------------------------------
const wallet = createWalletClient({
account: privateKeyToAccount(process.env.AGENT_PRIVATE_KEY),
chain: base,
transport: http(),
});
// ---------------------------------------------------
// 2️⃣ Wrap fetch – x402/fetch handles 402 automatically
// ---------------------------------------------------
const payingFetch = withPaymentInterceptor(fetch, wallet);
// ---------------------------------------------------
// 3️⃣ Research a topic (cost $0.001)
// ---------------------------------------------------
const searchRes = await payingFetch('https://api.iteratools.com/search', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ query: 'x402 protocol AI agents', num: 5 }),
});
const searchData = await searchRes.json();
// ---------------------------------------------------
// 4️⃣ Summarize the results (cost $0.002)
// ---------------------------------------------------
const summaryRes = await payingFetch('https://api.iteratools.com/summarize', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
text: searchData.results.map(r => r.snippet).join('\n')
}),
});
const summary = await summaryRes.json();
// ---------------------------------------------------
// 5️⃣ Generate a QR code linking to the source (cost $0.001)
// ---------------------------------------------------
const qrRes = await payingFetch('https://api.iteratools.com/qrcode', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text: searchData.results[0].url }),
});
const qr = await qrRes.json();
// ---------------------------------------------------
// 6️⃣ Output (total cost $0.004 USDC)
// ---------------------------------------------------
console.log('Summary:', summary.text);
console.log('QR Code:', qr.qr_url);withPaymentInterceptor가 하는 일
| 단계 | 동작 |
|---|---|
| 초기 요청 | 요청을 정상적으로 보냅니다. |
| 402 수신 | maxAmountRequired, payTo, asset, network를 파싱합니다. |
| EIP‑3009 인증 생성 | { from, to, value, validAfter, validBefore, nonce }. |
| 서명 | EIP‑712 (typed‑data 서명) 사용 – 가스 없음. |
| 인코딩 | X-Payment 헤더에 Base64 인코딩된 JSON을 삽입합니다. |
| 재시도 | 헤더와 함께 요청을 다시 보냅니다. |
| 성공 | 서버가 도구의 응답과 함께 200 OK를 반환합니다. |
- 에이전트는 결제가 발생했는지 전혀 알지 못합니다 – 단지 데이터를 받습니다.
- 에이전트는 가스가 전혀 소모되지 않으며; 서버의 정산자가 Base에서 가스를 지불합니다.
- 유일한 요구사항: 에이전트가 Base 네트워크에 충분한 USDC를 보유하고 있어야 합니다.
서버 (IteraTools)가 결제를 처리하는 방법
- EIP‑712 서명을 검증합니다.
- 수신자, 금액, 시간 창, 그리고 nonce를 검증합니다.
- Base 체인에서
USDC.transferWithAuthorization을 호출합니다 (정산자가 가스 비용을 부담). - 요청된 툴을 실행합니다.
- 결과를 에이전트에게 반환합니다.
요약
- x402는 HTTP 402를 실용적이고 기계가 읽을 수 있는 결제 흐름으로 전환합니다.
- AI 에이전트는 암호화 지갑으로 콜당 결제를 할 수 있어 인간 중심의 온보딩이 필요 없게 됩니다.
- IteraTools는 저비용의 x402‑호환 유틸리티 카탈로그를 즉시 제공하여 에이전트가 텍스트, 웹, 이미지, 데이터, 커뮤니케이션, 코드 영역에서 자율적으로 작업할 수 있게 합니다.
인터넷은 인간을 위해 만들어졌지만, x402와 함께라면 이제 에이전트에게도 작동합니다.
에이전트 간 상거래
오케스트레이터 에이전트는 각각 자체 자금이 충전된 지갑을 가진 서브‑에이전트를 생성하고, 이들이 도구를 자율적으로 구매하도록 할 수 있습니다:
Orchestrator Agent
├── Research Agent → pays $0.001 for /search
│ → pays $0.002 for /scrape
├── Writing Agent → pays $0.002 for /summarize
│ → pays $0.001 for /sentiment
└── Media Agent → pays $0.005 for /image/generate
→ pays $0.001 for /tts총액: $0.012 USDC — Base에서 정산되며, 인간이 개입하지 않음
이것이 멀티‑에이전트 경제입니다. 에이전트들은 API 키를 공유하지 않으며, 각자 지갑을 가지고 사용한 만큼만 비용을 지불합니다. 오케스트레이터는 작업에 필요한 정확한 금액만 서브‑에이전트에 제공할 수 있어 과다 지출이 없습니다.
전통 API vs. x402 + IteraTools
| Feature | Traditional API | x402 + IteraTools |
|---|---|---|
| Onboarding | 계정 생성, KYC, 신용카드 | 없음 — 지갑만 필요 |
| Access | 헤더에 API 키 | 헤더에 결제 정보 |
| Billing | 월 구독 또는 선불 크레딧 | 콜당 결제, 몇 센트 |
| Automation | 수동 키 교체, 모니터링 | 완전 자동 |
| Agent‑native | 아니오 — 인간을 위해 설계됨 | 예 — 에이전트를 위해 설계됨 |
| Privacy | 제공자가 모든 호출을 추적 | 온체인, 가명 |
시작하기
에이전트 개발자(구매자)로서
npm install @x402/fetch viem @iteratools/mcpimport { withPaymentInterceptor } from '@x402/fetch';
// Base 지갑에 USDC $1을 충전하세요
// 사용된 도구에 따라 약 100‑1000회의 API 호출이 가능합니다MCP 사용자(Claude, Cursor 등)로서
npx @iteratools/mcp- 41개의 도구를 즉시 사용할 수 있습니다. API 키가 필요 없으며, 사용량에 따라 비용을 지불합니다.
실시간 402 응답 확인하기
curl -s -X POST https://api.iteratools.com/qrcode \
-H "Content-Type: application/json" \
-d '{"text":"hello world"}'실제 402 응답과 결제 안내를 확인할 수 있습니다.
왜 x402인가?
x402는 단순한 결제 프로토콜이 아니라 자율 에이전트를 위한 기능 잠금 해제입니다.
오늘날 대부분의 AI 에이전트는 제작자가 사전에 승인하고 선불로 결제한 도구에만 제한됩니다. x402를 사용하면 에이전트가 전 세계 x402‑호환 서비스를 실시간으로, 자동으로, 몇 센트만으로도 발견하고 결제할 수 있습니다.
API의 인터넷이 에이전트 도구의 인터넷이 됩니다.
IteraTools는 이 모델을 기반으로 구축하고 있습니다:
- 오늘날 41개의 도구, 매달 추가 예정
- Base 지갑과 소액의 USDC(몇 달러)만 있으면 어떤 에이전트도 사용 가능
자판기가 열렸습니다. USDC를 넣고 도구를 꺼내세요.
IteraTools: https://iteratools.com
빠른 명령
# Test the 402 endpoint
curl -s -X POST https://api.iteratools.com/qrcode \
-H 'Content-Type: application/json' \
-d '{"text":"test"}'
# Run the MCP package
npx @iteratools/mcp리소스
- x402 프로토콜: https://x402.org | https://docs.x402.org
- GitHub (x402): https://github.com/coinbase/x402
- 실시간 402 데모 스크립트: https://github.com/fredpsantos33/iteratools-x402-demo
Contact
IteraTools는 Iterasoft에 의해 제작되었습니다. AI 에이전트를 구축하고 계시다면, 여러분의 이야기를 듣고 싶습니다.