الدفع لكل طلب باستخدام x402
يمكنك استدعاء Discuse API دون حساب. يُدفَع ثمن كل طلب بعملة USDC لحظة إرساله، باستخدام بروتوكول الدفع x402. لا يوجد تسجيل، ولا مفتاح API، ولا خطة، ولا حصة شهرية.
استخدم 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 |
كم تبلغ تكلفة كل طلب؟
| نقطة النهاية | السعر لكل طلب |
|---|---|
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:
| نقطة النهاية | الحد لكل طلب مدفوع |
|---|---|
/api/v2/check |
نص، إضافةً إلى صورتين أو ملفي GIF كحد أقصى، ومستند واحد و5 روابط. الفيديوهات غير متاحة. |
/api/v2/scan |
ملف واحد، عبر file_url (حتى 50 MiB) أو file_data (حتى 10 MiB) |
/api/v2/ocr |
ملف واحد |
/api/v2/summarize |
نص، أو ملف واحد |
يُرفَض أي طلب يتجاوز الحد بالحالة 400 مع رسالة تبدأ بـ x402 pay-per-request limit. يمكن لكل محفظة دافعة إرسال ما يصل إلى 60 طلبًا في الدقيقة. وفوق ذلك، ترد API بالحالة 429.
تستخدم الطلبات المدفوعة إعدادات الإشراف الافتراضية. أما إعدادات المشروع، مثل العتبات المخصصة، فتحتاج إلى مفتاح API.
كيف أتجنب الدفع عندما يكون لدي مفتاح API؟
أرسل ترويسة X-API-Key. لن يُطلب الدفع أبدًا من أي طلب يحتوي على هذه الترويسة، بل يُحتسب بدلًا من ذلك ضمن خطتك. أما المفتاح الموجود في جسم JSON فلا يُعتد به: من دون الترويسة، يتلقى الطلب تحدي الدفع.