Home → Documentation → Billing & Credits

Billing & Credits

تعرّف على كيفية عمل نظام الرصيد في LLM Resayil، وطريقة احتساب استهلاك الرموز، وكيفية إدارة رصيد حسابك وتكاليفك.

كيف يعمل نظام الرصيد

يعتمد LLM Resayil على نظام فوترة قائم على الرصيد. تُخصم الأرصدة تلقائياً من حسابك بناءً على عدد الرموز المستهلكة في كل طلب API. هذا النموذج يعني أنك لا تدفع إلا مقابل ما تستخدمه فعلاً.

ما هي الأرصدة؟

الأرصدة هي وحدة الحساب الأساسية. عند إرسال طلب API، يُطبَّق معامل ضرب على مجموع الرموز (رموز المدخلات + رموز المخرجات) لتحديد عدد الأرصدة المخصومة.

الرصيد الابتدائي

لا تحصل الحسابات الجديدة على أي رصيد تلقائي عند التسجيل. تشتري رصيدك مسبقاً حسب حاجتك، بلا اشتراك إلزامي، والرصيد المشترى لا تنتهي صلاحيته أبداً. لكل نموذج معدّل واحد منشور، ونماذجنا الأسرع تكلفك جزءاً يسيراً من تكلفة النماذج المتقدمة.

صلاحية الرصيد: كل رصيد تشتريه يبقى في حسابك إلى أجل غير مسمى ولا تنتهي صلاحيته أبداً — لا يوجد رصيد مجاني ولا مهلة 30 يوماً. استهلكه بالسرعة التي تناسبك.

صيغة احتساب الرصيد

يُحسب الرصيد المخصوم لكل طلب بضرب مجموع الرموز في معامل النموذج المستخدم. يختلف هذا المعامل بين النماذج المحلية والنماذج السحابية.

معادلة الاحتساب
credits_deducted = ( prompt_tokens + completion_tokens ) × credit_multiplier ÷ 1000

تُحتسب رموز المدخلات والمخرجات معاً، ثم تُضرب في معامل النموذج وتُقسم على 1000 — أي أن المعامل هو عدد الرصيد لكل 1000 رمز. تُقرَّب النتيجة للأعلى.

معاملات النماذج حسب الفئة

تتراوح قيمة المعامل بحسب فئة النموذج — النماذج القياسية أو النماذج المتقدمة:

النماذج القياسية
نوع النموذج المعامل الاستخدام الأمثل
خفيف — صغير وسريع 0.5× التصنيف، الملخصات القصيرة
قياسي — متوازن 1.0× الدردشة العامة، الكتابة، البرمجة
متوسط — كبير الحجم 1.5× الاستدلال المعقد، المحتوى الطويل
النماذج المتقدمة
نوع النموذج المعامل الاستخدام الأمثل
متقدم — متوسط 2.0× – 2.5× مهام تتطلب دقةً عالية
متقدم — كبير 3.0× – 3.5× أصعب المهام، الاستدلال المتعدد

مثال على الاحتساب

لنفترض أنك أرسلت طلباً يحتوي على 100 رمز مدخل واستجاب النموذج بـ 200 رمز، باستخدام نموذج محلي بمعامل 1.0:

example
prompt_tokens:      100
completion_tokens:  200
total_tokens:       300
credit_multiplier:  1.0  (standard model)
credits_deducted:   300 × 1.0 = 300 credits

-- Premium model example (multiplier 2.5×) --
credits_deducted:   300 × 2.5 = 750 credits

يمكنك مراجعة لوحة التحكم للاطلاع على معامل كل نموذج بشكل محدد.

استهلاك الرموز

يعدّ فهم طريقة احتساب الرموز أمراً ضرورياً لإدارة التكاليف. تُحتسب نوعان من الرموز في كل طلب: رموز المدخلات (الطلب) ورموز المخرجات (الاستجابة).

رموز المدخلات (Prompt Tokens)

هي الرموز الموجودة في رسالة طلبك، بما يشمل أي موجّهات نظام، وسجل المحادثة، واستفسار المستخدم. كلما طالت المحادثة وزاد السياق، ارتفع عدد رموز المدخلات وزادت التكلفة.

رموز المخرجات (Completion Tokens)

هي الرموز التي يولّدها النموذج في استجابته. تُحدّد معلمة max_tokens في طلبك الحد الأقصى لعدد رموز المخرجات الممكن توليدها.

معلومات الاستخدام في الاستجابة

تتضمن كل استجابة API معلومات تفصيلية عن الرموز المستهلكة:

json
"usage": {
  "prompt_tokens": 45,
  "completion_tokens": 128,
  "total_tokens": 173
}

نقاط نهاية API للفوترة

