x402 API لنماذج الذكاء الاصطناعي: ادفع لكل طلب بـ USDC
تقبل RunAPI مدفوعات x402 على نقاط النهاية المسعّرة لكل استدعاء. يرسل الوكيل طلبًا عاديًا، فيتلقى عرض سعر 402، ويوقّعه بمحفظته، ثم يحصل على النتيجة. لا حساب، ولا مفتاح API، ولا رصيد مدفوع مسبقًا.
curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \ -H 'Content-Type: application/json' \ --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>- 155 موارد قابلة للدفع عبر x402
- Base شبكة التسوية
- USDC أصل الدفع
- 0 مفاتيح API مطلوبة
أربع خطوات من الطلب إلى النتيجة
-
أرسل الطلب دون مفتاح
أرسل بطريقة POST نص JSON نفسه الذي كنت سترسله مع مفتاح API، لكن دون ترويسة Authorization.
-
اقرأ عرض السعر 402
تردّ RunAPI بالرمز 402 مع ترويسة PAYMENT-REQUIRED تحدد المبلغ الدقيق والأصل والشبكة والمستلم. يبقى عرض السعر صالحًا لمدة 300 ثانية.
-
وقّع وأعد المحاولة
يوقّع عميل x402 v2 تفويض EIP-3009 بمحفظة الوكيل، ثم يعيد إرسال الطلب مع ترويسة PAYMENT-SIGNATURE.
-
استعلم عن المهمة
تسوّي RunAPI الدفعة وتبدأ المهمة، ثم تُرجع 200 مع إيصال PAYMENT-RESPONSE وحقل poll_url لجلب النتيجة.
ما يجب معرفته قبل الدفع
بدون تسجيل وبدون مفتاح API
المحفظة الدافعة هي الهوية الوحيدة. لا حاجة لإنشاء حساب أو تخزين مفتاح أو شحن رصيد.
مدفوعات USDC بدون رسوم غاز
يوقّع الدافع تفويض EIP-3009 ويرسل وسيط Coinbase CDP التحويل، لذا تحتاج المحفظة إلى USDC فقط دون ETH.
الحصول على النتيجة
تكتمل معظم مهام الوسائط بشكل غير متزامن. تتضمن الاستجابة 200 حقل poll_url يحمل رمز وصول للقراءة فقط. يفتح الرمز تلك المهمة وحدها دون غيرها، ويبقى صالحًا لمدة 30 يومًا بعد انتهاء المهمة.
إذا فشلت المهمة
لا يتضمن x402 آلية استرداد مدمجة. عندما تنتهي مهمة مدفوعة بحالة فشل، تسجّل RunAPI التزامًا باسترداد كامل المبلغ الذي تلقته، ثم يعيده أحد المشغّلين إلى المحفظة الدافعة بتحويل USDC منفصل؛ الاسترداد ليس تلقائيًا.
نقاط النهاية المؤهلة
يعمل x402 على نقاط نهاية REST ذات السعر الثابت لكل استدعاء. أما النماذج التي تُحتسب بالرموز أو الثواني أو الأحرف، ومنها نقاط نهاية LLM، فلا تزال تتطلب مفتاح API ورصيدًا. ولا يقبل خادم MCP مدفوعات x402.
مفاتيح API لا تزال تعمل
x402 طريقة دفع إضافية. تستمر الطلبات التي ترسل مفتاح API صالحًا في استخدام رصيد الحساب تمامًا كما كانت، ويحصل الطلب ذو المفتاح غير الصالح على 401 بدلًا من عرض سعر.
شكل التبادل
مرّر الاستجابة إلى أي عميل x402 v2 متصل بمحفظة الوكيل، وسيتولى العميل التوقيع وإعادة المحاولة:
request = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status # => 200response.headers["PAYMENT-RESPONSE"] # settlement receiptresponse.json["poll_url"] # read-only task result URLأمثلة على الأسعار
أدنى سعر لكل استدعاء لعدد من النماذج التي تقبل x402 اليوم. تأتي الأسعار من الكتالوج المباشر، ويذكر كل عرض سعر 402 المبلغ الدقيق لذلك الطلب.
| النموذج | نقطة النهاية | السعر لكل استدعاء |
|---|---|---|
| Z Image Text to image z-image | POST /api/v1/z_image/text_to_image | $0.01 |
| Flux Text to image flux-2-klein | POST /api/v1/flux/text_to_image | $0.03 |
| Suno Stitch audio suno-v4 | POST /api/v1/suno/stitch_audio | $0.01 |
| Suno Stitch audio suno-v4.5 | POST /api/v1/suno/stitch_audio | $0.01 |
| Recraft Upscale image recraft-crisp-upscale | POST /api/v1/recraft/upscale_image | $0.01 |
| Recraft Remove background recraft-remove-background | POST /api/v1/recraft/remove_background | $0.01 |
تفاصيل الدفع
تتبع RunAPI مخطط exact في x402 v2 ولا تقبل إلا القيم أدناه. يُرفض أي شيء آخر قبل أن تطلب RunAPI من الوسيط تسوية الدفعة.
| الشبكة | Base mainnet (eip155:8453) |
|---|---|
| الأصل | USDC، العقد 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913، بـ 6 منازل عشرية |
| الوسيط | Coinbase CDP |
| التفويض | EIP-3009، لذا يحتاج الدافع إلى USDC دون ETH لرسوم الغاز |
| الحد | حتى 10 USDC لكل طلب، وتنتهي صلاحية عروض الأسعار بعد 300 ثانية |
الأسئلة الشائعة حول x402
ما هو x402؟
x402 بروتوكول دفع مفتوح مبني على رمز الحالة HTTP 402 Payment Required. يردّ الخادم بالرمز 402 مع متطلبات الدفع، فيدفع العميل بتفويض موقَّع بعملة مستقرة، ثم يُعاد إرسال الطلب. تتولى x402 Foundation صيانة البروتوكول.
هل أحتاج إلى حساب RunAPI للدفع عبر x402؟
لا. المحفظة التي تدفع هي الهوية. لا تنشئ RunAPI ملف محفظة داخليًا إلا بعد أول تسوية ناجحة، ولا تطلب أبدًا بريدًا إلكترونيًا أو مفتاح API.
ما دور وسيط x402؟
يتحقق الوسيط من الدفعة الموقَّعة ويرسل تحويل USDC على Base. تستخدم RunAPI وسيط Coinbase CDP، فلا يحتاج الدافع إلى دفع رسوم الغاز.
كم تكلفة الطلب؟
لكل نقطة نهاية سعر ثابت لكل استدعاء. يعرض عرض السعر 402 مبلغ USDC الدقيق قبل التوقيع، ويسرد كتالوج النماذج الأسعار الحالية.
هل يمكن للوكلاء اكتشاف RunAPI عبر x402 Bazaar؟
يتضمن كل عرض سعر 402 إعلان اكتشاف لـ Bazaar يحتوي على مخطط المدخلات ومثال، فتستطيع عملاء x402 والأدلة إدراج نقطة النهاية.
ماذا يحدث إذا دفعت وفشل الطلب قبل بدء المهمة؟
يُرفض الطلب الذي يفشل في التحقق قبل تسوية الدفعة، فلا يُخصم أي مبلغ. وبعد تسوية الدفعة، تحصل المهمة التي تفشل لاحقًا على التزام باسترداد كامل.
صفحات ذات صلة
دع وكيلك يدفع ثمن استدعاءات API بنفسه
تصفّح النماذج، واختر نقطة نهاية مسعّرة لكل استدعاء، وأرسل طلبك الأول دون مفتاح.