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

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

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

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

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

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

• gemini-3.1-pro-preview
• ‫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-3-pro-image (المعروف أيضًا باسم "Nano Banana Pro")
• gemini-3.1-flash-image (المعروفة أيضًا باسم "Nano Banana 2")
• ‫gemini-3.1-flash-lite-image (المعروف أيضًا باسم "Nano Banana 2 Lite")
• gemini-3.1-flash-tts-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 هو 3,000 طلب في الدقيقة (RPM).

• استخدام السمة usageMetadata: يتم عرض هذه السمة دائمًا كجزء من الردّ ولا تتسبّب في أي تكلفة أو رسوم.

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

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

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

لا تتوفّر معلومات إضافية.

احتساب الرموز المميّزة المتعدّدة الدورات (المحادثة)

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

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

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

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

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

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

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

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

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

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

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

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

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