x402 AI जनरेशन API: प्रति कॉल भुगतान, बिना किसी खाते के

x402 एक खुला भुगतान प्रोटोकॉल है जो लंबे समय से उपयोग में न आए HTTP स्टेटस कोड 402 को एक कार्यात्मक पेवॉल में बदल देता है: सर्वर मशीन-पठनीय भुगतान शर्तों के साथ 402 Payment Required का उत्तर देता है, क्लाइंट एक स्थिर कॉइन (stablecoin) ट्रांसफर ऑथराइजेशन पर हस्ताक्षर करता है, अनुरोध को दोहराता है और अपना परिणाम प्राप्त करता है। कोई खाता नहीं, कोई API की नहीं, और कोई मासिक शुल्क नहीं। Coinbase ने अप्रैल 2026 में इस प्रोटोकॉल को Linux Foundation को सौंप दिया, और जब x402 Foundation ने परिचालन शुरू किया, तब तक AWS, Google, Stripe, Visa और Mastercard सहित 40 सदस्य संगठन इसमें शामिल हो चुके थे। यह अब केवल एक छोटा प्रयोग नहीं रहा।

त्वरित उत्तर: BananaBanana का x402 एंडपॉइंट https://bananabanana.pro/api/x402 पर उपलब्ध है। { "tool": "...", "arguments": {...} } के साथ एक POST अनुरोध भेजें, उन पैरामीटर्स के लिए सटीक मूल्य के साथ 402 प्रतिक्रिया प्राप्त करें, Base पर USDC में भुगतान करें और अनुरोध दोहराएं। इमेज निर्माण $0.03 से, वीडियो $0.30 से, और स्पीच प्रति 200 अक्षरों के लिए $0.01 से शुरू होता है। इमेज और स्पीच के लिए शुल्क केवल तभी लिया जाता है जब फ़ाइल वास्तव में सफलतापूर्वक तैयार हो जाती है।

एक छोटा रोबोट एक वेंडिंग मशीन में सिक्का डाल रहा है जो एक छवि, फिल्म रील और स्पीकर प्रदान करती है, संपादकीय चित्रण

यह अंतिम वाक्य वह महत्वपूर्ण विवरण है जिसे x402 पर अधिकांश लेख छोड़ देते हैं, और हम इस पर विस्तार से चर्चा करेंगे। पैसे वसूलना आसान है; असफल कॉल्स के लिए शुल्क न लेना ही सॉफ्टवेयर आर्किटेक्चर को रोचक बनाता है।

भुगतान वास्तव में कैसे होता है

केवल चार चरण हैं, और आपका HTTP क्लाइंट इनमें से तीन को स्वचालित रूप से संभालता है:

आपका एजेंट बिना किसी भुगतान हेडर के एक सामान्य JSON POST अनुरोध भेजता है।
सर्वर एक accepts एरे के साथ 402 लौटाता है। भुगतान आवश्यकता में सबसे छोटी इकाई (atomic units) में राशि, प्राप्तकर्ता का पता, USDC अनुबंध, ब्लॉकचेन और समाप्ति समय शामिल होता है।
क्लाइंट उस सटीक राशि के लिए एक EIP-3009 ट्रांसफर ऑथराइजेशन पर हस्ताक्षर करता है और इसे X-PAYMENT हेडर में Base64 प्रारूप में रखता है।
वही अनुरोध इस हेडर के साथ दोबारा भेजा जाता है। सर्वर सत्यापन के लिए हस्ताक्षर को मध्यस्थ (facilitator) को सौंपता है, जनरेशन पूरा करता है, और फिर ऑन-चेन निपटान का अनुरोध करता है।

हस्ताक्षर तुरंत ब्लॉकचेन पर होने वाला लेन-देन नहीं है। यह एक ऑफ-चेन अनुमति है जो नेटवर्क पर जमा होने पर ही वास्तविक ट्रांसफर में बदलती है। यही दो-चरणीय व्यवस्था को संभव बनाता है: पहले जांचें, फिर तैयार करें, और अंत में निपटान करें।

