ویژگی‌های جدید Gemini 3.7 Flash

این صفحه همه مدل‌ها

Gemini 3.7 Flash ( gemini-3.7-flash ) به طور کلی در دسترس (GA) و آماده استفاده در محیط عملیاتی است. این مدل، هوشمندترین مدل ما برای کدنویسی و عامل‌ها است.

این راهنما موارد جدید در Gemini 3.7 Flash، تغییرات API، مثال‌های کد و راهنمای مهاجرت را توضیح می‌دهد.

مدل جدید

Gemini 3.7 Flash از یک پنجره زمینه ۱ میلیون توکن، حداکثر ۶۴ هزار توکن خروجی، سطوح تفکر قابل تنظیم ( low ، medium ، high ) و همان مجموعه ابزارهای داخلی Flash 3.6 پشتیبانی می‌کند.

برای مشخصات کامل، به صفحه مدل Gemini 3.7 Flash مراجعه کنید. برای قیمت‌گذاری دقیق، به صفحه قیمت‌گذاری مراجعه کنید.

شروع سریع

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Write a three.js script that renders a realistic 3D black hole."
)

print(interaction.output_text)

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  model: "gemini-3.7-flash",
  input: "Write a three.js script that renders a realistic 3D black hole.",
});

console.log(interaction.output_text);

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "model": "gemini-3.7-flash",
    "input": "Write a three.js script that renders a realistic 3D black hole."
  }'

ویژگی‌های جدید Gemini 3.7 Flash

• کدنویسی و وظایف عامل‌محور: کیفیت بسیار بالاتر در مهندسی نرم‌افزار دنیای واقعی و معیارهای عامل‌محور، بهبود حل مسئله و کاهش حلقه‌های ناموفق عامل‌محور.
• توسعه وب و برابری طراحی قوی‌تر: کد برنامه‌های دسکتاپ و وب با دقت بالاتر را مستقیماً از نمونه‌های طراحی تولید می‌کند، که پیشرفت‌های چشمگیری در پایبندی به طراحی و ممیزی پایگاه‌های کد موجود در برابر نمونه‌های آزمایشی برای تأیید برابری طراحی ۱:۱ دارد.
• قیمت‌گذاری تبلیغاتی: Gemini 3.7 Flash با قیمت مقدماتی 0.75 دلار برای هر 1 میلیون توکن ورودی و 3.75 دلار برای هر 1 میلیون توکن خروجی در دسترس خواهد بود. ما این نرخ جدید را برای 3.6 Flash نیز اعمال می‌کنیم. قیمت‌گذاری مقدماتی در 31 دسامبر 2026 منقضی می‌شود؛ پس از آن، 1.50 دلار برای هر 1 میلیون توکن ورودی و 7.50 دلار برای هر 1 میلیون توکن خروجی اعمال خواهد شد.

انتخاب مدل مناسب

برای بررسی اهداف مهاجرت توصیه‌شده برای حجم کاری خود، به جدول زیر مراجعه کنید. برای ارتقا از Gemini 3.5 Flash، Gemini 3 Flash (Preview) یا Gemini 3.1 Pro، مطمئن شوید که پارامترهای نمونه‌برداری منسوخ‌شده ( temperature ، top_p ، top_k ) و چرخش‌های مدل از پیش پر شده را حذف کرده‌اید. Gemini 3.6 Flash دیگر از این پارامترها پشتیبانی نمی‌کند.

درک سطوح استدلال

Gemini 3.7 Flash با تنظیم سطح تفکر مدل، به توسعه‌دهندگان کنترل انعطاف‌پذیری بر تأخیر و هوش می‌دهد:

• تلاش فکری کم : زمان پاسخگویی به وظایف حساس به تأخیر مانند خطوط لوله پاسخ به حوادث، چت در زمان واقعی، نوشتن پیش‌نویس‌ها و تجزیه و تحلیل سریع داده‌ها را کاهش می‌دهد.
• متوسط ​​(پیش‌فرض): بهترین کیفیت برای اکثر وظایف. برای کدهای پیچیده و موارد استفاده‌ی عاملی، با دقت بالاتر در اولین گام، توصیه می‌شود.

