الأدلة الأساسية
الفواتير والتسعير
كيفية عمل الرسوم، والتقديرات، والأرصدة، والحدود
يعمل رصيد TokenLab الواحد عبر جميع النماذج. لا توجد اشتراكات أو حد أدنى للإنفاق. تبدأ عمليات شحن الرصيد من 5 دولارات. تعتمد الرسوم على النموذج والاستخدام المسجل لكل طلب.
خيارات التسليم
يتوفر نفس النموذج وAPI عبر مسارين: Verified (المُتحقق منه) وتكلفته أقل، وOfficial (الرسمي) وهو أكثر موثوقية. يحدد خيار التسليم المسار الذي سيتم من خلاله تنفيذ الطلب والسعر الذي ستدفعه.
| الخيار | المسار | السعر | في حال عدم توفر المسار |
|---|---|---|---|
Verified | Verified فقط: مسارات تم اختبارها بواسطة TokenLab | سعر Verified، أقل من سعر Official في معظم النماذج | يفشل الطلب ولا يتم احتساب رسوم |
Official | Official فقط: صانع النموذج أو منصة رئيسية | سعر 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-2 | GET /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 |
| 3D | tripo-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 للاستفسارات المتعلقة بالفواتير.