DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.
DGrid x402 API는 API 결제를 위한 DGrid의 추론당 결제 액세스 방식입니다. 계정을 만들거나, 잔액을 미리 충전하거나, 별도의 과금 흐름을 관리하는 대신 개발자와 자율 에이전트는 API 요청 수명 주기의 일부로 x402 결제 프로토콜을 통해 LLM 추론 비용을 직접 결제할 수 있습니다.이 방식은 특히 다음과 같은 경우에 유용합니다.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"DGrid AI Docs","description":"Documentation for DGrid AI: The Decentralized Smart Network of AI","colors":{"primary":"#65A30D","light":"#A3E635","dark":"#4D7C0F"},"logo":{"light":"https://mintcdn.com/dgridai/eFrQx07adP_MQw0i/logo/dgrid-horizontal-black.png?fit=max\u0026auto=format\u0026n=eFrQx07adP_MQw0i\u0026q=85\u0026s=aa7da302786ec058e3c91526a127736d","dark":"https://mintcdn.com/dgridai/eFrQx07adP_MQw0i/logo/dgrid-horizontal-white.png?fit=max\u0026auto=format\u0026n=eFrQx07adP_MQw0i\u0026q=85\u0026s=62aa06e50e86ab2394beada6a4814623"},"favicon":"https://mintcdn.com/dgridai/eFrQx07adP_MQw0i/favicon.png?fit=max\u0026auto=format\u0026n=eFrQx07adP_MQw0i\u0026q=85\u0026s=75fcb6ffc8e30d1e2be00c994cc0372e","api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript","go","java"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"Blog"},{"href":"https://telegram.me/dgrid_ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dgrid.ai/overview"}},"footer":{"socials":{"x":"https://x.com/dgrid_ai","telegram":"https://telegram.me/dgrid_ai","github":"https://github.com/dgridai"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":""},{"language":"zh-Hant","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"部落格"},{"href":"https://telegram.me/dgrid_ai","label":"支援"}],"primary":{"type":"button","label":"儀表板","href":"https://dgrid.ai/overview"}},"href":"zh-Hant"},{"language":"ko","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"블로그"},{"href":"https://telegram.me/dgrid_ai","label":"지원"}],"primary":{"type":"button","label":"대시보드","href":"https://dgrid.ai/overview"}},"href":"ko"},{"language":"fr","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"Blog"},{"href":"https://telegram.me/dgrid_ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://dgrid.ai/overview"}},"href":"fr"},{"language":"es","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"Blog"},{"href":"https://telegram.me/dgrid_ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://dgrid.ai/overview"}},"href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dgridai","hasAudioNarration":false,"actualSubdomain":"dgridai","customDomains":["docs.dgrid.ai"],"gitSource":{"type":"github","owner":"ethanclarkeio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"146373a5-1310-4927-bf4d-bc5f1b23b737","liveDeploymentHistoryId":"6adb04f0a28cf93daee93294","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb04f0a28cf93daee93294"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adb04f0a28cf93daee93294","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"en","tag":"Documentation","count":36},{"language":"es","tag":"Documentación","count":36},{"language":"fr","tag":"Documentation","count":36},{"language":"ko","tag":"문서","count":36},{"language":"zh-Hant","tag":"文件","count":36},{"language":"en","tag":"API Reference","count":28},{"language":"es","tag":"Referencia de la API","count":28},{"language":"fr","tag":"Référence API","count":28},{"language":"ko","tag":"API 참조","count":28},{"language":"zh-Hant","tag":"API 參考","count":28},{"language":"en","tag":"MODEL API","count":22},{"language":"es","tag":"API DE MODELOS","count":22},{"language":"fr","tag":"API DE MODÈLES","count":22},{"language":"ko","tag":"모델 API","count":22},{"language":"zh-Hant","tag":"模型 API","count":22},{"language":"en","tag":"AI GATEWAY","count":13},{"language":"es","tag":"PUERTA DE ENLACE IA","count":13},{"language":"fr","tag":"PASSERELLE IA","count":13},{"language":"ko","tag":"AI 게이트웨이","count":13},{"language":"zh-Hant","tag":"AI 閘道","count":13},{"language":"en","tag":"Integration Tutorials","count":7},{"language":"es","tag":"Tutoriales de integración","count":7},{"language":"fr","tag":"Tutoriels d'intégration","count":7},{"language":"ko","tag":"통합 가이드","count":7},{"language":"zh-Hant","tag":"整合教學","count":7},{"language":"en","tag":"Images","count":6},{"language":"en","tag":"GENESIS PREMIUM","count":6},{"language":"es","tag":"Imágenes","count":6},{"language":"es","tag":"GENESIS PREMIUM","count":6},{"language":"fr","tag":"Images","count":6},{"language":"fr","tag":"GENESIS PREMIUM","count":6},{"language":"ko","tag":"이미지","count":6},{"language":"ko","tag":"GENESIS PREMIUM","count":6},{"language":"zh-Hant","tag":"圖像","count":6},{"language":"zh-Hant","tag":"GENESIS PREMIUM","count":6},{"language":"en","tag":"Chat","count":5},{"language":"es","tag":"Chat","count":5},{"language":"fr","tag":"Chat","count":5},{"language":"ko","tag":"채팅","count":5},{"language":"zh-Hant","tag":"對話","count":5},{"language":"en","tag":"Audio","count":4},{"language":"en","tag":"CORE CONCEPTS","count":4},{"language":"es","tag":"Audio","count":4},{"language":"es","tag":"CONCEPTOS CLAVE","count":4},{"language":"fr","tag":"Audio","count":4},{"language":"fr","tag":"CONCEPTS CLÉS","count":4},{"language":"ko","tag":"오디오","count":4},{"language":"ko","tag":"핵심 개념","count":4},{"language":"zh-Hant","tag":"音訊","count":4},{"language":"zh-Hant","tag":"核心概念","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ko/x402/overview","slug":"/ko/x402/overview","pageMetadata":{"title":"x402 API","sidebarTitle":"개요","description":"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.","href":"/ko/x402/overview"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(`strong`,{children:`DGrid x402 API`}),`는 API 결제를 위한 DGrid의 추론당 결제 액세스 방식입니다. 계정을 만들거나, 잔액을 미리 충전하거나, 별도의 과금 흐름을 관리하는 대신 개발자와 자율 에이전트는 API 요청 수명 주기의 일부로 `,_jsx(`strong`,{children:`x402 결제 프로토콜`}),`을 통해 LLM 추론 비용을 직접 결제할 수 있습니다.`]}),`\n`,_jsx(_components.p,{children:`이 방식은 특히 다음과 같은 경우에 유용합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`LLM을 호출하고 즉시 결제를 완료해야 하는 `,_jsx(`strong`,{children:`에이전트 및 자율 워크플로`})]}),`\n`,_jsxs(_components.li,{children:[`계정 발급과 수동 충전을 피해야 하는 `,_jsx(`strong`,{children:`서버 측 도구 및 스크립트`})]}),`\n`,_jsxs(_components.li,{children:[`가장 단순한 경로가 “추론 요청 → 결제 승인 → 결과 수신”인 `,_jsx(`strong`,{children:`온디맨드 통합`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`x402-api가-중요한-이유`,children:`x402 API가 중요한 이유`}),`\n`,_jsx(_components.p,{children:`기존 AI 과금 방식은 보통 다음을 요구합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`공급자 계정 생성`}),`\n`,_jsx(_components.li,{children:`선불 잔액 충전 또는 결제 수단 연결`}),`\n`,_jsx(_components.li,{children:`API 키, 사용량 한도, 결제 대시보드 관리`}),`\n`]}),`\n`,_jsx(_components.p,{children:`DGrid에서 x402를 사용하면 흐름이 훨씬 직접적이 됩니다.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`추론 요청 → 결제 요구사항 수신 → 한 번 서명 → 결제와 추론을 함께 제출`})}),`\n`,_jsx(_components.p,{children:`에이전트 시스템에서는 이것이 큰 단순화입니다. 어떤 모델을 쓸지 결정하는 동일한 런타임이 별도의 계정 관리 워크플로로 전환하지 않고도 그 추론 호출 비용을 승인하고 정산할 수 있습니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`주요-사용-사례-에이전트의-추론-비용-결제`,children:`주요 사용 사례: 에이전트의 추론 비용 결제`}),`\n`,_jsxs(_components.p,{children:[`x402는 `,_jsx(`strong`,{children:`에이전트`}),`가 다음을 수행해야 하는 경우를 위해 설계되었습니다.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`모델 선택`}),`\n`,_jsx(_components.li,{children:`모델 API 호출`}),`\n`,_jsx(_components.li,{children:`추론 수수료 결제`}),`\n`,_jsx(_components.li,{children:`결과를 받아 다음 실행으로 진행`}),`\n`]}),`\n`,_jsx(_components.p,{children:`다음과 같은 경우에 특히 가치가 있습니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`백엔드 워크플로에서 동작하는 AI 에이전트`}),`\n`,_jsx(_components.li,{children:`결제 인식 추론을 원하는 Web3 에이전트 또는 프로토콜`}),`\n`,_jsx(_components.li,{children:`추론을 직접 결제 가능한 리소스로 다뤄야 하는 다단계 자동화`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`흐름-작동-방식`,children:`흐름 작동 방식`}),`\n`,_jsxs(_components.p,{children:[`DGrid의 x402는 `,_jsx(`strong`,{children:`2단계 요청 흐름`}),`을 사용합니다.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(`strong`,{children:[_jsx(_components.code,{children:`x-payment`}),` 없는 초기 요청`]}),`\n서버는 `,_jsx(_components.code,{children:`402 Payment Required`}),`와 함께 서명 가능한 결제 요구사항을 반환합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`strong`,{children:`클라이언트 서명 후 재시도`}),`\n클라이언트가 `,_jsx(_components.code,{children:`x-payment`}),` 페이로드를 생성하고 동일한 추론 요청을 결제 헤더와 함께 다시 보냅니다.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`이 패턴은 결제 승인을 명시적으로 유지하면서도 추론 호출 자체는 단순하고 자동화하기 쉬운 상태로 유지합니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`지원-결제-자산`,children:`지원 결제 자산`}),`\n`,_jsx(_components.p,{children:`현재 x402 엔드포인트는 다음을 사용합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(`strong`,{children:`프로토콜`}),`: x402`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`strong`,{children:`네트워크`}),`: `,_jsx(_components.code,{children:`eip155:56`}),` (BSC)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`strong`,{children:`결제 토큰`}),`: `,_jsx(_components.code,{children:`USD1`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(`strong`,{children:`자산 컨트랙트`}),`: `,_jsx(_components.code,{children:`0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`운영-참고`,children:`운영 참고`}),`\n`,_jsxs(_components.p,{children:[`정산이 성공하면 서비스는 백엔드의 `,_jsx(_components.code,{children:`x402_payment_logs`}),` 테이블에 결제 로그를 기록합니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`x402와-ai-gateway를-언제-써야-하나요`,children:`x402와 AI Gateway를 언제 써야 하나요?`}),`\n`,_jsxs(_components.p,{children:[`다음이 필요하다면 `,_jsx(`strong`,{children:`AI Gateway`}),`를 사용하세요.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`전통적인 API 키 접근`}),`\n`,_jsx(_components.li,{children:`통합 계정 기반 모델 라우팅`}),`\n`,_jsx(_components.li,{children:`표준 과금 워크플로를 갖춘 장기 제품 통합`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`다음이 필요하다면 `,_jsx(`strong`,{children:`x402`}),`를 사용하세요.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`요청별 직접 결제`}),`\n`,_jsx(_components.li,{children:`미리 충전한 계정 잔액 없음`}),`\n`,_jsx(_components.li,{children:`하나의 흐름에서 에이전트 친화적 추론과 결제`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"x402 API","sidebarTitle":"개요","description":"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.","href":"/ko/x402/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"x402 API가 중요한 이유","slug":"x402-api가-중요한-이유","depth":2,"children":[]},{"title":"주요 사용 사례: 에이전트의 추론 비용 결제","slug":"주요-사용-사례-에이전트의-추론-비용-결제","depth":2,"children":[]},{"title":"흐름 작동 방식","slug":"흐름-작동-방식","depth":2,"children":[]},{"title":"지원 결제 자산","slug":"지원-결제-자산","depth":2,"children":[]},{"title":"운영 참고","slug":"운영-참고","depth":2,"children":[]},{"title":"x402와 AI Gateway를 언제 써야 하나요?","slug":"x402와-ai-gateway를-언제-써야-하나요","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"dgridai","siteName":"DGrid AI Docs","title":"x402 API - DGrid AI Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/x402/overview","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/x402/overview","matchLevel":1},"ko":{"href":"/ko/x402/overview","matchLevel":0},"fr":{"href":"/fr/x402/overview","matchLevel":1},"es":{"href":"/es/x402/overview","matchLevel":1}}},"lastModified":"2026-07-02T09:33:56.819Z","originalFileLocation":"ko/x402/overview.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DGrid AI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"x402 API - DGrid AI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DGrid AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dgrid.ai/ko/x402/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dgridai.mintlify.app/_mintlify/api/og/v2?division=X402+API\u0026amp;title=x402+API\u0026amp;description=DGrid+x402+API%EB%8A%94+x402+%EB%A7%88%EC%9D%B4%ED%81%AC%EB%A1%9C%EA%B2%B0%EC%A0%9C+%ED%94%84%EB%A1%9C%ED%86%A0%EC%BD%9C%EC%9D%84+%ED%99%9C%EC%9A%A9%ED%95%B4+%EC%B6%94%EB%A1%A0+%ED%98%B8%EC%B6%9C%EB%A7%88%EB%8B%A4+%EB%B9%84%EC%9A%A9%EC%9D%84+%EC%A7%80%EB%B6%88%ED%95%98%EB%8A%94+%EC%A2%85%EB%9F%89%EC%A0%9C+%EC%84%9C%EB%B9%84%EC%8A%A4%EC%9D%B4%EB%A9%B0%2C+API+%ED%82%A4%EB%82%98+%EA%B3%84%EC%A0%95+%EC%97%86%EC%9D%B4+%EC%A6%89%EC%8B%9C+%EC%82%AC%EC%9A%A9%ED%95%A0+%EC%88%98+%EC%9E%88%EA%B3%A0+%EC%9E%90%EB%8F%99%ED%99%94+%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C%EC%99%80+%EA%B2%B0%EC%A0%9C+%EC%9D%BC%EC%B2%B4%ED%98%95+AI+%ED%86%B5%ED%95%A9+%EC%8B%9C%EB%82%98%EB%A6%AC%EC%98%A4%EC%97%90+%ED%8A%B9%ED%9E%88+%EC%A0%81%ED%95%A9%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=f10c407df10598d9a9a44a09\u0026amp;signature=870aefdab351f4406e855694fc1295d1cb9602f6ff965bdb9b9866fd7617ded0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"x402 API - DGrid AI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dgridai.mintlify.app/_mintlify/api/og/v2?division=X402+API\u0026amp;title=x402+API\u0026amp;description=DGrid+x402+API%EB%8A%94+x402+%EB%A7%88%EC%9D%B4%ED%81%AC%EB%A1%9C%EA%B2%B0%EC%A0%9C+%ED%94%84%EB%A1%9C%ED%86%A0%EC%BD%9C%EC%9D%84+%ED%99%9C%EC%9A%A9%ED%95%B4+%EC%B6%94%EB%A1%A0+%ED%98%B8%EC%B6%9C%EB%A7%88%EB%8B%A4+%EB%B9%84%EC%9A%A9%EC%9D%84+%EC%A7%80%EB%B6%88%ED%95%98%EB%8A%94+%EC%A2%85%EB%9F%89%EC%A0%9C+%EC%84%9C%EB%B9%84%EC%8A%A4%EC%9D%B4%EB%A9%B0%2C+API+%ED%82%A4%EB%82%98+%EA%B3%84%EC%A0%95+%EC%97%86%EC%9D%B4+%EC%A6%89%EC%8B%9C+%EC%82%AC%EC%9A%A9%ED%95%A0+%EC%88%98+%EC%9E%88%EA%B3%A0+%EC%9E%90%EB%8F%99%ED%99%94+%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C%EC%99%80+%EA%B2%B0%EC%A0%9C+%EC%9D%BC%EC%B2%B4%ED%98%95+AI+%ED%86%B5%ED%95%A9+%EC%8B%9C%EB%82%98%EB%A6%AC%EC%98%A4%EC%97%90+%ED%8A%B9%ED%9E%88+%EC%A0%81%ED%95%A9%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=f10c407df10598d9a9a44a09\u0026amp;signature=870aefdab351f4406e855694fc1295d1cb9602f6ff965bdb9b9866fd7617ded0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dgridai/TU6mO6G1dAMh6LGG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DGrid AI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#65A30D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dgrid.ai/ko/x402/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/x402/overview.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.dgrid.ai/ko/x402/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.dgrid.ai/x402/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.dgrid.ai/zh-Hant/x402/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.dgrid.ai/fr/x402/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.dgrid.ai/es/x402/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.dgrid.ai/x402/overview\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dgrid.ai/#organization\",\"name\":\"DGrid AI Docs\",\"url\":\"https://docs.dgrid.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dgridai/eFrQx07adP_MQw0i/logo/dgrid-horizontal-black.png?fit=max\u0026auto=format\u0026n=eFrQx07adP_MQw0i\u0026q=85\u0026s=aa7da302786ec058e3c91526a127736d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dgrid.ai#website\",\"name\":\"DGrid AI Docs\",\"url\":\"https://docs.dgrid.ai\",\"publisher\":{\"@id\":\"https://docs.dgrid.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dgrid.ai/ko/x402/overview#webpage\",\"url\":\"https://docs.dgrid.ai/ko/x402/overview\",\"name\":\"x402 API\",\"description\":\"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.\",\"dateModified\":\"2026-07-02T09:33:56.819Z\",\"isPartOf\":{\"@id\":\"https://docs.dgrid.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dgrid.ai/ko/x402/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dgrid.ai/ko/x402/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"DGrid AI Docs\",\"item\":\"https://docs.dgrid.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"x402 API\",\"item\":\"https://docs.dgrid.ai/ko/x402/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.dgrid.ai/ko/x402/overview#article\",\"headline\":\"x402 API\",\"name\":\"x402 API\",\"description\":\"DGrid x402 API는 x402 마이크로결제 프로토콜을 활용해 추론 호출마다 비용을 지불하는 종량제 서비스이며, API 키나 계정 없이 즉시 사용할 수 있고 자동화 워크플로와 결제 일체형 AI 통합 시나리오에 특히 적합합니다.\",\"url\":\"https://docs.dgrid.ai/ko/x402/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dgrid.ai/ko/x402/overview#webpage\"},\"dateModified\":\"2026-07-02T09:33:56.819Z\",\"publisher\":{\"@id\":\"https://docs.dgrid.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dgrid.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DGrid AI Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DGrid AI Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/x402/overview"}]},{"language":"zh-Hant","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"部落格"},{"href":"https://telegram.me/dgrid_ai","label":"支援"}],"primary":{"type":"button","label":"儀表板","href":"https://dgrid.ai/overview"}},"pages":[{"title":"zh-Hant","href":"/zh-Hant/x402/overview"}]},{"language":"ko","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"블로그"},{"href":"https://telegram.me/dgrid_ai","label":"지원"}],"primary":{"type":"button","label":"대시보드","href":"https://dgrid.ai/overview"}},"tabs":[{"tab":"문서","icon":"book-open","pages":[{"title":"문서","href":"/ko"}]},{"tab":"API 참조","icon":"code","groups":[{"group":"시작하기","pages":[{"title":"소개","sidebarTitle":"소개","href":"/ko/api-reference/introduction"}]},{"group":"모델 API","pages":[{"group":"채팅","pages":[{"title":"채팅 완성 생성","sidebarTitle":"채팅 완성 생성","openapi":"api-reference/openapi.json POST /v1/chat/completions","href":"/ko/api-reference/chat/create-chat-completion"},{"title":"응답 생성","sidebarTitle":"응답 생성","openapi":"api-reference/openapi.json POST /v1/responses","href":"/ko/api-reference/chat/create-response"},{"title":"메시지 생성 (Claude)","sidebarTitle":"메시지 생성 (Claude)","openapi":"api-reference/openapi.json POST /v1/messages","href":"/ko/api-reference/chat/create-message"},{"title":"콘텐츠 생성 (Gemini)","sidebarTitle":"콘텐츠 생성 (Gemini)","openapi":"api-reference/openapi.json POST /v1/models/{model}:generateContent","href":"/ko/api-reference/chat/generate-content"},{"title":"Gemini 미디어 인식","sidebarTitle":"Gemini 미디어 인식","openapi":"api-reference/openapi.json POST /v1/models/{model}:generateContent","href":"/ko/api-reference/chat/gemini-media-recognition"}]},{"group":"컴플리션","pages":[{"title":"완성 생성","sidebarTitle":"완성 생성","openapi":"api-reference/openapi.json POST /v1/completions","href":"/ko/api-reference/completions/create-completion"}]},{"group":"임베딩","pages":[{"title":"임베딩 생성","sidebarTitle":"임베딩 생성","openapi":"api-reference/openapi.json POST /v1/embeddings","href":"/ko/api-reference/embeddings/create-embedding"},{"title":"임베딩 생성 (레거시 엔진)","sidebarTitle":"임베딩 생성 (레거시 엔진)","openapi":"api-reference/openapi.json POST /v1/engines/{engine}/embeddings","href":"/ko/api-reference/embeddings/create-engine-embedding"}]},{"group":"이미지","pages":[{"title":"네이티브 Gemini 형식","sidebarTitle":"네이티브 Gemini 형식","openapi":"api-reference/openapi.json POST /v1/models/{model}:generateContent","href":"/ko/api-reference/images/gemini-native-format"},{"title":"OpenAI 채팅 형식","sidebarTitle":"OpenAI 채팅 형식","openapi":"api-reference/openapi.json POST /v1/chat/completions","href":"/ko/api-reference/images/openai-chat-format"},{"title":"이미지 생성","sidebarTitle":"이미지 생성","openapi":"api-reference/openapi.json POST /v1/images/generations","href":"/ko/api-reference/images/create-image"},{"title":"Qwen 이미지 생성","sidebarTitle":"Qwen 이미지 생성","openapi":"api-reference/openapi.json POST /v1/images/generations","href":"/ko/api-reference/images/qwen-image-generations"},{"title":"이미지 편집","sidebarTitle":"이미지 편집","openapi":"api-reference/openapi.json POST /v1/images/edits","href":"/ko/api-reference/images/edit-image"},{"title":"Qwen 이미지 편집","sidebarTitle":"Qwen 이미지 편집","openapi":"api-reference/openapi.json POST /v1/images/edits","href":"/ko/api-reference/images/qwen-image-edits"}]},{"group":"오디오","pages":[{"title":"네이티브 Gemini 형식","sidebarTitle":"네이티브 Gemini 형식","openapi":"api-reference/openapi.json POST /v1/models/{model}:generateContent","href":"/ko/api-reference/audio/native-gemini-format"},{"title":"음성 생성","sidebarTitle":"음성 생성","openapi":"api-reference/openapi.json POST /v1/audio/speech","href":"/ko/api-reference/audio/create-speech"},{"title":"음성 인식 생성","sidebarTitle":"음성 인식 생성","openapi":"api-reference/openapi.json POST /v1/audio/transcriptions","href":"/ko/api-reference/audio/create-transcription"},{"title":"음성 번역 생성","sidebarTitle":"음성 번역 생성","openapi":"api-reference/openapi.json POST /v1/audio/translations","href":"/ko/api-reference/audio/create-translation"}]},{"group":"모더레이션","pages":[{"title":"모더레이션 생성","sidebarTitle":"모더레이션 생성","openapi":"api-reference/openapi.json POST /v1/moderations","href":"/ko/api-reference/moderations/create-moderation"}]},{"group":"모델","pages":[{"title":"모델 목록 조회","sidebarTitle":"모델 목록 조회","openapi":"api-reference/openapi.json GET /v1/models","href":"/ko/api-reference/models/list-models"}]},{"group":"사용량 및 결제","pages":[{"title":"요청 결제 세부 정보 조회","sidebarTitle":"요청 결제 세부 정보 조회","href":"/ko/api-reference/usage-and-billing/get-request-billing-details"}]},{"group":"실시간","pages":[{"title":"실시간","sidebarTitle":"실시간","href":"/ko/ai-gateway/model-api/realtime"}]}]},{"group":"관리 API","pages":[{"title":"관리 API 키","sidebarTitle":"관리 API 키","href":"/ko/management-api-keys"},{"title":"계정 잔액 조회","sidebarTitle":"계정 잔액 조회","href":"/ko/api-reference/management/get-account-balance"}]},{"group":"Webhook 통합","pages":[{"title":"Webhook 가이드","sidebarTitle":"Webhook 가이드","description":"HTTPS 수신 서버로 DGrid 이벤트를 받고 서명을 검증하며 테스트, 재시도, 중복 전달을 처리합니다.","href":"/ko/api-reference/webhooks/overview"}]},{"group":"X402 API","pages":[{"title":"x402 API","sidebarTitle":"개요","href":"/ko/x402/overview"},{"title":"API 참조","sidebarTitle":"API 참조","description":"요청 형식, 결제 헤더, 응답 코드, 오류 처리, 추론 종량 과금 세부 사항, 인증 흐름을 포함한 DGrid x402 API의 모든 엔드포인트 레퍼런스를 curl과 SDK 코드 예제, 응답 페이로드 샘플과 함께 한곳에 자세히 정리했습니다.","href":"/ko/x402/api-reference"}]}]}]},{"language":"fr","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"Blog"},{"href":"https://telegram.me/dgrid_ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://dgrid.ai/overview"}},"pages":[{"title":"fr","href":"/fr/x402/overview"}]},{"language":"es","navbar":{"links":[{"href":"https://blog.dgrid.ai/","label":"Blog"},{"href":"https://telegram.me/dgrid_ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://dgrid.ai/overview"}},"pages":[{"title":"es","href":"/es/x402/overview"}]}]},"title":"x402 API - DGrid AI Docs","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":[],"chunks":[]}