يوفّر LLM Resayil نقاط نهاية API للاطلاع على بيانات الاشتراك والرصيد وسجل عمليات الشراء. تتطلب جميع هذه النقاط مصادقة عبر مفتاح API.

يُعيد معلومات اشتراكك الحالي، بما يشمل مستوى الخطة، والحالة، وتاريخ الانتهاء، ورصيد الأرصدة.
Request
GET https://llmapi.resayil.io/api/billing/subscription
Authorization: Bearer YOUR_API_KEY
Response
{
  "tier": "pro",
  "status": "active",
  "expires_at": "2025-06-01T00:00:00Z",
  "credits": {
    "balance": 4250,
    "currency": "credits"
  }
}
يُعيد قائمة بحزم الرصيد المتاحة للشراء مع التفاصيل الخاصة بكل حزمة.
Request
GET https://llmapi.resayil.io/api/billing/topup-packs
Authorization: Bearer YOUR_API_KEY
Response
{
  "packs": [
    { "id": "pack_500",  "credits": 500,  "price": 5.00,  "currency": "USD" },
    { "id": "pack_1100", "credits": 1100, "price": 10.00, "currency": "USD" },
    { "id": "pack_3000", "credits": 3000, "price": 25.00, "currency": "USD" }
  ]
}
يُعيد سجلاً مُرقَّماً بعمليات شراء الرصيد السابقة (20 عملية لكل صفحة). استخدم معامل page للتنقل بين الصفحات.
Request
GET https://llmapi.resayil.io/api/billing/topup-history?page=1
Authorization: Bearer YOUR_API_KEY
Response
{
  "data": [
    {
      "id": "txn_abc123",
      "credits": 1100,
      "amount": 10.00,
      "currency": "USD",
      "status": "completed",
      "created_at": "2025-03-01T10:22:00Z"
    }
  ],
  "current_page": 1,
  "per_page": 20,
  "total": 5
}

ملاحظة: عمليات شراء الرصيد تتم حصراً عبر واجهة الويب على /billing/plans. لا تتوفر نقطة نهاية API لإتمام عمليات الشراء مباشرةً — يُعالَج الدفع عبر PayPal.

مستويات الاشتراك

يقدّم LLM Resayil مستويات اشتراك متعددة تتيح حدوداً مختلفة للطلبات وإمكانية الوصول إلى النماذج.

Free
الرصيد حسب الاستخدام
الحد قياسية
السعر مجاني
Starter
الرصيد شهري أعلى
الحد موسّعة
النماذج إضافية
Basic
الحد محسّنة
المعالجة أولوية
Enterprise
الحد مخصصة
الدعم مخصص
API مؤسسي

اطّلع على صفحة الأسعار للحصول على التفاصيل الكاملة حول كل مستوى.

شراء الرصيد

يمكنك شراء الرصيد في أي وقت عبر لوحة التحكم. تُعالَج المدفوعات فوراً عبر PayPal. الرصيد المشترى لا تنتهي صلاحيته أبداً.

شحن الرصيد الآن

أضف رصيداً لحسابك عبر PayPal. الرصيد المشترى لا ينتهي أبداً.

اشترِ الآن ←

خطوات شراء الرصيد

  1. سجّل دخولك إلى لوحة التحكم
  2. انتقل إلى الفوترة ← خطط الاشتراك
  3. اختر حزمة الرصيد المناسبة
  4. أكمل عملية الدفع عبر PayPal
  5. يُضاف الرصيد إلى حسابك فوراً بعد تأكيد الدفع

طرق الدفع: تتم جميع المدفوعات عبر PayPal، بالدولار الأمريكي بشكل أساسي، مع دعم الدفع بالجنيه الإسترليني واليورو والرينغيت الماليزي والدولار الكندي.

متابعة الاستخدام

راقب استهلاك API ورصيدك من لوحة التحكم:

  • رصيد الأرصدة الحالي: يعرض الأرصدة المتبقية في حسابك
  • استخدام هذا الشهر: إجمالي الرموز والأرصدة المستهلكة في الفترة الحالية
  • تفصيل التكلفة حسب النموذج: اعرف أي النماذج يستهلك أكثر الأرصدة
  • سجل استدعاءات API: استعرض سجلات المعاملات وأنماط الاستخدام

موارد ذات صلة

  • Rate Limits & Quotas — حدود الطلبات حسب المستوى
  • Available Models — يختلف استهلاك الرموز من نموذج لآخر
  • Pricing — خطط الاشتراك والأسعار
  • Dashboard — استعرض استخدامك ورصيد حسابك

هل تريد معرفة المزيد؟

تعرّف على حدود الطلبات وإدارة الحصص.

انتقل إلى حدود المعدل والحصص ←