الأدلة الأساسية

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

كيفية عمل الرسوم، والتقديرات، والأرصدة، والحدود

يعمل رصيد TokenLab الواحد عبر جميع النماذج. لا توجد اشتراكات أو حد أدنى للإنفاق. تبدأ عمليات شحن الرصيد من 5 دولارات. تعتمد الرسوم على النموذج والاستخدام المسجل لكل طلب.

خيارات التسليم

يتوفر نفس النموذج وAPI عبر مسارين: Verified (المُتحقق منه) وتكلفته أقل، وOfficial (الرسمي) وهو أكثر موثوقية. يحدد خيار التسليم المسار الذي سيتم من خلاله تنفيذ الطلب والسعر الذي ستدفعه.

الخيارالمسارالسعرفي حال عدم توفر المسار
VerifiedVerified فقط: مسارات تم اختبارها بواسطة TokenLabسعر Verified، أقل من سعر Official في معظم النماذجيفشل الطلب ولا يتم احتساب رسوم
OfficialOfficial فقط: صانع النموذج أو منصة رئيسيةسعر Official، السعر المعلن من قبل صانع النموذجيفشل الطلب ولا يتم احتساب رسوم
Auto (افتراضي)Verified أولاً. يقوم Official بتنفيذ الطلب مرة واحدة إذا لم يتوفر لدى Verified إمدادات أو فشل قبل أي مخرجاتسعر المسار الذي أكمل الطلبيقوم Official بتنفيذ الطلب

تعرض صفحة النماذج (Models) كلا السعرين لكل نموذج.

  • يتم احتساب رسوم كل طلب مكتمل مرة واحدة.
  • لا يقوم خيار Auto بالتبديل بعد بدء المخرجات أو بعد قبول المهمة.
  • قبل التشغيل، يحتجز خيار Auto القيمة الأعلى من بين المبلغين المحتملين. إذا كان الرصيد يغطي تقدير Verified فقط، يقوم Auto بتشغيل Verified وحده لهذا الطلب ولا ينتقل إلى Official. بعد التشغيل، تدفع الرسوم الفعلية ويتم تحرير المبلغ المتبقي.
  • يتجاوز ترويسة الطلب X-TokenLab-Delivery-Policy إعداد مفتاح API، ويتجاوز إعداد مفتاح API الإعداد الافتراضي لمساحة العمل (Workspace). راجع مقدمة API.

بالنسبة للتوليد المدفوع، تعرض وحدة التحكم (Console) الحد الأقصى للتقدير قبل التأكيد. بعد الاكتمال، تعرض "التشغيلات" (Runs) و"الاستخدام" (Usage) الرسوم النهائية والخيار الذي أكمل الطلب.

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

أسعار النماذج قابلة للتغيير. تحقق من وحدة التحكم، أو صفحة النماذج، أو GET /v1/models/:model/pricing، أو API التسعير لمعرفة السعر الحالي.

في صفحة النماذج، تعني الشرطة في عمود سعر Verified أو الخصم أنه لا يوجد عرض Verified متاح حالياً؛ وهذا لا يعني أنه مجاني. تظل النماذج التي لديها إمدادات Official متاحة عبر Official أو Auto. في API، تكون حقول سعر Verified لمثل هذا النموذج null أو يتم حذفها، وتظهر حقول السعر official_* ما ستدفعه. تصف تسميات التسليم الخيارات المدعومة، بينما يتم التحقق من التوفر عند تشغيل كل طلب. تلخص أسعار السلسلة النماذج ذات الإمدادات في خيار التسليم ذي الصلة وتحتفظ بوحدات الفوترة المختلفة منفصلة.

التسعير القائم على الرموز (Token-Based Pricing)

معظم نماذج الدردشة، والاستنتاج، والتضمين (embedding)، وإعادة الترتيب (rerank)، وبعض نماذج الصور يتم تسعيرها حسب رموز الإدخال، أو المخرجات، أو التخزين المؤقت (cache)، أو رموز مخرجات الصور.

عائلة التسعيرأمثلةالتحقق من السعر الحالي
الدردشة / الردودgpt-5.4, claude-sonnet-4-6, gemini-3.6-flashصفحة النماذج أو API التسعير
التضمين / إعادة الترتيبtext-embedding-3-small, qwen3-vl-rerankتفاصيل تسعير النموذج
الصور المسعرة بالرموزgpt-image-2GET /v1/models/gpt-image-2/pricing

