پرداخت بهازای هر درخواست با x402
میتوانید Discuse API را بدون حساب کاربری فراخوانی کنید. هزینه هر درخواست در همان لحظهای که آن را ارسال میکنید، با پروتکل پرداخت x402 و به USDC پرداخت میشود. نه ثبتنامی در کار است، نه API key، نه پلن و نه سهمیه ماهانه.
از x402 برای عاملهای AI و فراخوانیهای گهگاهی استفاده کنید. برای ترافیک پایدار، یک کلید API روی یک پلن ارزانتر است و محدودیتهای بالاتری دارد.
یک درخواست پولی چطور کار میکند؟
- درخواست را بدون هدر
X-API-Keyارسال کنید. - API با
402 Payment Requiredپاسخ میدهد. هدر پاسخpayment-requiredو بدنه JSON قیمت و پرداختهای پذیرفتهشده را توضیح میدهند. - کلاینت x402 شما یک پرداخت USDC به همان مبلغ امضا میکند.
- همان درخواست را دوباره با پرداخت امضاشده در هدر
PAYMENT-SIGNATUREارسال کنید. - پرداخت بررسی و تسویه میشود و API پاسخ عادی را برمیگرداند.
هر کلاینت x402 نسخه 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 است (6 رقم اعشار)، بنابراین 10000 برابر با $0.01 است. accepts برای هر شبکه یک ورودی فهرست میکند.
کدام شبکهها و توکنها پذیرفته میشوند؟
| شبکه | شناسه زنجیره | توکن |
|---|---|---|
| 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 key دارند:
| Endpoint | محدودیت هر درخواست پولی |
|---|---|
/api/v2/check |
متن، بهعلاوه حداکثر 2 تصویر یا GIF، 1 سند و 5 لینک. ویدئوها در دسترس نیستند. |
/api/v2/scan |
1 فایل، با file_url (تا 50 MiB) یا file_data (تا 10 MiB) |
/api/v2/ocr |
1 فایل |
/api/v2/summarize |
متن، یا 1 فایل |
درخواستی که از محدودیت بالاتر باشد با 400 رد میشود و پیامی دریافت میکند که با x402 pay-per-request limit شروع میشود. هر کیف پول پرداختکننده میتواند حداکثر 60 درخواست در دقیقه ارسال کند. بالاتر از این مقدار، API با 429 پاسخ میدهد.
درخواستهای پولی از تنظیمات پیشفرض مدیریت محتوا استفاده میکنند. تنظیمات پروژه، مانند آستانههای سفارشی، به API key نیاز دارند.
وقتی API key دارم چطور از پرداخت جلوگیری کنم؟
هدر X-API-Key را ارسال کنید. از درخواستی که این هدر را داشته باشد هرگز پرداخت خواسته نمیشود و در عوض هزینه آن به پلن شما منظور میشود. کلید داخل بدنه JSON به حساب نمیآید: بدون این هدر، درخواست چالش پرداخت را دریافت میکند.