تخزين السياق مؤقتًا في Firebase AI Logic

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

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

توفّر نماذج Gemini آليتَي تخزين مؤقت مختلفتَين:

• التخزين المؤقت الضمني: يتم تفعيله تلقائيًا في معظم النماذج، ولا يتم ضمان توفير التكاليف

• التخزين المؤقت الصريح: يمكن تفعيله اختياريًا ويدويًا في معظم النماذج، وعادةً ما يؤدي إلى توفير في التكاليف

يكون التخزين المؤقت الصريح مفيدًا في الحالات التي تريد فيها ضمان توفير التكاليف بشكل أكبر، ولكن مع بعض العمل الإضافي من المطوّر.

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

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

تتوفّر ميزة التخزين المؤقت عند استخدام النماذج التالية:

• 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 2.5 ذات الاستخدام العام هذه الإمكانية، ولكن تم إيقافها نهائيًا.

لا تتيح النماذج التي تنشئ وسائط (مثل نماذج "Nana Banana" مثل gemini-3.1-flash-image) التخزين المؤقت للسياق.

الحدود القصوى لحجم المحتوى المخزّن مؤقتًا

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

• Gemini نماذج Pro: 4,096 رمزًا مميزًا كحد أدنى
• Gemini نماذج Flash: الحد الأدنى هو 1,024 رمزًا مميزًا

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

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

تكون ميزة التخزين المؤقت الضمني مفعَّلة تلقائيًا وهي متاحة لمعظم نماذج Gemini.

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

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

يتم توفير عدد الرموز المميزة في الجزء المخزّن مؤقتًا من الإدخال في الحقل cachedContentTokenCount ضمن البيانات الوصفية للرد.

التخزين المؤقت الصريح

لا يتم تفعيل التخزين المؤقت الصريح تلقائيًا، وهو إحدى الميزات الاختيارية في نماذج Gemini.

إليك كيفية إعداد ذاكرات التخزين المؤقت للمحتوى الفاضح والتعامل معها:

• إنشاء ذاكرة تخزين مؤقت صريحة ثم استخدامها

• إدارة ذاكرات التخزين المؤقت الصريحة، بما في ذلك:

  • عرض جميع الذاكرات المؤقتة

  • الحصول على بيانات وصفية حول ذاكرة تخزين مؤقت

  • تعديل قيمة TTL أو وقت انتهاء صلاحية ذاكرة تخزين مؤقت

  • حذف ذاكرة تخزين مؤقت

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

إنشاء ذاكرة تخزين مؤقت صريحة واستخدامها

يتطلّب إنشاء ذاكرة تخزين مؤقت للمحتوى الفاضح واستخدامها ما يلي:

1. إنشاء ذاكرة تخزين مؤقت صريحة

2. الإشارة إلى ذاكرة التخزين المؤقت في نموذج طلب من الخادم

3. أشِر إلى نموذج طلب الخادم في طلب من تطبيقك.

معلومات مهمة حول إنشاء ذاكرة تخزين مؤقت صريحة واستخدامها

يجب أن تتوافق ذاكرة التخزين المؤقت مع طلباتك السريعة في التطبيق ونموذج الطلب السريع على الخادم:

• تكون ذاكرة التخزين المؤقت خاصة بمقدّم خدمة Gemini API. يجب أن يستخدم طلب المطالبة في تطبيقك مقدّم الخدمة نفسه.
  بالنسبة إلى Firebase AI Logic، ننصحك بشدة باستخدام ذاكرات التخزين المؤقت للمحتوى الفاضح فقط مع Agent Platform Gemini API (formerly Vertex AI). جميع المعلومات والأمثلة الواردة في هذه الصفحة خاصة بمقدّم الخدمة Gemini API.

• تكون ذاكرة التخزين المؤقت خاصة بنموذج Gemini. يجب أن يستخدم طلبك في التطبيق النموذج نفسه.

• تكون ذاكرة التخزين المؤقت خاصة بموقع جغرافي عند استخدام السمة Agent Platform Gemini API (formerly Vertex AI).
  يجب أن يتطابق الموقع الجغرافي لذاكرة التخزين المؤقت الواضحة مع الموقع الجغرافي لنموذج طلب الخادم والموقع الجغرافي الذي يمكنك الوصول منه إلى النموذج في طلباتك ضمن التطبيق.

يُرجى أيضًا مراعاة القيود والمتطلبات التالية بشأن التخزين المؤقت الصريح:

• بعد إنشاء ذاكرة تخزين مؤقت صريحة، لا يمكنك تغيير أي شيء فيها باستثناء وقت انتهاء الصلاحية أو مدة البقاء على قيد الحياة.

