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

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

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

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

الطراز الحد الأدنى لعدد الرموز
Gemini 3.5 Flash 4096
‫Gemini 3.1 Pro (معاينة) 4096
Gemini 2.5 Flash 2048
Gemini 2.5 Pro 2048

لزيادة فرصة العثور على البيانات في ذاكرة التخزين المؤقت الضمنية:

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

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