व्यावहारिक विवरण: v2 विनिर्देश हेडर का नाम बदलकर PAYMENT-SIGNATURE और PAYMENT-RESPONSE करता है, लेकिन वर्तमान में अधिकांश क्लाइंट अभी भी X-PAYMENT भेजते हैं, जिसे हम पूरी तरह स्वीकार करते हैं। यदि आप आधिकारिक TypeScript SDK का उपयोग कर रहे हैं, तो यह प्रक्रिया आपके लिए पूरी तरह पारदर्शी है।

एक एजेंट और पेड API के बीच चार-चरणीय अनुरोध चक्र का आरेखीय चित्रण, संपादकीय शैली

एक कॉल की लागत कितनी है

कीमतों की गणना प्रति जनरेशन की जाती है और किसी भी हस्ताक्षर से पहले सूचित की जाती है। सटीक राशि पैरामीटर पर निर्भर करती है (4K इमेज का शुल्क 1K से भिन्न होता है), इसलिए 402 प्रतिक्रिया आपके विशिष्ट अनुरोध का मूल्यांकन करती है।

टूल	मॉडल	मूल्य
`generate_image`	Nano Banana 2 Lite	$0.03 (केवल 1K)
`generate_image`	Nano Banana 2	$0.03 – $0.13 (512 से 4K)
`generate_image`	Nano Banana Pro	$0.11 – $0.20 (1K से 4K)
`generate_video`	Gemini Omni Flash	$0.10 प्रति सेकंड, 3–10 सेकंड, ऑडियो शामिल
`generate_video`	Veo 3.1 परिवार	$0.10 – $4.40 प्रति क्लिप
`generate_speech`	Gemini Flash TTS	शुरू होने वाले प्रत्येक 200 अक्षरों पर $0.01

Omni पर ऑडियो सहित 3 सेकंड की क्लिप की लागत $0.30 है। यह सूची में सबसे किफायती वास्तविक वीडियो विकल्प है। Veo अधिक स्पष्टता प्रदान करता है, लेकिन 8 सेकंड के 1080p ऑडियो वीडियो के लिए शुरुआती ड्राफ्ट के लिहाज से लागत काफी बढ़ जाती है।

आप सीधे अद्यतन मूल्य सूची देख सकते हैं: GET https://bananabanana.pro/api/x402 बिना किसी भुगतान के पूरा कैटलॉग मुफ्त में लौटाता है।

विभिन्न आकारों के सिक्के छोटे फ़्रेमयुक्त चित्रों और फ़िल्म स्ट्रिप के आकारों के पास रखे हुए, संपादकीय चित्रण

शुरुआत से अंत तक दो अनुरोध

हस्ताक्षर चरण को छोड़कर (जिसे आपकी x402 क्लाइंट लाइब्रेरी संभालती है), curl का उपयोग करके पूरा चक्र इस प्रकार है:

# 1. कोटेशन का अनुरोध। कोई भुगतान हेडर नहीं: लागत विवरण प्राप्त करें।
curl -s -X POST https://bananabanana.pro/api/x402 \
  -H 'Content-Type: application/json' \
  -d '{"tool":"generate_image","arguments":{"prompt":"a paper boat on still water at dawn","model":"nano-banana-pro","resolution":"2048"}}'

{
  "x402Version": 1,
  "error": "Payment required: $0.11 for generate_image.",
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "110000",
    "resource": "https://bananabanana.pro/api/x402",
    "payTo": "0x7c0e9abd1c48380e27ab5bfced1be54f23ce773f",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "maxTimeoutSeconds": 300,
    "extra": { "name": "USD Coin", "version": "2" }
  }]
}

एक लाइन पर दो लिफाफे: पहला पैडलॉक के साथ वापस आता है, दूसरा सील के साथ खुले फ्रेम से गुजरता है

पैरामीटर्स पर हस्ताक्षर करें, हेडर के साथ दोबारा अनुरोध भेजें, और दूसरी प्रतिक्रिया तैयार फ़ाइल लौटाएगी:

{
  "paid_usd": 0.11,
  "result": {
    "status": "completed",
    "images": [{ "url": "https://bananabanana.pro/api/files/..." }]
  }
}

