x402 के साथ प्रति अनुरोध भुगतान
आप बिना अकाउंट के Discuse API कॉल कर सकते हैं। हर अनुरोध का भुगतान उसे भेजते समय USDC में किया जाता है, x402 भुगतान प्रोटोकॉल के ज़रिए। इसमें कोई साइन-अप नहीं, कोई API key नहीं, कोई प्लान नहीं और कोई मासिक कोटा नहीं है।
AI एजेंटों और कभी-कभार कॉल करने वालों के लिए x402 का उपयोग करें। नियमित ट्रैफ़िक के लिए, किसी प्लान पर API key सस्ती पड़ती है और उसकी सीमाएँ भी अधिक होती हैं।
भुगतान वाला अनुरोध कैसे काम करता है?
- अनुरोध को
X-API-Keyहेडर के बिना भेजें। - API
402 Payment Requiredके साथ जवाब देता है।payment-requiredresponse header और JSON body कीमत और स्वीकार किए जाने वाले भुगतान बताते हैं। - आपका x402 क्लाइंट उस राशि के लिए USDC भुगतान पर साइन करता है।
- उसी अनुरोध को फिर से भेजें, इस बार साइन किए गए भुगतान को
PAYMENT-SIGNATUREहेडर में रखकर। - भुगतान सत्यापित और सेटल किया जाता है, और 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 मिलता है।