acedatacloud استدعاءات API، بينما يتولى acedatacloud-x402 إصدار ترويسة الطلب PAYMENT-SIGNATURE.
عناوين المصدر والحزم:
- مستودع SDK: https://github.com/AceDataCloud/SDK
- مستودع X402 Client: https://github.com/AceDataCloud/X402Client
- PyPI SDK: https://pypi.org/project/acedatacloud/
- PyPI X402 Client: https://pypi.org/project/acedatacloud-x402/
تثبيت التبعيات
upto، تحتاج أيضًا إلى استدعاء Permit2 approve CLI لمرة واحدة، ويعتمد هذا CLI على web3:
- يمكن تثبيت واستيراد كل من
acedatacloudوacedatacloud-x402من PyPI. - سيضيف
pip install 'acedatacloud-x402[cli]'واجهة CLI لـapprove-permit2، المستخدمة للتفويض المسبق لـupto.
مثال Base
لا يتطلب المثال التالي API Token. يُستخدم المفتاح الخاص للمحفظة للتوقيع محليًا فقط، ولن يُرسل إلى Ace Data Cloud.dict، لذلك يستخدم المثال res["choices"][0]["message"]["content"]۔ لا تفترض مباشرةً أنه يمتلك دائمًا الخاصية .choices.
مثال Solana
يستخدم Solana secret key مرمّزًا بـ base58: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:
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:
{"skipped": true}، ولن يرسل معاملة أخرى على السلسلة.
التوقيع منخفض المستوى
إذا لم تستخدم SDK، يمكنك أيضًا استدعاء دالة التوقيع منخفضة المستوى مباشرةً:create_x402_payment_handler في كود الأعمال العادي.
