يعمل AgentPay
امنح وكلاءك ميزانية، لا كومة من اشتراكات API.
يتيح AgentPay لوكلاء الذكاء الاصطناعي دفع ثمن واجهات API التي يستخدمونها، استدعاءً تلو الآخر، من رصيد واحد مسبق الدفع. لن تدفع أبدًا مقابل الاستدعاءات الفاشلة أو البطيئة أو المكررة. ولا يمكن أن يتجاوز الإنفاق الرصيد، ولا تُخزَّن مفاتيح API داخل وكيلك أبدًا.
| الاستدعاء | المبلغ المحتسب |
|---|---|
| GET weather/forecast 200 OK خلال 184 مللي ثانية، واتفاقية مستوى الخدمة 800 مللي ثانية |
0.03 دولار محتسب |
| POST search/query إعادة محاولة بمفتاح Idempotency-Key نفسه |
0.00 دولار أعيد إرساله |
| POST search/query 500 من واجهة API |
0.00 دولار حُرّر |
| GET maps/route لا إجابة خلال 800 مللي ثانية، فقُطع |
0.00 دولار 504، مجاني |
لماذا تستخدمه الفرق
لا خطط شهرية
ادفع مقابل كل استدعاء ناجح بدلًا من اشتراك لكل واجهة API يستخدمها وكيلك من حين لآخر.
لا فواتير مفاجئة
الاستدعاءات الفاشلة والمنتهية المهلة مجانية، وإعادة المحاولة لا تُحتسب مرتين أبدًا، ويتوقف الإنفاق عند نفاد الرصيد المسبق الدفع.
لا مفاتيح في وكيلك
تُخزَّن مفاتيح API مشفّرة لدينا وتُضاف إلى كل طلب. وحتى لو اختُرق وكيلك، تبقى تلك المفاتيح آمنة.
أمثلة من الواقع
اتصال شبكة غير مستقر
وكيل عالق في حلقة
انكشاف إعدادات وكيل
كم ستوفّر؟
أدخل أرقامك الخاصة. تُجرى الحسابات في متصفحك.
ما الذي يفعله
- يُحتسب عند النجاح فقط
- يُحجز السعر قبل الاستدعاء ولا يُحتسب إلا عندما تجيب واجهة API بحالة 2xx. والأخطاء وانتهاء المهلة وواجهات API التي يتعذر الوصول إليها لا تكلّف شيئًا.
- لا يُحتسب مرتين أبدًا
- يحمل كل استدعاء مفتاح
Idempotency-Key. وإعادة محاولة استدعاء مكتمل تعيد الاستجابة الأصلية دون احتساب ثانٍ، لمدة 24 ساعة. - مُهَل زمنية مُلزِمة
- لكل مسار مهلة استجابة (SLA). وإذا لم تُجب واجهة API في الوقت المحدد، يُقطع الاستدعاء ويُرد عليه بـ 504 ولا يُحتسب.
- تبقى مفاتيح API لدينا
- تُخزَّن مفاتيح واجهات API الوجهة مشفّرة وتُضاف إلى كل طلب عند خروجه. لا يحملها وكيلك أبدًا، ولا يُمرَّر مفتاحه الخاص أبدًا.
- أسعار يمكنك رؤيتها
- يعرض كل مسار سعره لكل استدعاء قبل استخدامه. نحن من يحدد الأسعار، لذا لا يمكن للعميل أبدًا تغيير المبلغ المحتسب عليه.
- كل استدعاء مسجّل
- يُسجَّل كل استدعاء مع حالته ورمز استجابة واجهة API والمدة التي استغرقها. ويظهر كل احتساب أيضًا في سجل المحفظة.
كيف يعمل
- اختر مسارًا. يعرض
GET /v1/routesواجهات API المتاحة مع سعرها ومهلتها. - استدعِ عبر AgentPay. أرسل الطلب إلى
agentpay.myuiaf.com/v1/proxy/<route>/<path>مع مفتاحك ومفتاحIdempotency-Key. - احصل على إجابة واجهة API. تعود الاستجابة دون تغيير، مع ترويسات توضح المبلغ المحتسب ورصيدك المتبقي.
جرّبه
# See the routes you can call and their prices
curl https://agentpay.myuiaf.com/v1/routes \
-H "X-Agent-API-Key: fv1.acme-bot.k1.xxxxx"
# Call one. Use a new Idempotency-Key for each new call.
curl -X POST https://agentpay.myuiaf.com/v1/proxy/rt_weather/forecast \
-H "X-Agent-API-Key: fv1.acme-bot.k1.xxxxx" \
-H "Idempotency-Key: 7f3c9a1e-forecast-honolulu" \
-H "content-type: application/json" \
-d '{"city":"Honolulu","days":3}'
HTTP/2 200
x-agentpay-call-id: 001762570000000-a1b2c3
x-agentpay-charged-usd: 0.03
x-agentpay-available-usd: 4.97
x-agentpay-ttfb-ms: 171
x-agentpay-total-ms: 184
{ ...the API's own response... }
أسماء المسارات أعلاه أمثلة. استدعِ GET /v1/routes لمعرفة المسارات المتاحة اليوم.
الأسعار
| نوع المسار | السعر لكل استدعاء ناجح | مثال |
|---|---|---|
| ثابت | $0.01 | أي استدعاء على المسار: 0.01 دولار |
| تمريري | سعر واجهة API نفسها + 5%، مقرّبًا للأعلى إلى أقرب سنت | استدعاء بسعر 2.00 دولار يكلّف 2.10 دولار؛ واستدعاء بسعر 0.09 دولار يكلّف 0.10 دولار |
تُدفع الاستدعاءات من الرصيد المسبق الدفع نفسه المستخدم في Freshness Validator. اشترِ باقة رصيد، أو دع وكيلك يشتري باقته بنفسه. الاستدعاءات الفاشلة والمنتهية المهلة والمُعادة مجانية.
حدود المعدّل
تُحتسب بشكل منفصل عن استدعاءات Freshness Validator، فلا تبطئ خدمة الأخرى أبدًا.
| المستوى | طلبات AgentPay في الدقيقة |
|---|---|
| Early Testing | 60 |
| Growing Product | 120 |
| Scale Revenue | 300 |
| Enterprise | 1,000 |
الأسئلة الشائعة
ما هو AgentPay؟
AgentPay بوابة للدفع لكل استدعاء. يستدعي وكيل الذكاء الاصطناعي واجهة API مدفوعة عبر agentpay.myuiaf.com بمفتاحه الخاص؛ فيضيف AgentPay مفتاح واجهة API عند الخروج، ويتحقق من المحفظة، ولا يحتسب إلا الاستدعاءات التي تنجح في الوقت المحدد.
متى يُحتسب عليّ؟
فقط عندما تجيب واجهة API الوجهة بحالة 2xx ضمن مهلة المسار. لا تُحتسب استجابات الخطأ وانتهاء المهلة وواجهات API التي يتعذر الوصول إليها وإعادة المحاولة بمفتاح Idempotency-Key نفسه.
كم يكلّف الاستدعاء؟
يعرض كل مسار سعره. تكلّف المسارات الثابتة 0.01 دولار لكل استدعاء ناجح. وتكلّف المسارات التمريرية سعر واجهة API نفسها مضافًا إليه 5%، مقرّبًا للأعلى إلى أقرب سنت.
هل يرى وكيلي مفتاح واجهة API في أي وقت؟
لا. تُخزَّن مفاتيح واجهات API الوجهة مشفّرة بمعيار AES-256-GCM وتُضاف إلى كل طلب من جهة الخادم. ولا يُمرَّر مفتاح الوكيل الخاص إلى واجهة API أبدًا.
هل يمكنني إعادة محاولة استدعاء بأمان؟
نعم. أرسل مفتاح Idempotency-Key نفسه: يعيد الاستدعاء المكتمل استجابته الأصلية دون احتساب ثانٍ، لمدة 24 ساعة.
هل يمكنني إدراج واجهة API الخاصة بي في AgentPay؟
نعم. تُضاف المسارات يدويًا. راسلنا على [email protected] أو استخدم نموذج التواصل مع تفاصيل واجهة API الخاصة بك.
لديك واجهة API ينبغي أن يدفع الوكلاء مقابلها؟
نضيف واجهات API إلى AgentPay واحدة تلو الأخرى. إذا كنت تدير واجهة API وتريد أن يدفع الوكلاء مقابلها لكل استدعاء، أو كنت بحاجة إلى واجهة API غير مدرجة بعد، أخبرنا عنها.
يعمل مع Freshness Validator
يعمل المفتاح نفسه والمحفظة نفسها على Freshness Validator، الذي ينبّه وكيلك عندما يتغير ما يعرفه في المصدر.