الفواتير والأسعار

نظرة عامة

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

كيف تعمل الفواتير

إضافة رصيد إلى حسابك
استخدام الـ API - يتم خصم التكاليف لكل طلب
مراقبة الاستخدام في لوحة التحكم الخاصة بك
شحن الرصيد عندما ينخفض رصيدك

نماذج التسعير

التسعير لكل Token

يتم تسعير معظم نماذج توليد النصوص لكل مليون token:

النموذج	المدخلات (لكل 1 مليون token)	المخرجات (لكل 1 مليون token)
GPT-4o	$1.75	$7.00
GPT-4o-mini	$0.105	$0.42
Claude Opus 4.5	$3.50	$17.50
Claude Sonnet 4.5	$2.10	$10.50
Claude Haiku 4.5	$0.70	$3.50
Gemini 2.5 Pro	$0.875	$7.00
Gemini 2.5 Flash	$0.1225	$0.525
DeepSeek R1	$0.385	$1.533
DeepSeek V3.2	$0.196	$0.294

الأسعار المعروضة هي أسعار المنصة المخفضة. قد تختلف الأسعار الفعلية. تحقق من صفحة الأسعار لمعرفة الأسعار الحالية.

التسعير لكل طلب

يتم تسعير نماذج الصور والفيديو والصوت لكل طلب:

النموذج	السعر لكل طلب
DALL-E 3 (1024x1024)	$0.04
Midjourney	$0.05
Sora Video (5s)	$0.20
Whisper (لكل دقيقة)	$0.006
TTS-1	$0.015

فواتير المهام غير المتزامنة Async Task (الفيديو والموسيقى و3D وبعض نماذج الصور)

في تدفقات التوليد القائمة على المهام، قد يؤدي إنشاء المهمة إلى حجز أو خصم مسبق للتكلفة التقديرية. تتم التسوية النهائية فقط بعد أن تصل المهمة غير المتزامنة إلى حالة نجاح نهائية أثناء الاستعلام أو التصفية النهائية.

بالنسبة لتدفقات التوليد القائمة على المهام (الفيديو والموسيقى و3D وبعض نماذج الصور):

أرسل المهمة. قد تجري TokenLab حجزاً أو خصماً تقديرياً للتحقق من الرصيد وحدود إنفاق API Key.
استعلم عن poll_url المرتجع، أو استدعِ GET /v1/tasks/{id}، حتى تصل المهمة إلى حالة نهائية.
عند اكتمال المهمة بنجاح، تسجل التسوية النهائية الاستخدام وتتضمن استجابة المهمة billing_transaction_id.
إذا فشل الإنشاء أو كانت الحالة النهائية failed، يتم رد أو تحرير المبلغ المعلّق ويُوسم الطلب بأنه غير قابل للفوترة.

إذا لم يعكس dashboard التسوية أو الاسترداد بعد ظهور الحالة النهائية، فتواصل مع support@tokenlab.sh للحصول على المساعدة.

# مثال: فوترة توليد الفيديو
response = client.post("/v1/videos/generations", json={
    "model": "sora-2",
    "prompt": "A sunset over the ocean"
})
# قد يتم حجز التكلفة التقديرية الآن؛ تظهر الفوترة النهائية بعد النجاح.

poll_url = response.json()["poll_url"]
task_id = response.json()["task_id"]
# استعلم عن poll_url للحالة؛ يظهر billing_transaction_id بعد التسوية.

معرّفات معاملات الفوترة

تتضمن استجابات JSON القابلة للفوترة وغير المتدفقة والمتوافقة مع OpenAI الحقل billing_transaction_id عندما تكتمل التسوية قبل إنهاء الاستجابة. وتُعرَض القيمة نفسها أيضًا في ترويسة الاستجابة X-Billing-Transaction-ID لتكاملات المتصفح والخادم. قد تعرض مسارات التوافق الأصلية مثل Gemini /v1beta القيمة عبر الترويسة فقط للحفاظ على شكل استجابة المزوّد الأصلي. بالنسبة إلى مهام الوسائط غير المتزامنة، استعلم عن poll_url المُعاد أو GET /v1/tasks/{id}؛ ستتضمن استجابة المهمة billing_transaction_id بعد اكتمال التسوية. قد تتم تسوية الاستجابات المتدفقة بعد إرسال التدفق، لذلك إذا لم تكن الترويسة موجودة فاستخدم سجلات الاستخدام في dashboard للمطابقة.

حساب الـ Tokens

الـ Tokens هي الوحدات الأساسية لمعالجة النصوص:

~4 أحرف = 1 token (الإنجليزية)
~1-2 أحرف = 1 token (الصينية)
صورة واحدة = تختلف حسب الحجم والتفاصيل

تقدير الـ Tokens

# Rough estimation
def estimate_tokens(text):
    return len(text) / 4  # Approximate for English

# Actual count (for OpenAI models)
import tiktoken
encoder = tiktoken.encoding_for_model("gpt-4o")
tokens = encoder.encode("Your text here")
print(f"Token count: {len(tokens)}")

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

لوحة التحكم

راقب استخدامك في لوحة التحكم:

الرصيد في الوقت الفعلي
سجل الاستخدام حسب النموذج
تفاصيل التكاليف
استخدام مفتاح الـ API

استجابة الـ API

تتضمن كل استجابة معلومات الاستخدام:

{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

تحسين التكلفة

استخدام النماذج المناسبة

استخدم نماذج أصغر (GPT-4o-mini، Gemini Flash) للمهام البسيطة.

تنفيذ التخزين المؤقت (Caching)

قم بتخزين الاستجابات مؤقتاً للطلبات المتطابقة المتكررة.

تحسين الأوامر (Prompts)

اجعل الأوامر موجزة مع الحفاظ على الوضوح.

تعيين max_tokens

حدد طول الاستجابة عندما لا تكون هناك حاجة لاستجابات كاملة.

استخدام البث (Streaming) للاستجابات الطويلة

لا يكلف البث مبالغ إضافية ولكنه يحسن الأداء الملحوظ.

تنبيهات انخفاض الرصيد

تكوين التنبيهات عندما ينخفض رصيدك:

انتقل إلى لوحة التحكم ← الإعدادات ← الإشعارات
حدد مبلغ الحد الأدنى الخاص بك
تلقي إشعارات البريد الإلكتروني

إضافة رصيد

طرق الدفع

Stripe (Visa, Mastercard)

الخطوات

تسجيل الدخول إلى لوحة التحكم
انقر فوق إضافة رصيد
اختر المبلغ وطريقة الدفع
أكمل عملية الدفع

يتم إضافة الرصيد فوراً بعد تأكيد الدفع.

حدود مفتاح الـ API

يمكنك تعيين حدود للإنفاق على مفاتيح API الفردية:

انتقل إلى لوحة التحكم ← مفاتيح API
انقر فوق مفتاح للتعديل
تعيين حد الاستخدام

عند الوصول إلى الحد الأقصى، ستُرجع الطلبات باستخدام هذا المفتاح الخطأ 402 Payment Required.