استخدام أحدث نماذج Gemini

هذه الصفحة 3.5 Flash

يتوفّر كل من Gemini 3.6 Flash (gemini-3.6-flash) وGemini 3.5 Flash-Lite (gemini-3.5-flash-lite) للجمهور العام وهما جاهزان للاستخدام في مرحلة الإنتاج.

• Gemini 3.6 Flash: أداء أفضل في المهام المعقّدة التي تتضمّن وكلاء ونماذج متعددة الوسائط، مع تقليل استخدام الرموز المميزة، وبسعر أقل من 3.5 Flash.
• ‫Gemini 3.5 Flash-Lite: هو أسرع نموذج وأقل تكلفة في عائلة 3.5. تتفوق على الأجيال السابقة من Flash-Lite في التنفيذ العالي الإنتاجية.

يوضّح هذا الدليل الميزات الجديدة في كل نموذج، والتغييرات في واجهة برمجة التطبيقات التي تؤثّر في الرمز البرمجي، وكيفية نقل البيانات.

نماذج جديدة

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

للاطّلاع على المواصفات الكاملة، يُرجى الانتقال إلى صفحات الطُرز:

• صفحة نموذج Gemini 3.6 Flash
• صفحة نموذج Gemini 3.5 Flash-Lite

للاطّلاع على الأسعار التفصيلية، يُرجى الانتقال إلى صفحة الأسعار.

البدء السريع

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Write a three.js script that renders an interactive 3D robot.",
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.6-flash",
    contents: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(response.text);
}

main();

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
    }]
  }'

الميزات الجديدة في Gemini 3.6 Flash

• تقليل عدد الرموز المميزة وعدد الردود: يكمل هذا النموذج مهام سير العمل المتعددة الخطوات بعدد أقل من خطوات الاستدلال والردود في المحادثة واستخدام الأدوات مقارنةً بـ Gemini 3.5. ويقلّل أيضًا من تكرار حلقات التنفيذ.
• تحسين عملية إنشاء الرموز البرمجية: إنشاء رموز برمجية جاهزة للاستخدام في الإنتاج بجودة أعلى مع تقليل التعديلات غير المرغوب فيها وحلقات تصحيح الأخطاء.
• اتّباع التعليمات بشكل أفضل: يقلّل من التغييرات غير المرغوب فيها في الملفات أثناء مهام التشخيص.
• قدرات قوية في الاستدلال المكاني والمتعدد الوسائط: تحسين الأداء في تفسير الرسوم البيانية وتحويل المخططات المرئية وإنشاء تخطيطات ويب متعددة العناصر
• الفحص الآلي المسبق: يفضّل تشغيل نصوص برمجية لتشخيص الأخطاء قبل إجراء التغييرات بشكل متكرّر أكثر من Gemini 3.5 Flash. يؤدي ذلك إلى تحسين الدقة في المهام المعقّدة، ولكن يمكن أن يضيف خطوات استكشافية إضافية في مهام الواجهة الأمامية البسيطة.
• دعم استخدام الكمبيوتر: يتم توفير هذه الميزة كأداة أصلية لأتمتة واجهة المستخدم المستقلة.
• تفضيل تصميم واجهة المستخدِم: أفضل في إنشاء رمز برمجي عملي، على الرغم من أنّ المقيّمين البشريين فضّلوا النماذج السابقة من حيث التصميم والتنسيق المرئيين. يمكنك الحدّ من ذلك من خلال تقديم إرشادات تصميم واضحة.
• مستوى التفكير التلقائي (متوسط): يستخدم مستوى التفكير التلقائي medium نفسه الذي يستخدمه Gemini 3.5 Flash.
• الأسعار المخفَّضة: انخفاض تكاليف رموز الإخراج (7.50 دولار أمريكي لكل مليون رمز مقارنةً بـ 9.00 دولار أمريكي لكل مليون رمز في الإصدار 3.5 Flash). تبقى تكلفة الرموز المميّزة المدخَلة 1.50 دولار أمريكي لكل مليون رمز.

الميزات الجديدة في Gemini 3.5 Flash-Lite