لا تقم بترميز جدول أسعار منسوخ داخل الكود. اقرأ السعر الحالي عندما يحتاج تطبيقك إلى عرض التكاليف أو مقارنتها.

رسوم الأدوات

بعض الأدوات المدمجة تكلف رسوماً إضافية فوق الرموز. تفرض TokenLab رسوم أداة فقط عندما يستخدم النموذج الأداة ويتم الإبلاغ عن ذلك في الرد. الطلب الذي يوفر أداة لا يستخدمها النموذج لا يتحمل أي رسوم أداة.

الأداةالنماذجالرسوم
البحث في الويبنماذج OpenAI وClaude وGrok، ونماذج Gemini 3 مع Google Search groundingكل عملية بحث يجريها النموذج. بالنسبة لـ Gemini 3، كل استعلام بحث فريد
Search groundingنماذج Gemini 2.5 مع Google Search groundingمرة واحدة لكل طلب قام البحث بتأسيسه (grounded)
  • لكل نموذج رسوم أداة خاصة به لـ Verified وOfficial، تماماً مثل أسعار الرموز الخاصة به. تظهر تفاصيل تسعير النموذج ذلك كـ Web search أو Search grounding.
  • نتائج البحث التي يقرأها النموذج تُحاسب كرموز إدخال بسعر النموذج.
  • الأداة التي ليس لها سعر على نموذج معين لا يتم احتساب رسوم عليها.
  • في وحدة التحكم، افتح طلباً في "التشغيلات" (Runs): تعرض Tool fees عدد الاستدعاءات وسعر كل استدعاء. تظهر سجلات استخدام مفتاح API نفس القيم في charged_price_basis: العدد في measure.dimensions.webSearchCalls أو groundedPrompts، وسعر كل استدعاء في effectiveUnitPrices.webSearch أو effectiveUnitPrices.groundedPrompt.

التخزين المؤقت للمطالبات (Prompt caching)

يمكن للنموذج قراءة بداية المطالبة المتكررة من ذاكرة التخزين المؤقت. الرموز المقروءة من ذاكرة التخزين المؤقت تكلف أقل من رموز الإدخال.

  • تقوم نماذج GPT وGemini وبعض النماذج الأخرى بتخزين المطالبات الطويلة المتكررة تلقائياً. لا تحتاج لضبط أي شيء.
  • تقوم نماذج Claude بالتخزين المؤقت فقط عندما تطلب ذلك. أرسل "anthropic_options": {"prompt_caching": true} في طلب إكمال الدردشة. تضع TokenLab علامة على نهاية مطالبة النظام ورسالة المستخدم الأخيرة كنقاط تخزين مؤقت. باستخدام Messages API، أضف cache_control إلى الكتل بنفسك.
الرسوممقارنة بسعر الإدخال
كتابة التخزين المؤقت، 5 دقائق (افتراضي)أعلى
كتابة التخزين المؤقت، ساعة واحدة ("prompt_caching_ttl": "1h")أعلى من كتابة الـ 5 دقائق
قراءة التخزين المؤقتأقل
  • تختلف أسعار التخزين المؤقت حسب النموذج وخيار التسليم. تحقق من أسعار التخزين المؤقت للنموذج في صفحة النماذج أو في API التسعير قبل الاعتماد على نسبة معينة.
  • المطالبة التي لا تتكرر أبداً تكلف أكثر قليلاً مع تفعيل التخزين المؤقت، بسبب عملية الكتابة في الذاكرة.
  • المطالبة الأقصر من الحد الأدنى لطول التخزين المؤقت للنموذج لا يتم تخزينها مؤقتاً ولا تتحمل رسوم كتابة.
  • التخزين المؤقت لمدة ساعة غير متاح في كل نموذج. إذا لم يكن النموذج مدرجاً له، استخدم التخزين المؤقت لمدة خمس دقائق.
  • يظهر الرد النتيجة: usage.prompt_tokens_details.cached_tokens هو عدد الرموز المقروءة من ذاكرة التخزين المؤقت. usage.cache_creation_input_tokens هو العدد المكتوب فيها، ويظهر فقط عندما يكون أكبر من صفر.

مستوى الخدمة

تقوم TokenLab بتشغيل ومحاسبة الطلبات على مستوى الخدمة القياسي. يتم قبول قيم service_tier مثل auto وdefault. يتم تجاهل القيم الأخرى، مثل flex وpriority وfast وultrafast: يتم تشغيل الطلب على المستوى القياسي ويتم محاسبته بالسعر القياسي.

