الانتقال إلى المحتوى الرئيسي
Python SDK مناسب لخدمات الواجهة الخلفية، ومهام البيانات، ووكيل الأتمتة، ونصوص المعالجة الدفعية. يتولى acedatacloud استدعاءات API، بينما يتولى acedatacloud-x402 إصدار ترويسة الطلب PAYMENT-SIGNATURE. عناوين المصدر والحزم:

تثبيت التبعيات

إذا كنت تريد استخدام upto، تحتاج أيضًا إلى استدعاء Permit2 approve CLI لمرة واحدة، ويعتمد هذا CLI على web3:
مخرجات فحص التثبيت والاستيراد في Python venv نظيف:
توضيح النتائج:
  • يمكن تثبيت واستيراد كل من acedatacloud وacedatacloud-x402 من PyPI.
  • سيضيف pip install 'acedatacloud-x402[cli]' واجهة CLI لـ approve-permit2، المستخدمة للتفويض المسبق لـ upto.

مثال Base

لا يتطلب المثال التالي API Token. يُستخدم المفتاح الخاص للمحفظة للتوقيع محليًا فقط، ولن يُرسل إلى Ace Data Cloud.
يُرجع Python SDK حاليًا dict، لذلك يستخدم المثال res["choices"][0]["message"]["content"]۔ لا تفترض مباشرةً أنه يمتلك دائمًا الخاصية .choices.

مثال Solana

يستخدم Solana secret key مرمّزًا بـ base58:
يقوم مسار Solana ببناء وإرسال معاملة SPL USDC TransferChecked، ثم يضع توقيع المعاملة داخل envelope لـ PAYMENT-SIGNATURE. أعاد Solana paid retry على Production API بالفعل HTTP 200 وADC_SOLANA_E2E_OK. واجه استعلام RPC العام هذه المرة تحديدًا للمعدل، ولم يتم تأكيد signature على السلسلة بشكل مستقر؛ عند الحاجة إلى المطابقة، يُرجى استخدام Solana RPC الخاص بك للاستعلام عن هذه المعاملة.

عميل Async

يمكن استخدام payment handler نفسه مع AsyncAceDataCloud:

استخدام القياس اللاحق upto

قد لا تُعرف التكلفة الفعلية لواجهات API مثل إكمالات الدردشة واستدعاءات النماذج إلا بعد انتهاء الاستجابة. في هذه الحالة، قد تُرجع API كلاً من exact وupto. إذا كنت تريد إعطاء الأولوية لاستخدام upto:
نتيجة تشغيل برنامج Base upto:
تأكيد على السلسلة:
توضيح النتائج:
  • يشير content ADC_BASE_UPTO_OK إلى أن الطلب دخل بالفعل إلى Model API.
  • يشير settled value 3 atomic USDC إلى أن upto يُسوّى وفقًا للاستخدام الفعلي، بدلًا من خصم الحد الكامل.
  • يمكن فتح settlement tx في BaseScan، واحفظ tx hash وpayer وcompletion id وملخص الطلب عند المطابقة.
يستخدم upto تفويض Permit2 لحد أعلى، ولا يمكن أن يتجاوز مبلغ التسوية الفعلي هذا الحد. قبل الاستخدام الأول، يلزم إجراء approve(Permit2, amount) واحد لـ USDC على السلسلة المستهدفة. طريقة CLI:
طريقة برمجية:
هذا الـ helper متكرر بأمان. إذا كان allowance كافيًا بالفعل، فسيُرجع {"skipped": true}، ولن يرسل معاملة أخرى على السلسلة.

التوقيع منخفض المستوى

إذا لم تستخدم SDK، يمكنك أيضًا استدعاء دالة التوقيع منخفضة المستوى مباشرةً:
الدالة منخفضة المستوى مناسبة للاختبارات، وطبقات الوكيل، وتكامل البوابات، أو SDK غير الرسمية. أعطِ الأولوية لاستخدام create_x402_payment_handler في كود الأعمال العادي.