پرش به محتوای اصلی

مستندات

مرکز آموزش

مدیریت محتوا را با راهنماهای جامع، آموزش‌ها و مستندات API به‌خوبی یاد بگیرید

پرداخت به‌ازای هر درخواست با x402

می‌توانید Discuse API را بدون حساب کاربری فراخوانی کنید. هزینه هر درخواست در همان لحظه‌ای که آن را ارسال می‌کنید، با پروتکل پرداخت x402 و به USDC پرداخت می‌شود. نه ثبت‌نامی در کار است، نه API key، نه پلن و نه سهمیه ماهانه.

از x402 برای عامل‌های AI و فراخوانی‌های گهگاهی استفاده کنید. برای ترافیک پایدار، یک کلید API روی یک پلن ارزان‌تر است و محدودیت‌های بالاتری دارد.

یک درخواست پولی چطور کار می‌کند؟

  1. درخواست را بدون هدر X-API-Key ارسال کنید.
  2. API با 402 Payment Required پاسخ می‌دهد. هدر پاسخ payment-required و بدنه JSON قیمت و پرداخت‌های پذیرفته‌شده را توضیح می‌دهند.
  3. کلاینت x402 شما یک پرداخت USDC به همان مبلغ امضا می‌کند.
  4. همان درخواست را دوباره با پرداخت امضاشده در هدر PAYMENT-SIGNATURE ارسال کنید.
  5. پرداخت بررسی و تسویه می‌شود و 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 به حساب نمی‌آید: بدون این هدر، درخواست چالش پرداخت را دریافت می‌کند.

نوشته تیم Discuse · آخرین به‌روزرسانی June 2026