Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

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

احتساب الرموز المميزة لنماذج Gemini

تعالج نماذج Gemini الإدخال والناتج في وحدات تُسمى الرموز المميّزة.

يمكن أن تكون الرموز المميّزة أحرفًا مفردة مثل z أو كلمات كاملة مثل cat. يتم تقسيم الكلمات الطويلة إلى عدة رموز مميزة. تُعرف مجموعة الرموز المميّزة التي يستخدمها النموذج باسم "المفردات"، وتُعرف عملية تقسيم النص إلى رموز مميّزة باسم الترميز.

بالنسبة إلى نماذج Gemini، يعادل الرمز المميّز حوالي 4 أحرف. ويعادل 100 رمز مميز حوالي 60 إلى 80 كلمة باللغة الإنجليزية.

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

النماذج المتوافقة

gemini-4-argon
‫gemini-3.8-flash (والإصدارات الأقدم gemini-3.7-flash وgemini-3.6-flash وgemini-3.5-flash)
‫gemini-3.5-flash-lite (والإصدار الأقدم gemini-3.1-flash-lite)
gemini-nano-banana-2.1 (Nano Banana 2.1)
gemini-3.1-flash-image (Nano Banana 2)
gemini-3.1-flash-lite-image (Nano Banana 2 Lite)
gemini-3-pro-image (Nano Banana Pro)
gemini-3.1-flash-tts-preview

يتيح أيضًا نموذج gemini-3.1-pro-preview ونماذج Gemini 2.5 للاستخدام العام وإنشاء الصور (التي تم إيقافها نهائيًا) هذه الإمكانية.

خيارات احتساب الرموز المميّزة

يتم تحويل جميع المدخلات والمخرجات في Gemini API إلى رموز مميزة، بما في ذلك النصوص وملفات الصور والوسائط الأخرى غير النصية. في ما يلي خيارات احتساب الرموز المميّزة:

تحقَّق من عدد الرموز المميّزة لطلباتك فقط (قبل إرسالها إلى النموذج).

استدعِ countTokens مع إدخال الطلب قبل إرساله إلى النموذج. يؤدي ذلك إلى عرض ما يلي:

‫total_tokens: عدد الرموز المميّزة للإدخال فقط

تحقَّق من عدد الرموز المميّزة لكل من طلباتك وردودك.

يمكنك الوصول إلى السمة usageMetadata في عنصر الاستجابة. ويشمل ذلك ما يلي:

‫prompt_token_count: عدد الرموز المميّزة للإدخال فقط
‫candidates_token_count: عدد الرموز المميّزة للردّ فقط (لا يشمل الرموز المميّزة للتفكير)
‫thoughts_token_count: عدد الرموز المميّزة للتفكير المستخدَمة لإنشاء الردّ
‫total_token_count: إجمالي عدد الرموز المميّزة لكل من الإدخال والإخراج (بما في ذلك أي رموز مميّزة للتفكير)

عند عرض الناتج بشكل متواصل، تظهر السمة usageMetadata فقط في الجزء الأخير من الناتج. وتكون القيمة nil للأجزاء المتوسطة.

يُرجى مراعاة النقاط التالية بشأن الخيارات أعلاه:

ولن يتم احتساب عدد الصور المُدخلة أو عدد الثواني في ملفات الفيديو أو الصوت المُدخلة. ومع ذلك، فإنّ عدد الرموز المميّزة لكل من هذه الوسائط سيرتبط بهذه القيم.
يشمل عدد الرموز المميّزة في الطلب النص وأي ملفات إدخال، بالإضافة إلى أي تعليمات وأدوات للنظام.
لا يشمل عدد الرموز المميّزة الناتجة أي رموز مميّزة للتفكير، بل يتم توفيرها في حقل منفصل.
راجِع المعلومات الإضافية الخاصة بكل نوع من الطلبات لاحقًا في هذه الصفحة.
لا تتيح نماذج Gemini Live API استخدام countTokens. بالإضافة إلى ذلك، لا يتيح Firebase AI Logic حتى الآن استخدام سمة usageMetadata في الردود من نماذج Live API، ولكن ستتوفّر هذه الميزة قريبًا.

أسعار هذه الخيارات

استدعاء countTokens: لا يتم فرض أي رسوم مقابل استدعاء countTokens (واجهة برمجة التطبيقات Count Tokens). الحدّ الأقصى لحصة Count Tokens API هو 3,000 طلب في الدقيقة (RPM).
استخدام السمة usageMetadata: يتم عرض هذه السمة دائمًا كجزء من الاستجابة ولا يتم احتساب أي رموز مميّزة أو رسوم مقابلها.

معلومات إضافية

في ما يلي بعض المعلومات الإضافية عند العمل مع أنواع معيّنة من الطلبات.

احتساب الرموز المميّزة للنص المُدخَل

ما مِن معلومات إضافية.

احتساب الرموز المميّزة في المحادثات المترابطة

يُرجى ملاحظة ما يلي عند الاتصال بـ "countTokens" أثناء استخدام المحادثة:

إذا استدعيت countTokens مع سجلّ المحادثات، ستعرض إجمالي عدد الرموز المميّزة من كلا الدورَين في المحادثة (total_tokens).
لمعرفة حجم الردّ التالي في المحادثة، عليك إضافته إلى السجلّ عند طلب countTokens.

احتساب الرموز المميّزة للإدخال المتعدد الوسائط

يُرجى مراعاة النقاط التالية حول احتساب الرموز المميّزة باستخدام الإدخال المتعدّد الوسائط:

يمكنك اختياريًا استدعاء countTokens على النص والملف بشكل منفصل.
بالنسبة إلى كلا خيارَي احتساب الرموز المميّزة، ستحصل على عدد الرموز المميّزة نفسه سواء قدّمت الملف كبيانات مضمّنة أو باستخدام عنوان URL الخاص به.

ملفات الصور المُدخلة

يتم تحويل ملفات الصور المُدخلة إلى رموز مميّزة استنادًا إلى أبعادها:

الصور التي يقلّ كلا بُعدَيها عن 384 بكسل أو يساويه: يتم احتساب كل صورة على أنّها 258 رمزًا مميزًا.
الصور التي تكون أكبر في أحد البُعدَين أو كليهما: يتم اقتصاص كل صورة وتغيير حجمها حسب الحاجة إلى مربّعات بحجم 768×768 بكسل، ثم يتم احتساب كل مربّع على أنّه 258 رمزًا مميزًا.

ملفات إدخال الفيديو والصوت

يتم تحويل ملفات الفيديو والصوت المُدخلة إلى رموز مميّزة بالمعدلات الثابتة التالية:

الفيديو: 263 رمزًا مميّزًا في الثانية
الصوت: 32 رمزًا مميزًا في الثانية

ملفات الإدخال الخاصة بالمستندات (مثل ملفات PDF)

يتم التعامل مع ملفات PDF المُدخلة كصور، لذا يتم تقسيم كل صفحة من ملف PDF إلى رموز مميزة بالطريقة نفسها التي يتم بها تقسيم الصورة.