x402 सर्वर बनाने वाले डेवलपर्स के लिए दो मुख्य तकनीकी बिंदु: maxAmountRequired को सबसे छोटी इकाई में लिखा जाता है। USDC में 6 दशमलव स्थान होते हैं, इसलिए $0.11 का मान 110000 हो जाता है। इसके अलावा, extra.name का मान USDC अनुबंध के name() फ़ंक्शन के सटीक परिणाम से मेल खाना चाहिए (Base mainnet पर यह USD Coin है, जबकि Base Sepolia पर USDC), क्योंकि इसका उपयोग EIP-712 domain separator की गणना में होता है। यदि यह मेल नहीं खाता है, तो हस्ताक्षर सत्यापन बिना किसी स्पष्ट त्रुटि संदेश के विफल हो जाएगा।

वीडियो का अलग तंत्र: अग्रिम भुगतान और विफलता पर रिफंड टोकन

इमेज और स्पीच जनरेशन एक ही HTTP अनुरोध के भीतर पूरा हो जाता है (सत्यापन → जनरेशन → निपटान)। भुगतान केवल तभी काटा जाता है जब फ़ाइल सफलतापूर्वक तैयार हो जाती है। यदि सामग्री सुरक्षा फ़िल्टर द्वारा अस्वीकृत होती है या समय समाप्त हो जाता है, तो हस्ताक्षर ब्लॉकचेन पर नहीं भेजा जाता और आपका कोई खर्च नहीं होता।

वीडियो का तरीका अलग है: Veo या Omni पर रेंडरिंग में 1 से 10 मिनट लगते हैं, HTTP कनेक्शन को इतनी देर खुला रखना संभव नहीं है, और Google की ओर से शुरू की गई प्रक्रिया को रद्द नहीं किया जा सकता (उनकी interactions.cancel विधि 501 UNIMPLEMENTED लौटाती है)। इसलिए, वीडियो का भुगतान पहले ही निपटाया जाता है, एक job_id प्राप्त होता है, और परिणाम की जांच एक मुफ्त एंडपॉइंट के जरिए की जाती है।

यदि भुगतान किया गया वीडियो सुरक्षा समीक्षा द्वारा अस्वीकार कर दिया जाए तो क्या होगा?

आपको पूरी राशि का एक रिफंड टोकन (refund token, प्रारूप bb_rf_…) मिलता है जो 90 दिनों के लिए वैध होता है। इसे आप refund_token पैरामीटर के साथ किसी भी बाद के अनुरोध में उपयोग कर सकते हैं। यदि $1.30 का वीडियो फ़िल्टर में फंस जाता है, तो आपकी अगली कॉल पर $1.30 की छूट मिलेगी। यदि नया कार्य टोकन मूल्य से कम है, तो शेष राशि एक नए टोकन के रूप में वापस कर दी जाती है।

यह USDC में ऑन-चेन रिफंड नहीं है, और हम इसे स्पष्ट रूप से बताते हैं। हमारा सर्वर कोई प्राइवेट की नहीं रखता और बाहर धनराशि ट्रांसफर नहीं कर सकता, केवल आने वाले भुगतान को स्वीकार या अस्वीकार कर सकता है। x402 सेवा की सुरक्षा के लिए सर्वर पर प्राइवेट की न होना एक मजबूत सुरक्षा उपाय है।

यह वीडियो x402 एंडपॉइंट के माध्यम से $0.30 में तैयार किया गया था: Gemini Omni Flash मॉडल, 3 सेकंड की अवधि, कांच के टैंक में पानी में फैलती स्याही का निरंतर शॉट, कोमल साइड लाइटिंग और कम आवृत्ति की परिवेशीय ध्वनि। ऑडियो सीधे मॉडल द्वारा तैयार किया गया है।

एजेंट एंडपॉइंट को स्वचालित रूप से कैसे खोजता है

यदि एजेंट पहले से ही URL जानता है, तो उसे खोजने की आवश्यकता नहीं है। अन्य एजेंटों के लिए सेवा /.well-known/x402 (और /.well-known/x402.json) पर एक मैनिफ़ेस्ट प्रकाशित करती है।