• تلاش فکری بالا : توانایی مدل را برای تفکر و استفاده از ابزارها به حداکثر می‌رساند. بهترین گزینه برای استدلال پیچیده، ریاضیات سخت و دشوارترین وظایف کدنویسی و عامل. امکان تفکرات گسترده و فراخوانی توابع را با مصرف توکن و هزینه بالاتر فراهم می‌کند.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    generation_config={
        "thinking_level": "medium"  # Balanced reasoning effort for complex tasks
    }
)

print(interaction.output_text)

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
  model: "gemini-3.7-flash",
  input: "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
  generation_config: {
    thinking_level: "medium"
  }
});

console.log(interaction.output_text);

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "model": "gemini-3.7-flash",
    "input": "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    "generation_config": {
      "thinking_level": "medium"
    }
  }'

عامل ضد جاذبه به‌روزرسانی شد

با توجه به عملکرد و منطق بهبود یافته، Gemini 3.7 Flash اکنون مدل پیش‌فرض جدیدی است که عامل Antigravity را در Gemini Managed Agents و Google Antigravity SDK پشتیبانی می‌کند.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input=(
        "Audit https://web.dev for performance, Core Web Vitals, and SEO. "
        "Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. "
        "Check search indexing with Google Search for site:web.dev. "
        "Format the output as a side-by-side scorecard table with prioritized fixes."
    ),
    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: "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
  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": "Audit https://web.dev for performance, Core Web Vitals, and SEO. Query Google'\''s PageSpeed Insights API for both Mobile and Desktop strategies. Check search indexing with Google Search for site:web.dev. Format the output as a side-by-side scorecard table with prioritized fixes.",
    "environment": "remote"
}'

مدل زیربنایی Gemini را می‌توان با استفاده از agent_config پیکربندی کرد.

چک لیست مهاجرت

  `/gemini-interactions-api migrate my app to Gemini 3.7 Flash`

مهاجرت به gemini-3.7-flash

• به‌روزرسانی شناسه مدل: رشته مدل هدف خود را به gemini-3.7-flash تغییر دهید.
• پارامترهای نمونه‌برداری منسوخ‌شده را حذف کنید:
  • temperature ، top_p و top_k را از پیکربندی‌های تولید جدا کنید.
  • به جای thinking_budget عبارت رشته‌ای enum thinking_level قرار دهید.
  • حذف candidate_count (در Gemini 3.x پشتیبانی نمی‌شود).
• قوانین اعتبارسنجی نوبت را اجرا کنید:
  • استانداردسازی مکالمات چند نوبتی در سمت سرور previous_interaction_id .
  • چرخش‌های مدل از پیش پر شده را بردارید.
• فراخوانی تابع حسابرسی:
  • دارایی‌های چندوجهی را درون بار داده پاسخ قرار دهید.
  • دستورالعمل‌های درون‌خطی را با استفاده از \n\n قالب‌بندی کنید.
  • اگر خطاهای Malformed_Function_Call مرتبط با متن پیش از ابزار را مشاهده کردید، برای الزامات متن پیش از ابزار به راه‌حل‌ها مراجعه کنید.
  • فقط در صورت استفاده از generateContent API: مطمئن شوید که همه اشیاء FunctionResponse شامل call_id و name باشند.
• الزامات پایه Gemini 3.x: برای به‌روزرسانی‌های SDK و حفظ امضای فکری، به چک‌لیست مهاجرت Gemini 3.5 مراجعه کنید.

قیمت‌گذاری

قیمت‌گذاری مقدماتی برای هر دو نسخه Gemini 3.7 Flash و Gemini 3.6 Flash در Google AI Studio و Gemini Enterprise Agent Platform تا 31 دسامبر 2026 اعمال می‌شود. از اول ژانویه 2027، قیمت‌گذاری استاندارد اعمال خواهد شد. برای جزئیات بیشتر، لطفاً به صفحه قیمت‌گذاری مراجعه کنید.

مراحل بعدی

• مشخصات API را در نمای کلی مدل‌ها مرور کنید.
• هماهنگی چندعاملی را در راهنمای API تعاملات بررسی کنید.
• دستورالعمل‌ها را در Google AI Studio آزمایش و اصلاح کنید.