تسعير الطلبات والمهام

قد يتم تسعير نماذج الصور، والفيديو، والموسيقى، والـ 3D، والصوت، والعالم لكل طلب، أو صورة، أو ثانية، أو دقيقة، أو مهمة. تعرض صفحة النموذج وحدة الفوترة.

العائلةأمثلة
الصورflux-pro-1.1
الفيديوveo3.1, seedance-2.0
الموسيقىsuno-music
3Dtripo-h3.1
الصوتgrok-tts, whisper-large-v3

فوترة المهام غير المتزامنة (Async task billing)

تحجز بعض المهام التكلفة المقدرة عند إنشائها. يتم احتساب رسوم المهمة المكتملة مرة واحدة؛ المهمة الفاشلة تحرر أو تعيد المبلغ المعلق.

تعيد مهام الفيديو، والموسيقى، والـ 3D، وتوليد الصور القائمة على المهام معرف مهمة (task ID) وpoll_url. يتم تسجيل المبلغ النهائي بعد أن تصبح المهمة completed أو failed. تتضمن المهمة المكتملة billing_transaction_id بعد الفوترة؛ المهمة الفاشلة لا يتم احتساب رسوم عليها.

إذا كان "الاستخدام" (Usage) لا يزال لا يظهر الرسوم النهائية أو المبلغ المحرر بعد انتهاء المهمة، اتصل بـ hello@tokenlab.sh مع معرف الطلب (Request ID) ومعرف المهمة.

معرفات معاملات الفوترة (Billing transaction IDs)

تتضمن الردود المتوافقة مع OpenAI غير المتدفقة (non-streaming) billing_transaction_id عندما تنتهي الفوترة قبل إرسال الرد. قد تظهر نفس القيمة في X-Billing-Transaction-ID؛ قد تعرض Gemini والتنسيقات الأصلية الأخرى ذلك فقط في هذه الترويسة.

تتضمن المهام غير المتزامنة billing_transaction_id بعد الاكتمال. قد ينتهي التدفق (Streaming) قبل انتهاء الفوترة، لذا استخدم "الاستخدام" (Usage) عندما تكون الترويسة غائبة.

عدد الرموز (Token counts)

عادةً ما تبلغ نماذج النصوص عن رموز الإدخال، والمخرجات، وإجمالي الرموز في usage. تختلف عملية الترميز (Tokenization) حسب النموذج، واللغة، ومدخلات الوسائط، لذا فإن صيغ حساب عدد الأحرف ليست تقديرات فوترة موثوقة. استخدم السعر الحالي للنموذج وسجل الاستخدام النهائي.

العثور على استخدامك

افتح الاستخدام للعثور على:

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

رد API

عادةً ما تتضمن الردود القائمة على الرموز معلومات الاستخدام:

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

أنفق أقل

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

قم بتعيين حد في Console → Settings. ترسل TokenLab بريداً إلكترونياً إليك عندما ينخفض الرصيد عن هذا الحد.

إضافة رصيد

افتح Console → Billing، واختر مبلغاً، واستخدم إحدى طرق الدفع المعروضة عند الدفع. يتم تحديث الرصيد بعد تأكيد مزود الدفع للعملية.

أثناء تشغيل عرض الرصيد التجريبي، يحصل الحساب الجديد المؤهل على رصيد تجريبي لمرة واحدة بقيمة 0.25 دولار لما يصل إلى 10 استدعاءات. تنتهي صلاحية الرصيد التجريبي غير المستخدم بعد 7 أيام.

لمنع توقف الطلبات عند انخفاض الرصيد، قم بتفعيل Automatic funding في Billing. يقوم هذا الخيار بإضافة أموال عندما ينخفض الرصيد عن المبلغ الذي حددته، بحد أقصى شهري.

حدود مفتاح API

يمكنك تعيين حد للإنفاق عند إنشاء أو تعديل مفتاح API في Console → API Keys.

عند الوصول إلى الحد، تعيد الطلبات التي تستخدم هذا المفتاح 402 مع الرمز quota_exceeded. ارفع الحد أو أزله للاستمرار.

مساعدة الفوترة

اتصل بـ hello@tokenlab.sh للاستفسارات المتعلقة بالفواتير.

في هذه الصفحة