AI 모델용 x402 API: 요청당 USDC로 결제
RunAPI는 호출당 과금 엔드포인트에서 x402 결제를 지원합니다. 에이전트가 일반 요청을 보내고, 402 견적을 받아 지갑으로 서명하면 결과를 받을 수 있습니다. 계정, API key, 선불 크레딧이 모두 필요 없습니다.
curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \ -H 'Content-Type: application/json' \ --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>- 155 x402로 결제 가능한 리소스
- Base 정산 네트워크
- USDC 결제 자산
- 0 필요한 API key 수
요청부터 결과까지 4단계
-
키 없이 요청 보내기
API key와 함께 보낼 때와 같은 JSON 본문을 POST하되, Authorization 헤더는 빼고 보냅니다.
-
402 견적 확인하기
RunAPI는 정확한 금액, 자산, 네트워크, 수취인이 담긴 PAYMENT-REQUIRED 헤더와 함께 402로 응답합니다. 견적은 300초 동안 유효합니다.
-
서명 후 재시도하기
x402 v2 클라이언트가 에이전트 지갑으로 EIP-3009 승인에 서명하고, PAYMENT-SIGNATURE 헤더를 붙여 요청을 다시 보냅니다.
-
작업 폴링하기
RunAPI는 결제를 정산하고 작업을 시작한 뒤, PAYMENT-RESPONSE 영수증과 결과 조회용 poll_url을 담아 200을 반환합니다.
결제 전에 알아둘 점
가입도 API 키도 필요 없음
결제하는 지갑이 유일한 신원입니다. 계정을 만들거나 키를 보관하거나 잔액을 충전할 필요가 없습니다.
가스비 없는 USDC 결제
결제자가 EIP-3009 승인에 서명하고 Coinbase CDP facilitator가 송금을 제출하므로, 지갑에는 ETH 없이 USDC만 있으면 됩니다.
결과 받기
대부분의 미디어 작업은 비동기로 완료됩니다. 200 응답에는 읽기 전용 작업 액세스 토큰이 포함된 poll_url이 들어 있습니다. 이 토큰으로는 해당 작업 하나만 열 수 있으며, 작업 완료 후 30일 동안 유효합니다.
작업이 실패한 경우
x402에는 기본 환불 기능이 없습니다. 결제된 작업이 실패 상태로 끝나면 RunAPI는 받은 금액 전액에 대한 환불 의무를 기록하고, 이후 운영자가 별도의 USDC 송금으로 결제한 지갑에 돌려줍니다. 환불은 자동으로 이루어지지 않습니다.
지원 대상 엔드포인트
x402는 호출당 고정 가격이 있는 REST 엔드포인트에서 작동합니다. LLM 엔드포인트를 포함해 토큰, 초, 문자 수 단위로 과금되는 모델은 여전히 API key와 크레딧이 필요합니다. MCP 서버는 x402 결제를 받지 않습니다.
API key도 그대로 사용 가능
x402는 추가 결제 수단입니다. 유효한 API key를 보내는 요청은 이전과 똑같이 계정 크레딧을 사용하며, 유효하지 않은 키로 보낸 요청은 결제 견적 대신 401을 받습니다.
실제 요청과 응답
이 응답을 에이전트 지갑에 연결된 x402 v2 클라이언트에 넘기세요. 서명과 재시도는 클라이언트가 처리합니다.
request = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status # => 200response.headers["PAYMENT-RESPONSE"] # settlement receiptresponse.json["poll_url"] # read-only task result URL가격 예시
현재 x402를 지원하는 일부 모델의 호출당 최저 가격입니다. 가격은 실시간 모델 카탈로그에서 가져오며, 모든 402 견적에는 해당 요청의 정확한 금액이 표시됩니다.
| 모델 | 엔드포인트 | 호출당 가격 |
|---|---|---|
| Z Image Text to image z-image | POST /api/v1/z_image/text_to_image | $0.01 |
| Flux Text to image flux-2-klein | POST /api/v1/flux/text_to_image | $0.03 |
| Suno Stitch audio suno-v4 | POST /api/v1/suno/stitch_audio | $0.01 |
| Suno Stitch audio suno-v4.5 | POST /api/v1/suno/stitch_audio | $0.01 |
| Recraft Upscale image recraft-crisp-upscale | POST /api/v1/recraft/upscale_image | $0.01 |
| Recraft Remove background recraft-remove-background | POST /api/v1/recraft/remove_background | $0.01 |
결제 세부 정보
RunAPI는 x402 v2 exact 스킴을 따르며 아래 값만 허용합니다. 그 밖의 값은 RunAPI가 facilitator에 정산을 요청하기 전에 거부됩니다.
| 네트워크 | Base mainnet (eip155:8453) |
|---|---|
| 자산 | USDC, 컨트랙트 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 소수점 6자리 |
| Facilitator | Coinbase CDP |
| 승인 방식 | EIP-3009. 결제자는 USDC만 있으면 되고 가스비용 ETH는 필요 없음 |
| 한도 | 요청당 최대 10 USDC, 견적은 300초 후 만료 |
x402 자주 묻는 질문
x402란 무엇인가요?
x402는 HTTP 402 Payment Required 상태 코드를 기반으로 한 오픈 결제 프로토콜입니다. 서버가 결제 요건과 함께 402로 응답하면, 클라이언트가 서명된 스테이블코인 승인으로 결제하고 요청을 다시 보냅니다. x402 Foundation이 관리합니다.
x402로 결제하려면 RunAPI 계정이 필요한가요?
아니요. 결제하는 지갑이 곧 신원입니다. RunAPI는 첫 정산이 성공한 뒤에만 내부 지갑 프로필을 만들며, 이메일이나 API key를 요구하지 않습니다.
x402 facilitator는 어떤 역할을 하나요?
facilitator는 서명된 결제를 검증하고 Base에서 USDC 송금을 제출합니다. RunAPI는 Coinbase CDP facilitator를 사용하므로 결제자가 가스비를 낼 필요가 없습니다.
요청 한 건의 비용은 얼마인가요?
엔드포인트마다 호출당 고정 가격이 있습니다. 서명하기 전에 402 견적에서 정확한 USDC 금액을 확인할 수 있으며, 현재 가격은 모델 카탈로그에 나와 있습니다.
에이전트가 x402 Bazaar에서 RunAPI를 찾을 수 있나요?
모든 402 견적에는 입력 스키마와 예시가 담긴 Bazaar 디스커버리 선언이 포함되어 있어, x402 클라이언트와 디렉터리가 엔드포인트를 등록할 수 있습니다.
결제했는데 작업이 시작되기 전에 요청이 실패하면 어떻게 되나요?
유효성 검사에 실패한 요청은 결제가 정산되기 전에 거부되므로 요금이 부과되지 않습니다. 결제가 정산된 뒤 작업이 실패하면 전액 환불 의무가 기록됩니다.