• يمكنك تخزين أي نوع MIME لملف إدخال متوافق أو حتى نص يتم توفيره ضمن طلب إنشاء ذاكرة التخزين المؤقت.

• إذا أردت تضمين ملف في ذاكرة التخزين المؤقت، عليك توفير الملف كمعرّف موارد منتظم Cloud Storage. يجب ألا يكون عنوان URL للمتصفّح أو YouTube.

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

• إذا كنت تريد استخدام تعليمات أو أدوات النظام (مثل تطبيق الرموز البرمجية أو سياق عناوين URL أو تحديد المصدر باستخدام Google Search أو تحديد المصدر باستخدام Google Maps)، يجب أن تحتوي ذاكرة التخزين المؤقت نفسها على إعداداتها. لا يمكن ضبطها في نموذج طلب الموافقة على الخادم أو في طلب الموافقة في تطبيقك. ملاحظة: نماذج الطلبات من الخادم لا تتيح بعد استدعاء الدالة (أو الدردشة). للحصول على تفاصيل حول كيفية ضبط تعليمات وأدوات النظام في ذاكرة التخزين المؤقت، يُرجى الاطّلاع على REST API الخاص بـ Agent Platform Gemini API (formerly Vertex AI).

الخطوة 1: إنشاء ذاكرة التخزين المؤقت

أنشئ ذاكرة التخزين المؤقت باستخدام REST API الخاص بـ Agent Platform Gemini API (formerly Vertex AI) مباشرةً.

في ما يلي مثال ينشئ ذاكرة تخزين مؤقت صريحة لملف PDF كمحتوى له.

البنية:

PROJECT_ID="PROJECT_ID"
MODEL_ID="GEMINI_MODEL"  # for example, gemini-3.8-flash
LOCATION="LOCATION"  # location for both the cache and the model
MIME_TYPE="MIME_TYPE"
CACHED_CONTENT_URI="CLOUD_STORAGE_FILE_URI"  # must be a Cloud Storage URI
CACHE_DISPLAY_NAME="CACHE_DISPLAY_NAME"  # optional
TTL="CACHE_TIME_TO_LIVE"  # optional (if not specified, defaults to 3600s)

curl \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents \
-d @- <<EOF
{
  "model":"projects/${PROJECT_ID}/locations/${LOCATION}/publishers/google/models/${MODEL_ID}",
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "fileData": {
            "mimeType": "${MIME_TYPE}",
            "fileUri": "${CACHED_CONTENT_URI}"
          }
        }
      ]
    }
  ],
  "displayName": "${CACHE_DISPLAY_NAME}",
  "ttl": "${TTL}"
}
EOF

مثال على الطلب:

PROJECT_ID="my-amazing-app"
MODEL_ID="gemini-3.8-flash"
LOCATION="global"
MIME_TYPE="application/pdf"
CACHED_CONTENT_URI="gs://cloud-samples-data/generative-ai/pdf/2312.11805v3.pdf"
CACHE_DISPLAY_NAME="Gemini - A Family of Highly Capable Multimodal Model (PDF)"
TTL="7200s"

curl \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents \
-d @- <<EOF
{
  "model":"projects/${PROJECT_ID}/locations/${LOCATION}/publishers/google/models/${MODEL_ID}",
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "fileData": {
            "mimeType": "${MIME_TYPE}",
            "fileUri": "${CACHED_CONTENT_URI}"
          }
        }
      ]
    }
  ],
  "displayName": "${CACHE_DISPLAY_NAME}",
  "ttl": "${TTL}"
}
EOF

مثال على الرد:

يتضمّن الردّ موردًا مؤهّلاً بالكامل name وهو فريد على مستوى العالم بالنسبة إلى ذاكرة التخزين المؤقت (يُرجى العِلم أنّ الجزء الأخير هو رقم تعريف ذاكرة التخزين المؤقت). ستستخدم قيمة name الكاملة هذه في الخطوة التالية من سير العمل.

{
  "name": "projects/861083271981/locations/global/cachedContents/4545031458888089601",
  "model": "projects/my-amazing-app/locations/global/publishers/google/models/gemini-3.8-flash",
  "createTime": "2024-06-04T01:11:50.808236Z",
  "updateTime": "2024-06-04T01:11:50.808236Z",
  "expireTime": "2024-06-04T02:11:50.794542Z"
}

الخطوة 2: الإشارة إلى ذاكرة التخزين المؤقت في نموذج طلب الخادم

بعد إنشاء ذاكرة التخزين المؤقت، يمكنك الرجوع إليها باستخدام name ضمن السمة cachedContent الخاصة بنموذج طلب من الخادم.