• وقت استجابة أقل لتنفيذ المهام: أعلى سرعة معالجة بيانات في السلسلة 3.5 لتحليل البيانات الكبيرة واستخراج المستندات.
• أداء محسّن في الاستدلال والوسائط المتعددة: مسار نقل بيانات قوي من Gemini 2.5 Flash، مع تحقيق نتائج أعلى في مهام الاستدلال، مثل HLE (‏18.0% مقارنةً بـ 11.0%)، ومعايير الأداء المتعدد الوسائط، مثل CharXIV (‏74.5% مقارنةً بـ 63.7%).
• تنظيم الوكلاء الفرعيين وموثوقية الأدوات: تحسين موثوقية تنفيذ الأدوات في ما يتعلّق بتنفيذ الرموز البرمجية والبحث وسير عمل MCP زيادة مستوى التفكير في التخطيط المستقل ومهام الوكيل الفرعي المعقّدة
• تحسين فهم المستندات: تحسين دقة تحليل المستندات واستخراج البيانات المنظَّمة جرِّب مستويات التفكير المنخفضة والعالية حسب درجة تعقيد المستند.
• ترميز الويب التفاعلي ومعالجة البيانات الجدولية: يحقّق أداءً قويًا في JavaScript للواجهة الأمامية ومعالجة البيانات الجدولية من خلال التخطيط عبر تنفيذ الرموز البرمجية البسيطة.
• الاحتفاظ بروبوت الدردشة والشخصية: إمكانية أفضل في اتّباع التعليمات في المحادثات المترابطة والحفاظ على اتساق الشخصية مقارنةً بنموذج Gemini 3.1 Flash-Lite.
• دعم استخدام الكمبيوتر: يتم توفير هذه الميزة كأداة أصلية لأتمتة واجهة المستخدم المستقلة.

اختيار نموذج Flash أو Flash-Lite المناسب

استخدِم هذا الجدول لاختيار النموذج ومسار نقل البيانات المناسبَين لأحمال العمل.

يتطلّب كلا النموذجين إزالة مَعلمات أخذ العيّنات المتوقّفة نهائيًا (temperature وtop_p وtop_k) والجُمل النموذجية المُعبّأة مسبقًا. لمزيد من التفاصيل، يُرجى الاطّلاع على التغييرات في واجهة برمجة التطبيقات.

وكيل Antigravity المعدَّل

بفضل أدائه المحسّن، أصبح Gemini 3.6 Flash الآن النموذج الأساسي الجديد الذي يشغّل وكيل Antigravity في الوكلاء المُدارون في Gemini. يمكن تغيير ذلك من خلال ضبط حقل جديد في واجهة برمجة التطبيقات.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

التغييرات في واجهة برمجة التطبيقات وتعديلات المَعلمات

بدءًا من Gemini 3.6 Flash وGemini 3.5 Flash-Lite، تنطبق تغييرات واجهة برمجة التطبيقات التالية على هذين النموذجين وجميع إصدارات نماذج Gemini المستقبلية.

• إيقاف مَعلمات أخذ العيّنات نهائيًا: تم إيقاف temperature وtop_p وtop_k نهائيًا. تتجاهل واجهة برمجة التطبيقات هذه المَعلمات وتعرض خطأً في عمليات إنشاء النماذج المستقبلية.
• التحقّق من صحة الردود الجاهزة: لم يعُد من الممكن ملء الردود الجاهزة مسبقًا. إذا كانت آخر محادثة غير فارغة في الطلب هي محادثة model، ستعرض واجهة برمجة التطبيقات الخطأ 400.

في ما يلي توضيحات مفصّلة وعيّنات من الرموز البرمجية لكل تغيير في واجهة برمجة التطبيقات.

1. إيقاف مَعلمات أخذ العيّنات نهائيًا (temperature وtop_p وtop_k)

تم إيقاف temperature وtop_p وtop_k نهائيًا وسيتم تجاهلها. في الأجيال المستقبلية من النماذج، سيؤدي تقديم هذه المَعلمات إلى عرض الخطأ HTTP 400. إزالة هذه المَعلمات من جميع الطلبات

# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

