التخزين المؤقت للسياق

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

التخزين المؤقت الضمني

يتم تفعيل التخزين المؤقت الضمني تلقائيًا لجميع نماذج Gemini 2.5 والإصدارات الأحدث. وهو متاح لكل من أوضاع المحادثة التي تحتفظ بالحالة (باستخدام previous_interaction_id) والتي لا تحتفظ بالحالة. ننقل تلقائيًا وفورات التكلفة إذا تم العثور على طلبك في ذاكرات التخزين المؤقت. ليس عليك اتّخاذ أي إجراء لتفعيل هذه الميزة. يتم إدراج الحد الأدنى لعدد الرموز المميّزة للإدخال من أجل التخزين المؤقت للسياق في الجدول التالي لكل نموذج:

الطراز الحد الأدنى لعدد الرموز
Gemini 3.8 Flash 4,096
Gemini 3.7 Flash 4,096
Gemini 3.6 Flash 4,096
Gemini 3.5 Flash 4,096
Gemini 3.1 Pro Preview 4,096
Gemini 2.5 Flash 2,048
Gemini 2.5 Pro 2,048

لزيادة فرصة نتيجة ذاكرة التخزين المؤقت الضمنية:

  • حاوِل وضع المحتويات الكبيرة والشائعة في بداية طلبك
  • حاوِل إرسال الطلبات التي تتضمّن بادئة مشابهة خلال فترة زمنية قصيرة

يمكنك الاطّلاع على عدد الرموز التي تم العثور عليها في ذاكرة التخزين المؤقت في حقل usage.total_cached_tokens (Python وJavaScript) في كائن الاستجابة.