मुख्य सामग्री पर जाएँ

डॉक्यूमेंटेशन

लर्निंग सेंटर

विस्तृत गाइड, ट्यूटोरियल और API डॉक्यूमेंटेशन के साथ कंटेंट मॉडरेशन में महारत हासिल करें

x402 के साथ प्रति अनुरोध भुगतान

आप बिना अकाउंट के Discuse API कॉल कर सकते हैं। हर अनुरोध का भुगतान उसे भेजते समय USDC में किया जाता है, x402 भुगतान प्रोटोकॉल के ज़रिए। इसमें कोई साइन-अप नहीं, कोई API key नहीं, कोई प्लान नहीं और कोई मासिक कोटा नहीं है।

AI एजेंटों और कभी-कभार कॉल करने वालों के लिए x402 का उपयोग करें। नियमित ट्रैफ़िक के लिए, किसी प्लान पर API key सस्ती पड़ती है और उसकी सीमाएँ भी अधिक होती हैं।

भुगतान वाला अनुरोध कैसे काम करता है?

  1. अनुरोध को X-API-Key हेडर के बिना भेजें।
  2. API 402 Payment Required के साथ जवाब देता है। payment-required response header और JSON body कीमत और स्वीकार किए जाने वाले भुगतान बताते हैं।
  3. आपका x402 क्लाइंट उस राशि के लिए USDC भुगतान पर साइन करता है।
  4. उसी अनुरोध को फिर से भेजें, इस बार साइन किए गए भुगतान को PAYMENT-SIGNATURE हेडर में रखकर।
  5. भुगतान सत्यापित और सेटल किया जाता है, और API सामान्य response लौटाता है।

कोई भी x402 version 2 क्लाइंट आपके लिए चरण 2 से 4 कर सकता है।

भुगतान चुनौती कैसी दिखती है?

{
  "x402Version": 2,
  "error": "PAYMENT-SIGNATURE header is required",
  "resource": {
    "url": "https://api.discuse.com/api/v2/scan",
    "description": "File virus scan"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x66Bd239CC81664622BD8d528aa8c14f9FE46e36c",
      "maxTimeoutSeconds": 60,
      "extra": { "assetTransferMethod": "permit2", "name": "USD Coin", "version": "2" }
    }
  ]
}

amount USDC की atomic units (6 दशमलव) में है, इसलिए 10000 का मतलब $0.01 है। accepts हर नेटवर्क के लिए एक entry सूचीबद्ध करता है।

कौन-से नेटवर्क और टोकन स्वीकार किए जाते हैं?

नेटवर्क Chain id टोकन
Base eip155:8453 USDC
Polygon eip155:137 USDC

हर अनुरोध की लागत कितनी है?

Endpoint प्रति अनुरोध कीमत
POST /api/v2/check $0.005
POST /api/v2/scan $0.01
POST /api/v2/ocr $0.02
POST /api/v2/summarize $0.03
POST /api/v2/demo/check $0.005

कीमत हर अनुरोध के लिए तय है। यह सामग्री के आकार पर निर्भर नहीं करती।

भुगतान वाले अनुरोधों पर कौन-सी सीमाएँ लागू होती हैं?

अगर भुगतान वाला अनुरोध सीमित न हो, तो वह अपनी कीमत से ज़्यादा काम करवा सकता है, इसलिए भुगतान वाले अनुरोधों की सीमाएँ API keys की तुलना में छोटी होती हैं:

Endpoint प्रति भुगतान अनुरोध सीमा
/api/v2/check टेक्स्ट, साथ में अधिकतम 2 images या GIFs, 1 document और 5 links। Videos उपलब्ध नहीं हैं।
/api/v2/scan 1 file, file_url के ज़रिए (50 MiB तक) या file_data के ज़रिए (10 MiB तक)
/api/v2/ocr 1 file
/api/v2/summarize टेक्स्ट, या 1 file

सीमा से ऊपर का अनुरोध 400 के साथ अस्वीकार कर दिया जाता है और संदेश x402 pay-per-request limit से शुरू होता है। हर भुगतान करने वाला wallet प्रति मिनट 60 अनुरोध तक भेज सकता है। इससे ऊपर जाने पर, API 429 लौटाता है।

भुगतान वाले अनुरोध default moderation settings का उपयोग करते हैं। custom thresholds जैसी Project settings के लिए API key चाहिए।

API key होने पर भुगतान से कैसे बचूँ?

X-API-Key हेडर भेजें। इस हेडर वाला अनुरोध कभी भुगतान के लिए नहीं पूछा जाता, और इसके बजाय उसे आपके प्लान में बिल किया जाता है। JSON body में दी गई key नहीं गिनी जाती: हेडर के बिना, अनुरोध को payment challenge मिलता है।

Discuse टीम द्वारा लिखा गया · अंतिम अपडेट June 2026