لتحسين الحتمية، حدِّد تعليمات نظام تتضمّن قواعد واضحة لحالة الاستخدام المحدّدة.

2. التحقّق من صحة الردود الجاهزة

يُحظر إرسال طلبات إلى واجهة برمجة التطبيقات تنتهي بدور نموذج غير فارغ، ويتم عرض الخطأ HTTP 400.

⚠️ تجنَّب

في حمولات REST القديمة generateContent أو حمولات REST الأولية، لم يعُد مسموحًا أن تنتهي حمولة REST بدور النموذج كما يلي:

/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}

✅ عملية نقل البيانات المقترَحة

إذا كان تطبيقك يملأ نموذجًا مسبقًا لإخفاء المقدمات أو فرض تنسيق JSON، استخدِم system_instruction أو النتائج المنظَّمة بدلاً من ذلك.

# ✅ RECOMMENDED: Use system_instruction to specify output format
response = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Translate 'Hello world' to Spanish.",
    config={"system_instruction": "Output only the translation without introductory text."},
)

قائمة التحقّق الخاصة بعملية نقل البيانات

نقل البيانات إلى gemini-3.6-flash

• تعديل رقم تعريف النموذج: غيِّر سلسلة النموذج المستهدَف إلى gemini-3.6-flash.
• إزالة مَعلمات أخذ العيّنات المتوقّفة نهائيًا:
  • إزالة temperature وtop_p وtop_k من إعدادات الإنشاء
  • استبدِل thinking_budget بسلسلة التعداد thinking_level التي تم ضبطها على "medium" أو "high".
  • إزالة candidate_count (غير متوافق مع الإصدار 3.x من Gemini)
• فرض قواعد التحقّق من صحة الأرقام:
  • إزالة الردود النموذجية المُعبّأة مسبقًا
  • تأكَّد من أنّ رد المستخدم النهائي يحتوي على نص غير فارغ.
• تدقيق استدعاء الدوال:
  • تأكَّد من أنّ جميع عناصر FunctionResponse تتضمّن call_id وname.
  • ضَع مواد العرض المتعدّدة الوسائط داخل حمولة الردّ.
  • يمكنك تنسيق التعليمات المضمّنة باستخدام \\n\\n.
  • إذا ظهرت لك أخطاء Malformed_Function_Call مرتبطة بنص ما قبل الأداة، اطّلِع على حلول بديلة لمتطلبات نص ما قبل الأداة.
• متطلبات Baseline Gemini 3.x: للاطّلاع على تحديثات حزمة تطوير البرامج (SDK) والحفاظ على توقيع الفكرة، يُرجى الرجوع إلى قائمة التحقّق من عملية نقل البيانات إلى Gemini 3.5.

نقل البيانات إلى gemini-3.5-flash-lite

• تعديل رقم تعريف النموذج: غيِّر سلسلة النموذج المستهدَف إلى gemini-3.5-flash-lite.
• ضبط مستوى مجهود التفكير:
  • بالنسبة إلى الاستخراج أو التوجيه أو التصنيف بكميات كبيرة: اترك القيمة thinking_level عند "minimal" (الإعداد التلقائي) لتحقيق الحد الأقصى من سرعة معالجة البيانات.
  • بالنسبة إلى الوكلاء الفرعيين المستقلين الذين يستخدمون طلبات الأدوات أو تطبيق الرموز البرمجية أو الاستدلال المتعدّد الخطوات، اضبط قيمة thinking_level على "medium" أو "high" لمنع إنهاء الأداة قبل الأوان.
• إزالة المَعلمات المتوقّفة نهائيًا والتحقّق من صحة استدعاء الدوال: طبِّق القواعد نفسها المتّبعة في الإصدار 3.6 من Flash.
• متطلبات الإصدار الأساسي من Gemini 3.x: يُرجى الرجوع إلى قائمة التحقّق من نقل البيانات إلى Gemini 3.5.

الخطوات التالية

• راجِع مواصفات واجهة برمجة التطبيقات في نظرة عامة على النماذج.
• استكشِف عملية التنسيق بين عدة وكلاء في دليل Interactions API.
• اختبار الطلبات وتحسينها في Google AI Studio