Gemini Interactions API هي واجهة برمجة تطبيقات تجريبية تتيح للمطوّرين إنشاء تطبيقات تستخدم الذكاء الاصطناعي التوليدي من خلال نماذج Gemini. Gemini هو نموذجنا الأكثر تطورًا، وقد تم تصميمه من البداية ليكون متعدّد الوسائط. يمكنه التعميم والفهم السلس لأنواع مختلفة من المعلومات والتعامل معها ودمجها، بما في ذلك اللغة والصور والمقاطع الصوتية والفيديوهات والرموز البرمجية. يمكنك استخدام Gemini API لحالات استخدام مثل الاستدلال على النصوص والصور، وإنشاء المحتوى، ووكلاء الحوار، وأنظمة التلخيص والتصنيف، وغير ذلك.
إنشاء تفاعل
تُنشئ هذه الطريقة تفاعلاً جديدًا.
نص الطلب
يتضمن نص الطلب بيانات بالبنية التالية:
model ModelOption (اختياري)
اسم `النموذج` المستخدَم لإنشاء التفاعل.
مطلوبة إذا لم يتم تقديم `agent`.
القيم المحتملة:
-
gemini-2.5-proنموذجنا المتطوّر المتعدّد الأغراض، والذي يتفوّق في الترميز ومهام الاستدلال المعقّدة.
-
gemini-2.5-flashنموذجنا الأول للاستدلال المختلط الذي يتيح قدرة استيعاب مليون رمز مميّز ويتضمّن ميزانيات للتفكير.
-
gemini-2.5-flash-preview-09-2025أحدث نموذج يستند إلى نموذج 2.5 Flash. 2.5 Flash Preview هو الخيار الأفضل للمهام التي تتطلّب التفكير ومعالجة البيانات على نطاق واسع، والمهام التي تتطلّب وقت استجابة منخفضًا، والمهام التي تتطلّب معالجة كميات كبيرة من البيانات، وحالات الاستخدام التي تتطلّب وكيلًا.
-
gemini-2.5-flash-liteهذا النموذج هو الأصغر والأكثر فعالية من حيث التكلفة، وهو مصمّم للاستخدام على نطاق واسع.
-
gemini-2.5-flash-lite-preview-09-2025أحدث نموذج يستند إلى Gemini 2.5 Flash lite، وهو محسّن لتحقيق فعالية من حيث التكلفة وإنتاجية عالية وجودة عالية.
-
gemini-2.5-flash-preview-native-audio-dialogتم تحسين نماذج الصوت الأصلية لإنتاج نتائج صوتية بجودة أعلى مع تحسين السرعة والطبيعية والوضوح والمزاج.
-
gemini-2.5-flash-image-previewنموذجنا الأصلي لإنشاء الصور، وهو نموذج محسّن من حيث السرعة والمرونة والفهم السياقي. يتم تسعير إدخال النص وإخراجه بنفس سعر 2.5 Flash.
-
gemini-2.5-pro-preview-ttsنموذجنا الصوتي 2.5 Pro لتحويل النص إلى كلام محسّن لإنشاء كلام قوي وبزمن استجابة منخفض، ما يتيح الحصول على نتائج أكثر طبيعية وتوجيه الطلبات بسهولة أكبر.
-
gemini-3-pro-previewنموذجنا الأكثر ذكاءً الذي يتميّز بقدرات استدلالية وفهم لمختلف الوسائط على أعلى مستوى، بالإضافة إلى إمكانات ترميز متطوّرة وميزات تستند إلى الذكاء الاصطناعي الوكيل.
agent AgentOption (اختياري)
اسم "الموظف" المستخدَم لإنشاء التفاعل.
مطلوبة إذا لم يتم تقديم `model`.
القيم المحتملة:
-
deep-research-pro-preview-12-2025وكيل Deep Research في Gemini
تمثّل هذه السمة المعلومات التي يتم إدخالها للتفاعل (وهي مشتركة بين النموذج والوكيل).
تعليمات النظام للتفاعل
قائمة بتعريفات الأدوات التي قد يستدعيها النموذج أثناء التفاعل
يفرض أن تكون الاستجابة التي تم إنشاؤها عبارة عن عنصر JSON يتوافق مع مخطط JSON المحدّد في هذا الحقل.
نوع MIME الخاص بالردّ. هذا الإجراء مطلوب إذا تم ضبط response_format.
الإدخال فقط تُستخدَم لتحديد ما إذا كان سيتم بث التفاعل.
الإدخال فقط تحديد ما إذا كان سيتم تخزين الرد والطلب لاستردادهما لاحقًا
تحديد ما إذا كان سيتم تشغيل التفاعل مع النموذج في الخلفية
generation_config GenerationConfig (optional)
إعدادات النموذج
مَعلمات الإعدادات للتفاعل مع النموذج
بديل عن `agent_config`. لا ينطبق إلا عند ضبط `model`.
الحقول
تتحكّم هذه السمة في عشوائية الناتج.
الحدّ الأقصى للاحتمال التراكمي للرموز المميّزة التي يجب أخذها في الاعتبار عند أخذ العيّنات.
القيمة الأولية المستخدَمة في فك الترميز لضمان إمكانية إعادة الإنتاج
قائمة بتسلسلات الأحرف التي ستوقف التفاعل مع الإخراج.
tool_choice ToolChoice (اختيارية)
أداة اختيار التفاعل
الأنواع المحتمَلة
ToolChoiceType
لا يتضمّن هذا النوع أي حقول محدّدة.
ToolChoiceConfig
allowed_tools AllowedTools (اختياري)
لم يتم تقديم أي وصف.
الحقول
mode ToolChoiceType (اختياري)
وضع اختيار الأداة
القيم المحتملة:
-
auto -
any -
none -
validated
أسماء الأدوات المسموح بها
thinking_level ThinkingLevel (اختيارية)
مستوى الرموز المميزة للأفكار التي يجب أن ينشئها النموذج
القيم المحتملة:
-
low -
high
thinking_summaries ThinkingSummaries (اختيارية)
تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.
القيم المحتملة:
-
auto -
none
الحدّ الأقصى لعدد الرموز المميّزة التي يمكن تضمينها في الردّ
speech_config SpeechConfig (اختياري)
إعدادات التفاعل الصوتي
الحقول
صوت المتحدث
لغة الكلام
اسم المتحدث، ويجب أن يتطابق مع اسم المتحدث الوارد في الطلب
agent_config object (اختياري)
إعدادات "الوكيل"
إعدادات "الوكيل".
بديل عن `generation_config`. لا ينطبق إلا عند ضبط `agent`.
الأنواع المحتمَلة
المميّز المتعدّد الأشكال: type
DynamicAgentConfig
إعدادات الوكلاء الديناميكيين
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "dynamic".
DeepResearchAgentConfig
إعدادات وكيل Deep Research
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "deep-research".
thinking_summaries ThinkingSummaries (اختيارية)
تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.
القيم المحتملة:
-
auto -
none
رقم تعريف التفاعل السابق، إن وُجد.
response_modalities ResponseModality (اختيارية)
طُرق عرض الرد المطلوبة (TEXT أو IMAGE أو AUDIO).
القيم المحتملة:
-
text -
image -
audio
الردّ
تعرض هذه الطريقة مورد Interaction.
طلب بسيط
مثال على الرد
{ "created": "2025-11-26T12:25:15Z", "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "object": "interaction", "outputs": [ { "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?", "type": "text" } ], "role": "model", "status": "completed", "updated": "2025-11-26T12:25:15Z", "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 7 } ], "total_cached_tokens": 0, "total_input_tokens": 7, "total_output_tokens": 20, "total_reasoning_tokens": 22, "total_tokens": 49, "total_tool_use_tokens": 0 } }
محادثة متعدّدة الجولات
مثال على الرد
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "status": "completed", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "text", "text": "The capital of France is Paris." } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 50 } ], "total_cached_tokens": 0, "total_input_tokens": 50, "total_output_tokens": 10, "total_reasoning_tokens": 0, "total_tokens": 60, "total_tool_use_tokens": 0 } }
إدخال الصور
مثال على الرد
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "status": "completed", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "text", "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard." } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 10 }, { "modality": "image", "tokens": 258 } ], "total_cached_tokens": 0, "total_input_tokens": 268, "total_output_tokens": 20, "total_reasoning_tokens": 0, "total_tokens": 288, "total_tool_use_tokens": 0 } }
استدعاء الدوال
مثال على الرد
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "status": "requires_action", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "function_call", "function_call": { "name": "get_weather", "arguments": { "location": "Boston, MA" } } } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 100 } ], "total_cached_tokens": 0, "total_input_tokens": 100, "total_output_tokens": 25, "total_reasoning_tokens": 0, "total_tokens": 125, "total_tool_use_tokens": 50 } }
Deep Research
مثال على الرد
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "agent": "deep-research-pro-preview-12-2025", "status": "completed", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "text", "text": "Here is a comprehensive research report on the current state of cancer research..." } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 20 } ], "total_cached_tokens": 0, "total_input_tokens": 20, "total_output_tokens": 1000, "total_reasoning_tokens": 500, "total_tokens": 1520, "total_tool_use_tokens": 0 } }
استرداد تفاعل
تسترد هذه الطريقة التفاصيل الكاملة لتفاعل واحد استنادًا إلى `Interaction.id`.
مَعلمات المسار / طلب البحث
المعرّف الفريد للتفاعل المطلوب استرجاعه.
في حال ضبطها على "صحيح"، سيتم بث المحتوى الذي تم إنشاؤه بشكل تدريجي.
الإعداد التلقائي هو: False
اختيارية: في حال ضبط هذا الحقل، يتم استئناف بث التفاعل من الجزء التالي بعد الحدث الذي تم وضع علامة عليه برقم تعريف الحدث. لا يمكن استخدامها إلا إذا كانت قيمة `stream` هي "صحيح".
إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه
الردّ
تعرض هذه الطريقة مورد Interaction.
Get Interaction
مثال على الرد
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "status": "completed", "object": "interaction", "created": "2025-11-26T12:25:15Z", "updated": "2025-11-26T12:25:15Z", "role": "model", "outputs": [ { "type": "text", "text": "I'm doing great, thank you for asking! How can I help you today?" } ] }
حذف تفاعل
يحذف هذا الإجراء التفاعل حسب رقم التعريف.
مَعلمات المسار / طلب البحث
المعرّف الفريد للتفاعل المطلوب حذفه.
إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه
الردّ
إذا نجح الطلب، ستكون الاستجابة فارغة.
حذف التفاعل
إلغاء تفاعل
تلغي هذه الطريقة تفاعلاً حسب رقم التعريف. ينطبق ذلك فقط على التفاعلات التي لا تزال قيد التشغيل في الخلفية.
مَعلمات المسار / طلب البحث
المعرّف الفريد للتفاعل المطلوب استرجاعه.
إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه
الردّ
تعرض هذه الطريقة مورد Interaction.
إلغاء التفاعل
مثال على الرد
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "agent": "deep-research-pro-preview-12-2025", "status": "cancelled", "object": "interaction", "created": "2025-11-26T12:25:15Z", "updated": "2025-11-26T12:25:15Z", "role": "model" }
الموارد
التفاعل
مورد Interaction
الحقول
model ModelOption (اختياري)
اسم `النموذج` المستخدَم لإنشاء التفاعل.
القيم المحتملة:
-
gemini-2.5-proنموذجنا المتطوّر المتعدّد الأغراض، والذي يتفوّق في الترميز ومهام الاستدلال المعقّدة.
-
gemini-2.5-flashنموذجنا الأول للاستدلال المختلط الذي يتيح قدرة استيعاب مليون رمز مميّز ويتضمّن ميزانيات للتفكير.
-
gemini-2.5-flash-preview-09-2025أحدث نموذج يستند إلى نموذج 2.5 Flash. 2.5 Flash Preview هو الخيار الأفضل للمهام التي تتطلّب التفكير ومعالجة البيانات على نطاق واسع، والمهام التي تتطلّب وقت استجابة منخفضًا، والمهام التي تتطلّب معالجة كميات كبيرة من البيانات، وحالات الاستخدام التي تتطلّب وكيلًا.
-
gemini-2.5-flash-liteهذا النموذج هو الأصغر والأكثر فعالية من حيث التكلفة، وهو مصمّم للاستخدام على نطاق واسع.
-
gemini-2.5-flash-lite-preview-09-2025أحدث نموذج يستند إلى Gemini 2.5 Flash lite، وهو محسّن لتحقيق فعالية من حيث التكلفة وإنتاجية عالية وجودة عالية.
-
gemini-2.5-flash-preview-native-audio-dialogتم تحسين نماذج الصوت الأصلية لإنتاج نتائج صوتية بجودة أعلى مع تحسين السرعة والطبيعية والوضوح والمزاج.
-
gemini-2.5-flash-image-previewنموذجنا الأصلي لإنشاء الصور، وهو نموذج محسّن من حيث السرعة والمرونة والفهم السياقي. يتم تسعير إدخال النص وإخراجه بنفس سعر 2.5 Flash.
-
gemini-2.5-pro-preview-ttsنموذجنا الصوتي 2.5 Pro لتحويل النص إلى كلام محسّن لإنشاء كلام قوي وبزمن استجابة منخفض، ما يتيح الحصول على نتائج أكثر طبيعية وتوجيه الطلبات بسهولة أكبر.
-
gemini-3-pro-previewنموذجنا الأكثر ذكاءً الذي يتميّز بقدرات استدلالية وفهم لمختلف الوسائط على أعلى مستوى، بالإضافة إلى إمكانات ترميز متطوّرة وميزات تستند إلى الذكاء الاصطناعي الوكيل.
agent AgentOption (اختياري)
اسم "الموظف" المستخدَم لإنشاء التفاعل.
القيم المحتملة:
-
deep-research-pro-preview-12-2025وكيل Deep Research في Gemini
النتائج فقط. معرّف فريد لإكمال التفاعل.
النتائج فقط. تمثّل هذه السمة حالة التفاعل.
القيم المحتملة:
-
in_progress -
requires_action -
completed -
failed -
cancelled
النتائج فقط. تمثّل هذه السمة وقت إنشاء الردّ بتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ssZ).
النتائج فقط. تمثّل هذه السمة الوقت الذي تم فيه آخر تعديل على الرد بالتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ssZ).
النتائج فقط. دور التفاعل
النتائج فقط. الردود من النموذج
النتائج فقط. نوع العنصر الذي تم التفاعل معه. يتم ضبط القيمة دائمًا على `interaction`.
يجب ضبطها دائمًا على "interaction".
usage Usage (اختياري)
النتائج فقط. إحصاءات حول استخدام الرمز المميّز لطلب التفاعل
الحقول
عدد الرموز المميزة في الطلب (السياق).
input_tokens_by_modality ModalityTokens (اختياري)
تفصيل لاستخدام الرموز المميزة للإدخال حسب نوع البيانات
الحقول
modality ResponseModality (اختيارية)
الوسيط المرتبط بعدد الرموز المميزة.
القيم المحتملة:
-
text -
image -
audio
عدد الرموز المميّزة للوسائط
عدد الرموز المميزة في الجزء المخزّن مؤقتًا من الطلب (المحتوى المخزّن مؤقتًا)
cached_tokens_by_modality ModalityTokens (اختياري)
تفصيل لاستخدام الرمز المميز المخزّن مؤقتًا حسب طريقة الدفع
الحقول
modality ResponseModality (اختيارية)
الوسيط المرتبط بعدد الرموز المميزة.
القيم المحتملة:
-
text -
image -
audio
عدد الرموز المميّزة للوسائط
إجمالي عدد الرموز المميزة في جميع الردود التي تم إنشاؤها
output_tokens_by_modality ModalityTokens (اختياري)
تفاصيل استخدام الرموز المميزة للناتج حسب طريقة العرض
الحقول
modality ResponseModality (اختيارية)
الوسيط المرتبط بعدد الرموز المميزة.
القيم المحتملة:
-
text -
image -
audio
عدد الرموز المميّزة للوسائط
عدد الرموز المميزة المتوفّرة في طلبات استخدام الأدوات
tool_use_tokens_by_modality ModalityTokens (اختياري)
تفصيل لاستخدام الرموز المميزة الخاصة باستخدام الأدوات حسب نوع البيانات
الحقول
modality ResponseModality (اختيارية)
الوسيط المرتبط بعدد الرموز المميزة.
القيم المحتملة:
-
text -
image -
audio
عدد الرموز المميّزة للوسائط
عدد الرموز المميّزة للأفكار في نماذج التفكير
إجمالي عدد الرموز المميزة لطلب التفاعل (الطلب + الردود + الرموز المميزة الداخلية الأخرى).
رقم تعريف التفاعل السابق، إن وُجد
أمثلة
مثال
{ "created": "2025-12-04T15:01:45Z", "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg", "model": "gemini-2.5-flash", "object": "interaction", "outputs": [ { "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?", "type": "text" } ], "role": "model", "status": "completed", "updated": "2025-12-04T15:01:45Z", "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 7 } ], "total_cached_tokens": 0, "total_input_tokens": 7, "total_output_tokens": 23, "total_reasoning_tokens": 49, "total_tokens": 79, "total_tool_use_tokens": 0 } }
نماذج البيانات
المحتوى
محتوى الردّ.
الأنواع المحتمَلة
المميّز المتعدّد الأشكال: type
TextContent
مقطع نصي
محتوى النص
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "text".
annotations Annotation (اختياري)
تمثّل هذه السمة معلومات الاقتباس للمحتوى من إنشاء النموذج.
الحقول
بداية جزء الردّ الذي يتمّ نسبه إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.
نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.
المصدر المنسوب إليه جزء من النص يمكن أن يكون عنوان URL أو عنوانًا أو معرّفًا آخر.
ImageContent
كتلة محتوى صورة
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
mime_type ImageMimeTypeOption (اختيارية)
لم يتم تقديم أي وصف.
القيم المحتملة:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "image".
resolution MediaResolution (اختياري)
تمثّل درجة دقة الوسائط.
القيم المحتملة:
-
low -
medium -
high
AudioContent
كتلة محتوى صوتي
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
mime_type AudioMimeTypeOption (اختيارية)
لم يتم تقديم أي وصف.
القيم المحتملة:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "audio".
DocumentContent
وحدة محتوى مستند
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "document".
VideoContent
كتلة محتوى فيديو
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
mime_type VideoMimeTypeOption (اختيارية)
لم يتم تقديم أي وصف.
القيم المحتملة:
-
video/mp4 -
video/mpeg -
video/mov -
video/avi -
video/x-flv -
video/mpg -
video/webm -
video/wmv -
video/3gpp
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "video".
resolution MediaResolution (اختياري)
تمثّل درجة دقة الوسائط.
القيم المحتملة:
-
low -
medium -
high
ThoughtContent
وحدة محتوى فكرية
توقيع لمطابقة المصدر الخلفي الذي سيتم تضمينه في عملية الإنشاء
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "thought".
summary ThoughtSummary (اختياري)
ملخّص الفكرة
FunctionCallContent
كتلة محتوى لاستدعاء أداة وظيفة
تمثّل هذه السمة اسم الأداة المطلوب استدعاؤها.
الوسيطات التي سيتم تمريرها إلى الدالة
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "function_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
FunctionResultContent
كتلة محتوى لنتيجة أداة دالة
تمثّل هذه السمة اسم الأداة التي تم استدعاؤها.
تُستخدَم لتحديد ما إذا كان استدعاء الأداة قد نتج عنه خطأ.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "function_result".
نتيجة استدعاء الأداة
معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.
CodeExecutionCallContent
محتوى تنفيذ الرموز البرمجية
arguments CodeExecutionCallArguments (اختياري)
الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي
الحقول
لغة البرمجة الخاصة بالرمز البرمجي.
القيم المحتملة:
-
python
الرمز المطلوب تنفيذه
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "code_execution_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
CodeExecutionResultContent
محتوى نتيجة تنفيذ الرمز البرمجي
ناتج تنفيذ الرمز البرمجي
تُستخدَم لتحديد ما إذا كان تنفيذ الرمز البرمجي قد أدّى إلى حدوث خطأ.
تجزئة توقيع للتحقّق من صحة البيانات في الخلفية
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "code_execution_result".
معرّف يجب أن يتطابق مع المعرّف من حزمة طلب تنفيذ الرمز البرمجي
UrlContextCallContent
محتوى سياق عنوان URL
arguments UrlContextCallArguments (اختياري)
الوسيطات التي سيتم تمريرها إلى سياق عنوان URL
الحقول
عناوين URL المطلوب جلبها
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "url_context_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
UrlContextResultContent
محتوى نتيجة البحث السياقي في عنوان URL
توقيع نتيجة سياق عنوان URL
result UrlContextResult (اختياري)
نتائج سياق عنوان URL
الحقول
عنوان URL الذي تم استرجاعه.
حالة استرداد عنوان URL
القيم المحتملة:
-
success -
error -
paywall -
unsafe
تُستخدَم لتحديد ما إذا كان سياق عنوان URL قد أدّى إلى حدوث خطأ.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "url_context_result".
معرّف يجب أن يتطابق مع المعرّف من وحدة طلب سياق عنوان URL.
GoogleSearchCallContent
محتوى "بحث Google"
arguments GoogleSearchCallArguments (اختياري)
الوسيطات التي يجب تمريرها إلى "بحث Google"
الحقول
طلبات البحث على الويب التي يتم إجراؤها بعد البحث الأولي على الويب
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "google_search_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
GoogleSearchResultContent
محتوى نتيجة البحث على Google
توقيع نتيجة البحث على Google
result GoogleSearchResult (اختياري)
نتائج البحث من Google
الحقول
مرجع URI لنتيجة البحث
تمثّل هذه السمة عنوان نتيجة البحث.
مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو عرض ويب داخل تطبيق
تُستخدَم لتحديد ما إذا كان البحث على Google قد أدّى إلى حدوث خطأ.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "google_search_result".
المعرّف الذي يجب أن يتطابق مع المعرّف من حظر المكالمات في "بحث Google"
McpServerToolCallContent
محتوى استدعاء أداة MCPServer
اسم الأداة التي تم استدعاؤها.
اسم خادم MCP المستخدَم
عنصر JSON الخاص بوسيطات الدالة
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "mcp_server_tool_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
McpServerToolResultContent
محتوى نتيجة أداة MCPServer
اسم الأداة التي يتم استدعاؤها لتنفيذ استدعاء الأداة المحدّد هذا.
اسم خادم MCP المستخدَم
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "mcp_server_tool_result".
نتيجة استدعاء الأداة
المعرّف الذي يجب أن يتطابق مع المعرّف من أداة خادم MCP لكتلة طلبات البيانات.
FileSearchResultContent
محتوى نتيجة البحث في الملفات
result FileSearchResult (اختياري)
نتائج البحث عن الملفات
الحقول
تمثّل هذه السمة عنوان نتيجة البحث.
نص نتيجة البحث
تمثّل هذه السمة اسم متجر البحث عن الملفات.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "file_search_result".
أمثلة
نص
{ "type": "text", "text": "Hello, how are you?" }
صورة
{ "type": "image", "data": "BASE64_ENCODED_IMAGE", "mime_type": "image/png" }
الصوت
{ "type": "audio", "data": "BASE64_ENCODED_AUDIO", "mime_type": "audio/wav" }
مستند
{ "type": "document", "data": "BASE64_ENCODED_DOCUMENT", "mime_type": "application/pdf" }
فيديو
{ "type": "video", "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg" }
فكرة
{ "type": "thought", "summary": [ { "type": "text", "text": "The user is asking about the weather. I should use the get_weather tool." } ], "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh" }
استدعاء الدالة
{ "type": "function_call", "name": "get_weather", "id": "gth23981", "arguments": { "location": "Boston, MA" } }
نتيجة الدالة
{ "type": "function_result", "name": "get_weather", "call_id": "gth23981", "result": { "weather": "sunny" } }
طلب تنفيذ الرمز البرمجي
{ "type": "code_execution_call", "id": "call_123456", "arguments": { "language": "python", "code": "print('hello world')" } }
نتيجة تنفيذ الرمز البرمجي
{ "type": "code_execution_result", "call_id": "call_123456", "result": "hello world\n" }
طلب سياق عنوان URL
{ "type": "url_context_call", "id": "call_123456", "arguments": { "urls": [ "https://www.example.com" ] } }
نتيجة سياق عنوان URL
{ "type": "url_context_result", "call_id": "call_123456", "result": [ { "url": "https://www.example.com", "status": "SUCCESS" } ] }
ميزة "اتصال من Google"
{ "type": "google_search_call", "id": "call_123456", "arguments": { "queries": [ "weather in Boston" ] } }
نتيجة بحث من Google
{ "type": "google_search_result", "call_id": "call_123456", "result": [ { "url": "https://www.google.com/search?q=weather+in+Boston", "title": "Weather in Boston" } ] }
Mcp Server Tool Call
{ "type": "mcp_server_tool_call", "id": "call_123456", "name": "get_forecast", "server_name": "weather_server", "arguments": { "city": "London" } }
نتيجة أداة خادم MCP
{ "type": "mcp_server_tool_result", "name": "get_forecast", "server_name": "weather_server", "call_id": "call_123456", "result": "sunny" }
نتيجة البحث في الملف
{ "type": "file_search_result", "result": [ { "text": "search result chunk", "file_search_store": "file_search_store" } ] }
الأداة
الأنواع المحتمَلة
المميّز المتعدّد الأشكال: type
الوظيفة
أداة يمكن أن يستخدمها النموذج
اسم الدالة
تمثّل هذه السمة وصفًا للدالة.
مخطط JSON الخاص بمعلمات الدالة.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "function".
GoogleSearch
أداة يمكن أن يستخدمها النموذج للبحث على Google
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "google_search".
CodeExecution
أداة يمكن أن يستخدمها النموذج لتنفيذ الرمز البرمجي
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "code_execution".
UrlContext
أداة يمكن أن يستخدمها النموذج لجلب سياق عنوان URL.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "url_context".
ComputerUse
أداة يمكن أن يستخدمها النموذج للتفاعل مع الكمبيوتر
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "computer_use".
البيئة التي يتم تشغيلها
القيم المحتملة:
-
browser
قائمة الدوال المحدّدة مسبقًا والتي تم استبعادها من طلب النموذج
McpServer
خادم MCPServer هو خادم يمكن للنموذج استدعاؤه لتنفيذ إجراءات.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "mcp_server".
تمثّل هذه السمة اسم MCPServer.
عنوان URL الكامل لنقطة نهاية MCPServer مثال: "https://api.example.com/mcp"
اختياري: حقول لعناوين المصادقة ومهلات الانتظار وما إلى ذلك، إذا لزم الأمر
allowed_tools AllowedTools (اختياري)
الأدوات المسموح بها
الحقول
mode ToolChoiceType (اختياري)
وضع اختيار الأداة
القيم المحتملة:
-
auto -
any -
none -
validated
أسماء الأدوات المسموح بها
FileSearch
أداة يمكن للنموذج استخدامها للبحث في الملفات
أسماء متاجر البحث عن الملفات
عدد أجزاء الاسترجاع الدلالي المطلوب استرجاعها.
فلتر البيانات الوصفية الذي سيتم تطبيقه على المستندات والأجزاء التي يتم استرجاعها دلاليًا.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "file_search".
أمثلة
الوظيفة
GoogleSearch
CodeExecution
UrlContext
ComputerUse
McpServer
FileSearch
Turn
الحقول
تمثّل هذه السمة الجهة التي بدأت هذا الدور. يجب أن يكون المستخدم هو مصدر الإدخال أو النموذج هو مصدر الإخراج.
محتوى الدور
أمثلة
دور المستخدم
{ "role": "user", "content": [ { "type": "text", "text": "user turn" } ] }
Model Turn
{ "role": "model", "content": [ { "type": "text", "text": "model turn" } ] }
InteractionSseEvent
الأنواع المحتمَلة
المميّز المتعدّد الأشكال: event_type
InteractionEvent
لم يتم تقديم أي وصف.
القيم المحتملة:
-
interaction.start -
interaction.complete
لم يتم تقديم أي وصف.
الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.
InteractionStatusUpdate
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
القيم المحتملة:
-
in_progress -
requires_action -
completed -
failed -
cancelled
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "interaction.status_update".
الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.
ContentStart
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "content.start".
الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.
ContentDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "content.delta".
الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.
delta object (اختياري)
لم يتم تقديم أي وصف.
الأنواع المحتمَلة
المميّز المتعدّد الأشكال: type
TextDelta
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "text".
annotations Annotation (اختياري)
تمثّل هذه السمة معلومات الاقتباس للمحتوى من إنشاء النموذج.
الحقول
بداية جزء الردّ الذي يتمّ نسبه إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.
نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.
المصدر المنسوب إليه جزء من النص يمكن أن يكون عنوان URL أو عنوانًا أو معرّفًا آخر.
ImageDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
mime_type ImageMimeTypeOption (اختيارية)
لم يتم تقديم أي وصف.
القيم المحتملة:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "image".
resolution MediaResolution (اختياري)
تمثّل درجة دقة الوسائط.
القيم المحتملة:
-
low -
medium -
high
AudioDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
mime_type AudioMimeTypeOption (اختيارية)
لم يتم تقديم أي وصف.
القيم المحتملة:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "audio".
DocumentDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "document".
VideoDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
mime_type VideoMimeTypeOption (اختيارية)
لم يتم تقديم أي وصف.
القيم المحتملة:
-
video/mp4 -
video/mpeg -
video/mov -
video/avi -
video/x-flv -
video/mpg -
video/webm -
video/wmv -
video/3gpp
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "video".
resolution MediaResolution (اختياري)
تمثّل درجة دقة الوسائط.
القيم المحتملة:
-
low -
medium -
high
ThoughtSummaryDelta
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "thought_summary".
لم يتم تقديم أي وصف.
ThoughtSignatureDelta
توقيع لمطابقة المصدر الخلفي الذي سيتم تضمينه في عملية الإنشاء
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "thought_signature".
FunctionCallDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "function_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
FunctionResultDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "function_result".
دلتا نتيجة استدعاء الأداة
معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.
CodeExecutionCallDelta
arguments CodeExecutionCallArguments (اختياري)
لم يتم تقديم أي وصف.
الحقول
لغة البرمجة الخاصة بالرمز البرمجي.
القيم المحتملة:
-
python
الرمز المطلوب تنفيذه
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "code_execution_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
CodeExecutionResultDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "code_execution_result".
معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.
UrlContextCallDelta
arguments UrlContextCallArguments (اختياري)
لم يتم تقديم أي وصف.
الحقول
عناوين URL المطلوب جلبها
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "url_context_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
UrlContextResultDelta
لم يتم تقديم أي وصف.
result UrlContextResult (اختياري)
لم يتم تقديم أي وصف.
الحقول
عنوان URL الذي تم استرجاعه.
حالة استرداد عنوان URL
القيم المحتملة:
-
success -
error -
paywall -
unsafe
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "url_context_result".
معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.
GoogleSearchCallDelta
arguments GoogleSearchCallArguments (اختياري)
لم يتم تقديم أي وصف.
الحقول
طلبات البحث على الويب التي يتم إجراؤها بعد البحث الأولي على الويب
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "google_search_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
GoogleSearchResultDelta
لم يتم تقديم أي وصف.
result GoogleSearchResult (اختياري)
لم يتم تقديم أي وصف.
الحقول
مرجع URI لنتيجة البحث
تمثّل هذه السمة عنوان نتيجة البحث.
مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو عرض ويب داخل تطبيق
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "google_search_result".
معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.
McpServerToolCallDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "mcp_server_tool_call".
معرّف فريد لاستدعاء الأداة المحدّد هذا.
McpServerToolResultDelta
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "mcp_server_tool_result".
دلتا نتيجة استدعاء الأداة
معرّف يجب أن يتطابق مع المعرّف من وحدة استدعاء الدالة.
FileSearchResultDelta
result FileSearchResult (اختياري)
لم يتم تقديم أي وصف.
الحقول
تمثّل هذه السمة عنوان نتيجة البحث.
نص نتيجة البحث
تمثّل هذه السمة اسم متجر البحث عن الملفات.
يُستخدَم كمميّز نوع OpenAPI للمحتوى oneof.
يجب ضبطها دائمًا على "file_search_result".
ContentStop
لم يتم تقديم أي وصف.
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "content.stop".
الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.
ErrorEvent
لم يتم تقديم أي وصف.
يجب ضبطها دائمًا على "error".
error Error (اختياري)
لم يتم تقديم أي وصف.
الحقول
تمثّل هذه السمة معرّف الموارد المنتظم (URI) الذي يحدّد نوع الخطأ.
رسالة خطأ يمكن لشخص عادي قراءتها
الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.
أمثلة
بدء التفاعل
{ "event_type": "interaction.start", "interaction": { "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "model": "gemini-2.5-flash", "object": "interaction", "status": "in_progress" } }
اكتمل التفاعل
{ "event_type": "interaction.complete", "interaction": { "created": "2025-12-09T18:45:40Z", "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "model": "gemini-2.5-flash", "object": "interaction", "outputs": [ { "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh", "type": "thought" }, { "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save", "type": "text" }, { "text": " for one beloved anomaly: a chipped porcelain teacup, inherited from her grandmother, which held her morning Earl Grey.\n\nOne Tuesday, stirring her tea, Elara paused. At the bottom, nestled against the porcelain, was a star.", "type": "text" }, { "text": " Not a star-shaped tea leaf, but a miniature, perfectly formed celestial body, radiating a faint, cool luminescence. Before she could gasp, it dissolved, leaving only the amber swirl of her brew. She dismissed it as a trick of", "type": "text" }, { "text": " tired eyes.\n\nBut the next morning, a gossamer-thin feather, smaller than an eyelash and shimmering with iridescent hues, floated on the surface. It vanished the moment she tried to touch it. A week later, a single,", "type": "text" }, { "text": " impossibly delicate bloom, like spun moonbeam, unfolded in her cup before fading into nothingness.\n\nThese weren't illusions. Each day, Elara\u2019s chipped teacup offered a fleeting, exquisite secret. A tiny, perfect", "type": "text" }, { "text": " crystal, a miniature spiral nebula, a fragment of rainbow caught in liquid form. They never lingered, never accumulated, simply *were* and then *weren't*, leaving behind a residue of quiet wonder.\n\nElara never spoke", "type": "text" }, { "text": " of it. It was her private wellspring, a daily reminder that magic could exist in the smallest, most overlooked corners of the world. Her routine remained unchanged, her external life a picture of calm, but inside, a secret garden blo", "type": "text" }, { "text": "omed. Each dawn brought not just tea, but the silent promise of extraordinary beauty, waiting patiently in a chipped teacup.", "type": "text" } ], "role": "model", "status": "completed", "updated": "2025-12-09T18:45:40Z", "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 11 } ], "total_cached_tokens": 0, "total_input_tokens": 11, "total_output_tokens": 364, "total_reasoning_tokens": 1120, "total_tokens": 1495, "total_tool_use_tokens": 0 } } }
تعديل حالة التفاعل
{ "event_type": "interaction.status_update", "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "status": "in_progress" }
بداية المحتوى
{ "event_type": "content.start", "content": { "type": "text" }, "index": 1 }
Content Delta
{ "event_type": "content.delta", "delta": { "type": "text", "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save" }, "index": 1 }
إيقاف المحتوى
{ "event_type": "content.stop", "index": 1 }
حدث الخطأ
{ "event_type": "error", "error": { "message": "Failed to get completed interaction: Result not found.", "code": "not_found" } }