x402 AI جنریشن API: بغیر اکاؤنٹ کے فی کال ادائیگی

x402 ایک اوپن پیمنٹ پروٹوکول ہے جو طویل عرصے سے غیر مستعمل HTTP اسٹیٹس کوڈ 402 کو ایک فعال پے وال میں تبدیل کرتا ہے: سرور مشین ریڈ ایبل ادائیگی کی شرائط کے ساتھ 402 Payment Required کا جواب دیتا ہے، کلائنٹ اسٹیبل کوائن کی منتقلی کے اجازت نامے پر دستخط کرتا ہے، درخواست کو دہراتا ہے اور اپنا نتیجہ حاصل کرتا ہے۔ نہ کوئی اکاؤنٹ، نہ کوئی 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) کو سونپتا ہے، فائل بناتا ہے اور پھر آن چین تصفیہ (settlement) کی کارروائی مکمل کرتا ہے۔

دستخط بذاتِ خود فوری بلاک چین ٹرانزیکشن نہیں ہوتے۔ یہ ایک آف چین اجازت ہے جو نیٹ ورک پر جمع کرائے جانے کے بعد ہی حقیقی منتقلی بنتی ہے۔ یہی دو مرحلہ وار نظام کو ممکن بناتا ہے: پہلے تصدیق، پھر جنریشن، اور آخر میں تصفیہ۔

عملی تفصیل: 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 پر رینڈرنگ میں ایک سے دس منٹ لگتے ہیں، HTTP کنکشن اتنی دیر برقرار رکھنا ممکن نہیں، اور گوگل پر شروع شدہ عمل منسوخ نہیں ہو سکتا (ان کا طریقہ کار 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 فارمیٹ میں چین ID، وصولی کے پتے اور سہولت کار کے ساتھ درج کرتا ہے۔ مینی فیسٹ کا 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 کے ذریعے بنائی گئی ویڈیو کو بعد میں ایڈٹ کر سکتا ہوں؟

بتائی گئی قیمت کتنی دیر تک کارآمد رہتی ہے؟