يجب اتّباع المتطلبات التالية عند إنشاء نموذج طلب من الخادم:

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

• يجب أن يتطابق موقع نموذج طلب الخادم مع موقع ذاكرة التخزين المؤقت.

• لاستخدام تعليمات أو أدوات النظام، يجب ضبطها كجزء من ذاكرة التخزين المؤقت، وليس كجزء من نموذج طلب الخادم.

البنية:

{{cachedContent name="YOUR_CACHE_RESOURCE_NAME"}}

{{role "user"}}
{{userPrompt}}

مثال:

{{cachedContent name="projects/861083271981/locations/global/cachedContents/4545031458888089601"}}

{{role "user"}}
{{userPrompt}}

بدلاً من ذلك، يمكن أن تكون قيمة المَعلمة name في نموذج طلب الخادم متغيّر إدخال ديناميكي. على سبيل المثال، تتيح لك {{cachedContent name=someVariable}} تضمين name من ذاكرة التخزين المؤقت كإدخال للطلب من تطبيقك.

الخطوة 3: الإشارة إلى نموذج طلب الخادم في الطلب من تطبيقك

يُرجى توخّي الحذر الشديد بشأن ما يلي عند كتابة طلبك:

• استخدِم Agent Platform Gemini API (formerly Vertex AI) لأنّه تم إنشاء ذاكرة التخزين المؤقت باستخدام مقدّم خدمة Gemini API.

• يجب أن يتطابق الموقع الجغرافي الذي تصل منه إلى النموذج في طلبك الموجّه من التطبيق مع الموقع الجغرافي لنموذج الطلب على الخادم وذاكرة التخزين المؤقت.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
// Make sure to specify the same location as the server prompt template and the cache.
let model = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))
                                  .templateGenerativeModel()

do {
    let response = try await model.generateContent(
        // Specify your template ID.
        templateID: "TEMPLATE_ID"
    )
    if let text = response.text {
        print("Response Text: \(text)")
    }
} catch {
    print("An error occurred: \(error)")
}
print("\n")

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
// Make sure to specify the same location as the server prompt template and the cache.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))
                        .templateGenerativeModel()

val response = model.generateContent(
    // Specify your template ID.
    "TEMPLATE_ID",
)

val text = response.text
println(text)

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
// Make sure to specify the same location as the server prompt template and the cache.
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"))
      .templateGenerativeModel();

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

Future<GenerateContentResponse> response = model.generateContent(
    // Specify your template ID.
    "TEMPLATE_ID"
);
addCallback(response,
      new FutureCallback<GenerateContentResponse>() {
          public void onSuccess(GenerateContentResponse result) {
            System.out.println(result.getText());
          }
          public void onFailure(Throwable t) {
            reportError(t);
          }
    }
executor);

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Make sure to specify the same location as the server prompt template and the cache.
const ai = getAI(app, { backend: new AgentPlatformBackend('LOCATION') });

// Create a `TemplateGenerativeModel` instance
const model = getTemplateGenerativeModel(ai);

const result = await model.generateContent(
  // Specify your template ID.
  'TEMPLATE_ID'
);

const response = result.response;
const text = response.text();

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
// Make sure to specify the same location as the server prompt template and the cache.
var _model = FirebaseAI.agentPlatform(location: 'LOCATION').templateGenerativeModel()

var response = await _model.generateContent(
        // Specify your template ID.
        'TEMPLATE_ID',
      );

var text = response?.text;
print(text);

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Make sure to specify the same location as the server prompt template and the cache.
var firebaseAI = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// Create a `TemplateGenerativeModel` instance.
var model = firebaseAI.GetTemplateGenerativeModel();

try
{
  var response = await model.GenerateContentAsync(
      // Specify your template ID.
      "TEMPLATE_ID"
  );
  Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e) {
  Debug.LogError($"An error occurred: {e.Message}");
}

إدارة ذاكرات التخزين المؤقت الصريحة

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

يمكنك إدارة ذاكرات التخزين المؤقت الصريحة باستخدام REST API الخاص بـ Agent Platform Gemini API (formerly Vertex AI).

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

عرض قائمة بجميع ذاكرات التخزين المؤقت

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

PROJECT_ID="PROJECT_ID"
LOCATION="LOCATION"

curl \
-X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents

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

لا يمكن استرداد المحتوى المخزَّن مؤقتًا أو الاطّلاع عليه. ومع ذلك، يمكنك استرداد البيانات الوصفية حول ذاكرة تخزين مؤقت صريحة، بما في ذلك name وmodel وdisplay_name وusage_metadata وcreate_time وupdate_time وexpire_time.

