Billing & Credits

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

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

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

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

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

تحصل الحسابات الجديدة على 1,000 رصيد مجاني للبدء. استخدمها لاستكشاف الواجهة البرمجية واختبار النماذج المختلفة. لا يُشترط وجود بطاقة ائتمانية للمستوى المجاني.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GET https://llm.resayil.io/api/billing/subscription
Authorization: Bearer YOUR_API_KEY

{
  "tier": "pro",
  "status": "active",
  "expires_at": "2025-06-01T00:00:00Z",
  "credits": {
    "balance": 4250,
    "currency": "credits"
  }
}

GET https://llm.resayil.io/api/billing/topup-packs
Authorization: Bearer YOUR_API_KEY

{
  "packs": [
    { "id": "pack_500",  "credits": 500,   "price": 5.00,  "currency": "USD" },
    { "id": "pack_2000", "credits": 2000,  "price": 18.00, "currency": "USD" },
    { "id": "pack_5000", "credits": 5000,  "price": 40.00, "currency": "USD" }
  ]
}

GET https://llm.resayil.io/api/billing/topup-history?page=1
Authorization: Bearer YOUR_API_KEY

{
  "data": [
    {
      "id": "txn_abc123",
      "credits": 2000,
      "amount": 18.00,
      "currency": "USD",
      "status": "completed",
      "created_at": "2025-03-01T10:22:00Z"
    }
  ],
  "current_page": 1,
  "per_page": 20,
  "total": 5
}

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

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

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

شراء الرصيد

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

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

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

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

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

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

موارد ذات صلة

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