मैनिफ़ेस्ट प्रत्येक टूल को भुगतान आवश्यकताओं, CAIP-2 मानक नेटवर्क पहचानकर्ता, भुगतान पते और मध्यस्थ के साथ एक संसाधन के रूप में सूचीबद्ध करता है। मैनिफ़ेस्ट का accepts ब्लॉक टूल की अधिकतम सीमा के बजाय उसका न्यूनतम मूल्य बताता है, जिससे एजेंट द्वारा गलती से अधिक भुगतान करने की संभावना नहीं रहती।

एजेंट डायरेक्टरी खाली POST अनुरोध भेजकर एंडपॉइंट की जांच करती हैं। हमारा सर्वर टूल उपयोग के निर्देशों के साथ 402 उत्तर देता है।

एक इंडेक्स कार्ड कैबिनेट जिसका एक दराज खुला हुआ है और उससे चमकता हुआ एंडपॉइंट लेबल दिखाई दे रहा है, संपादकीय चित्रण

x402 चुनें या पारंपरिक खाता?

एक ही कमरे के दो दरवाजे: एक सिक्के वाले यांत्रिक हाथ द्वारा खोला गया और दूसरा चाबियों वाले हाथ द्वारा

दोनों रास्ते समान AI मॉडल से जुड़ते हैं। अपने एजेंट की वास्तुकला के अनुसार चयन करें।

सुविधा	x402	खाता प्रणाली (MCP या वेब)
सेटअप	फंडेड वॉलेट	ईमेल पंजीकरण, फिर API की या OAuth
प्रति कॉल	हस्ताक्षर, तत्काल भुगतान	प्रीपेड बैलेंस से कटौती
जमा बोनस	लागू नहीं	$50+ पर 5%, $100+ पर 10%, प्रोमो कोड पर +10%
जनरेशन इतिहास	सुरक्षित नहीं रहता	पूरा इतिहास और दोबारा उपयोग योग्य job ID
वीडियो संपादन	उपलब्ध नहीं	`edit_video`, संवाद आधारित सुधार
उपयुक्तता	कभी-कभार कॉल, पूर्णतः स्वायत्त एजेंट	निरंतर कार्य, लागत नियंत्रण, पुनरावृत्तियां

टॉप-अप बोनस एक महत्वपूर्ण लाभ है: प्रोमो कोड के साथ $100 जमा करने पर $120 का बैलेंस मिलता है (17% प्रभावी छूट), जो x402 में खाता न होने के कारण उपलब्ध नहीं है। दूसरी ओर, वॉलेट वाले स्वायत्त एजेंट को ईमेल की आवश्यकता नहीं होती और वह एकल अनुरोध में जनरेशन शुरू कर सकता है।

यदि आप खाता प्रणाली पसंद करते हैं, तो हमारा MCP सर्वर Claude Code, Cursor और VS Code का समर्थन करता है, और वेब जनरेटर सीधे ब्राउज़र में उपलब्ध है।

x402 AI जनरेशन API: प्रति कॉल भुगतान, बिना किसी खाते के

भुगतान वास्तव में कैसे होता है

एक कॉल की लागत कितनी है

शुरुआत से अंत तक दो अनुरोध

वीडियो का अलग तंत्र: अग्रिम भुगतान और विफलता पर रिफंड टोकन

एजेंट एंडपॉइंट को स्वचालित रूप से कैसे खोजता है

x402 चुनें या पारंपरिक खाता?

अक्सर पूछे जाने वाले प्रश्न

क्या भुगतान करने के लिए मुझे Coinbase खाते की आवश्यकता है?

यदि मेरा जनरेशन सामग्री फ़िल्टर द्वारा रोक दिया जाए तो क्या होगा?

कौन से नेटवर्क और टोकन समर्थित हैं?

क्या मैं x402 के जरिए बनाए गए वीडियो को संपादित कर सकता हूँ?

कोट की गई कीमत कितने समय तक मान्य है?