--- title: 'x402 API: AI 모델을 요청당 USDC로 결제, API key 불필요 | RunAPI' description: RunAPI의 이미지, 동영상, 음악, 오디오 모델을 x402로 호출하세요. 에이전트가 Base에서 USDC로 요청마다 결제하며, 가입, API key, 크레딧이 필요 없습니다. url: https://runapi.ai/ko/x402.md canonical: https://runapi.ai/ko/x402 locale: ko updated: '2026-09-24' date: '2026-09-24' site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/x402 zh-CN: https://runapi.ai/zh-CN/x402 es: https://runapi.ai/es/x402 ja: https://runapi.ai/ja/x402 de: https://runapi.ai/de/x402 fr: https://runapi.ai/fr/x402 pt-BR: https://runapi.ai/pt-BR/x402 ko: https://runapi.ai/ko/x402 it: https://runapi.ai/it/x402 nl: https://runapi.ai/nl/x402 pl: https://runapi.ai/pl/x402 tr: https://runapi.ai/tr/x402 zh-TW: https://runapi.ai/zh-TW/x402 zh-HK: https://runapi.ai/zh-HK/x402 ar: https://runapi.ai/ar/x402 x-default: https://runapi.ai/x402 --- > HTML version: https://runapi.ai/ko/x402 > Site index for agents: https://runapi.ai/llms.txt # AI 모델용 x402 API: 요청당 USDC로 결제 RunAPI는 호출당 과금 엔드포인트에서 x402 결제를 지원합니다. 에이전트가 일반 요청을 보내고, 402 견적을 받아 지갑으로 서명하면 결과를 받을 수 있습니다. 계정, API key, 선불 크레딧이 모두 필요 없습니다. _업데이트 September 24, 2026 · 6분 읽기_ ## Key takeaways - 조건을 충족하는 RunAPI 호출당 과금 엔드포인트(호출당 10 USDC 이하)는 인증되지 않은 요청에 표준 x402 v2 견적으로 응답합니다. - 결제는 Coinbase CDP facilitator를 통해 Base에서 USDC로 정산됩니다. 결제자는 EIP-3009 승인에 서명하기만 하면 되며 가스비를 내지 않습니다. - 결제된 요청은 일반 응답과 함께 읽기 전용 폴링 URL을 반환하므로, 에이전트가 계정 없이도 완료된 작업을 가져올 수 있습니다. - **155** x402로 결제 가능한 리소스 - **Base** 정산 네트워크 - **USDC** 결제 자산 - **0** 필요한 API key 수 ## 요청부터 결과까지 4단계 1. **키 없이 요청 보내기** API key와 함께 보낼 때와 같은 JSON 본문을 POST하되, Authorization 헤더는 빼고 보냅니다. 2. **402 견적 확인하기** RunAPI는 정확한 금액, 자산, 네트워크, 수취인이 담긴 PAYMENT-REQUIRED 헤더와 함께 402로 응답합니다. 견적은 300초 동안 유효합니다. 3. **서명 후 재시도하기** x402 v2 클라이언트가 에이전트 지갑으로 EIP-3009 승인에 서명하고, PAYMENT-SIGNATURE 헤더를 붙여 요청을 다시 보냅니다. 4. **작업 폴링하기** RunAPI는 결제를 정산하고 작업을 시작한 뒤, PAYMENT-RESPONSE 영수증과 결과 조회용 poll_url을 담아 200을 반환합니다. ## 실제 요청과 응답 첫 요청에는 인증 정보가 없습니다. 결제 가능한 엔드포인트라면 RunAPI가 402와 결제 요건을 반환합니다. ```shell 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: ``` 이 응답을 에이전트 지갑에 연결된 x402 v2 클라이언트에 넘기세요. 서명과 재시도는 클라이언트가 처리합니다. ```text 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 # => 200 response.headers["PAYMENT-RESPONSE"] # settlement receipt response.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초 후 만료 ## 결과 받기 대부분의 미디어 작업은 비동기로 완료됩니다. 200 응답에는 읽기 전용 작업 액세스 토큰이 포함된 poll_url이 들어 있습니다. 이 토큰으로는 해당 작업 하나만 열 수 있으며, 작업 완료 후 30일 동안 유효합니다. ## 작업이 실패한 경우 x402에는 기본 환불 기능이 없습니다. 결제된 작업이 실패 상태로 끝나면 RunAPI는 받은 금액 전액에 대한 환불 의무를 기록하고, 이후 운영자가 별도의 USDC 송금으로 결제한 지갑에 돌려줍니다. 환불은 자동으로 이루어지지 않습니다. ## 지원 대상 엔드포인트 x402는 호출당 고정 가격이 있는 REST 엔드포인트에서 작동합니다. LLM 엔드포인트를 포함해 토큰, 초, 문자 수 단위로 과금되는 모델은 여전히 API key와 크레딧이 필요합니다. MCP 서버는 x402 결제를 받지 않습니다. ## API key도 그대로 사용 가능 x402는 추가 결제 수단입니다. 유효한 API key를 보내는 요청은 이전과 똑같이 계정 크레딧을 사용하며, 유효하지 않은 키로 보낸 요청은 결제 견적 대신 401을 받습니다. ## 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 클라이언트와 디렉터리가 엔드포인트를 등록할 수 있습니다. ### 결제했는데 작업이 시작되기 전에 요청이 실패하면 어떻게 되나요? 유효성 검사에 실패한 요청은 결제가 정산되기 전에 거부되므로 요금이 부과되지 않습니다. 결제가 정산된 뒤 작업이 실패하면 전액 환불 의무가 기록됩니다. ## 관련 페이지 - [HTTP 402란?](https://runapi.ai/ko/http-402.md) - x402의 기반이 되는 상태 코드와 API가 이를 반환하는 이유. - [모델 카탈로그](https://runapi.ai/ko/models.md) - RunAPI에서 사용할 수 있는 모든 모델과 엔드포인트. - [개발자 문서](https://runapi.ai/ko/docs/guides) - 요청 형식, 작업 폴링, 오류 코드. - [CLI](https://runapi.ai/ko/cli.md) - 터미널이나 에이전트 셸에서 모델 실행. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## 에이전트가 API 호출 비용을 직접 결제하게 하세요 모델을 둘러보고 호출당 과금 엔드포인트를 골라, 키 없이 첫 요청을 보내보세요. - [모델 둘러보기](https://runapi.ai/ko/models.md) - [문서 읽기](https://runapi.ai/ko/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) - [x402 API](https://runapi.ai/ko/x402.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Article", "headline": "x402 API: AI 모델을 요청당 USDC로 결제, API key 불필요", "description": "RunAPI의 이미지, 동영상, 음악, 오디오 모델을 x402로 호출하세요. 에이전트가 Base에서 USDC로 요청마다 결제하며, 가입, API key, 크레딧이 필요 없습니다.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko" }, "mainEntityOfPage": "https://runapi.ai/ko/x402" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "x402로 RunAPI 요청 비용을 결제하는 방법", "description": "에이전트가 x402 v2 프로토콜을 사용해 Base에서 USDC로 RunAPI 요청 한 건의 비용을 결제합니다.", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "키 없이 요청 보내기", "text": "API key와 함께 보낼 때와 같은 JSON 본문을 POST하되, Authorization 헤더는 빼고 보냅니다.", "url": "https://runapi.ai/ko/x402#four-step-getting-started-step-1" }, { "@type": "HowToStep", "position": 2, "name": "402 견적 확인하기", "text": "RunAPI는 정확한 금액, 자산, 네트워크, 수취인이 담긴 PAYMENT-REQUIRED 헤더와 함께 402로 응답합니다. 견적은 300초 동안 유효합니다.", "url": "https://runapi.ai/ko/x402#four-step-getting-started-step-2" }, { "@type": "HowToStep", "position": 3, "name": "서명 후 재시도하기", "text": "x402 v2 클라이언트가 에이전트 지갑으로 EIP-3009 승인에 서명하고, PAYMENT-SIGNATURE 헤더를 붙여 요청을 다시 보냅니다.", "url": "https://runapi.ai/ko/x402#four-step-getting-started-step-3" }, { "@type": "HowToStep", "position": 4, "name": "작업 폴링하기", "text": "RunAPI는 결제를 정산하고 작업을 시작한 뒤, PAYMENT-RESPONSE 영수증과 결과 조회용 poll_url을 담아 200을 반환합니다.", "url": "https://runapi.ai/ko/x402#four-step-getting-started-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "x402란 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "x402는 HTTP 402 Payment Required 상태 코드를 기반으로 한 오픈 결제 프로토콜입니다. 서버가 결제 요건과 함께 402로 응답하면, 클라이언트가 서명된 스테이블코인 승인으로 결제하고 요청을 다시 보냅니다. x402 Foundation이 관리합니다." } }, { "@type": "Question", "name": "x402로 결제하려면 RunAPI 계정이 필요한가요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. 결제하는 지갑이 곧 신원입니다. RunAPI는 첫 정산이 성공한 뒤에만 내부 지갑 프로필을 만들며, 이메일이나 API key를 요구하지 않습니다." } }, { "@type": "Question", "name": "x402 facilitator는 어떤 역할을 하나요?", "acceptedAnswer": { "@type": "Answer", "text": "facilitator는 서명된 결제를 검증하고 Base에서 USDC 송금을 제출합니다. RunAPI는 Coinbase CDP facilitator를 사용하므로 결제자가 가스비를 낼 필요가 없습니다." } }, { "@type": "Question", "name": "요청 한 건의 비용은 얼마인가요?", "acceptedAnswer": { "@type": "Answer", "text": "엔드포인트마다 호출당 고정 가격이 있습니다. 서명하기 전에 402 견적에서 정확한 USDC 금액을 확인할 수 있으며, 현재 가격은 모델 카탈로그에 나와 있습니다." } }, { "@type": "Question", "name": "에이전트가 x402 Bazaar에서 RunAPI를 찾을 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "모든 402 견적에는 입력 스키마와 예시가 담긴 Bazaar 디스커버리 선언이 포함되어 있어, x402 클라이언트와 디렉터리가 엔드포인트를 등록할 수 있습니다." } }, { "@type": "Question", "name": "결제했는데 작업이 시작되기 전에 요청이 실패하면 어떻게 되나요?", "acceptedAnswer": { "@type": "Answer", "text": "유효성 검사에 실패한 요청은 결제가 정산되기 전에 거부되므로 요금이 부과되지 않습니다. 결제가 정산된 뒤 작업이 실패하면 전액 환불 의무가 기록됩니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "x402 API", "item": "https://runapi.ai/ko/x402" } ] } ] ```