يجب تقديم CACHE_ID، وهو الجزء الأخير من name الخاص بالذاكرة المؤقتة.

PROJECT_ID="PROJECT_ID"
LOCATION="LOCATION"
CACHE_ID="CACHE_ID"  # the final segment in the `name` of the cache

curl \
-X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents/${CACHE_ID}

تعديل مدة البقاء (TTL) أو وقت انتهاء صلاحية ذاكرة تخزين مؤقت

عند إنشاء ذاكرة تخزين مؤقت صريحة، يمكنك اختياريًا ضبط ttl أو expire_time.

• ‫ttl: مدة البقاء (TTL) لذاكرة التخزين المؤقت، وتحديدًا عدد الثواني وأجزاء من الثانية التي تبقى فيها ذاكرة التخزين المؤقت نشطة بعد إنشائها أو بعد تعديل ttl قبل انتهاء صلاحيتها. عند ضبط ttl، يتم تعديل expireTime لذاكرة التخزين المؤقت تلقائيًا.

• expire_time: Timestamp (مثل 2024-06-30T09:00:00.000000Z) يحدّد التاريخ والوقت المطلق لانتهاء صلاحية ذاكرة التخزين المؤقت.

إذا لم تضبط أيًا من هاتين القيمتين، ستكون مدة البقاء التلقائية ساعة واحدة. ما مِن حدّ أدنى أو أقصى لقيمة TTL.

بالنسبة إلى ذاكرات التخزين المؤقت الصريحة الحالية، يمكنك إضافة ttl أو expire_time أو تعديلهما. يجب تقديم CACHE_ID، وهو الجزء الأخير من name الخاص بالذاكرة المؤقتة.

تعديل ttl

PROJECT_ID="PROJECT_ID"
LOCATION="LOCATION"
CACHE_ID="CACHE_ID"  # the final segment in the `name` of the cache
TTL="CACHE_TIME_TO_LIVE"

curl \
-X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents/${CACHE_ID} -d \
'{
  "ttl": "'$TTL'"
}'

تعديل expire_time

PROJECT_ID="PROJECT_ID"
LOCATION="LOCATION"
CACHE_ID="CACHE_ID"  # the final segment in the `name` of the cache
EXPIRE_TIME="ABSOLUTE_TIME_CACHE_EXPIRES"

curl \
-X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents/${CACHE_ID} -d \
'{
  "expire_time": "'$EXPIRE_TIME'"
}'

حذف ذاكرة تخزين مؤقت

عندما لا تعود هناك حاجة إلى ذاكرة تخزين مؤقت صريحة، يمكنك حذفها.

يجب تقديم CACHE_ID، وهو الجزء الأخير من name الخاص بالذاكرة المؤقتة.

PROJECT_ID="PROJECT_ID"
LOCATION="LOCATION"
CACHE_ID="CACHE_ID"  # the final segment in the `name` of the cache

curl \
-X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://${LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${PROJECT_ID}/locations/${LOCATION}/cachedContents/${CACHE_ID}

أسعار التخزين المؤقت الصريح

التخزين المؤقت الصريح هو ميزة مدفوعة مصمَّمة لخفض التكلفة. تستند الأسعار إلى العوامل التالية:

• رموز الإدخال المميزة لإنشاء ذاكرة التخزين المؤقت: في كلّ من التخزين المؤقت الضمني والصريح، يتم تحصيل رسوم منك مقابل رموز الإدخال المميزة المستخدَمة لإنشاء ذاكرة التخزين المؤقت بالسعر العادي لرموز الإدخال المميزة.

• تخزين ذاكرة التخزين المؤقت: بالنسبة إلى التخزين المؤقت الصريح، هناك أيضًا تكاليف تخزين استنادًا إلى مدة تخزين ذاكرات التخزين المؤقت. لا تتوفّر تكاليف تخزين للتخزين المؤقت الضمني. لمزيد من المعلومات، اطّلِع على أسعار Agent Platform Gemini API (formerly Vertex AI).

• استخدام المحتوى المخزّن مؤقتًا: يضمن التخزين المؤقت الواضح الحصول على خصم عند الرجوع إلى ذاكرات التخزين المؤقت الواضحة، ما يعني الحصول على خصم على الرموز المميزة للإدخال عند الرجوع إلى ذاكرة تخزين مؤقت حالية. بالنسبة إلى الطُرز Gemini 2.5 والإصدارات الأحدث، يبلغ هذا الخصم %90.

يتم توفير عدد الرموز المميزة في الجزء المخزّن مؤقتًا من الإدخال في الحقل cachedContentTokenCount ضمن البيانات الوصفية للرد.