Gemini 3.8 Flash ( gemini-3.8-flash ) به طور کلی در دسترس (GA) و آماده استفاده در محیط عملیاتی است. این هوشمندترین مدل Flash ما است که برای مهندسی نرمافزار بلندمدت، عاملهای خودگردان و گردشهای کاری پیچیده سازمانی مهندسی شده است.
این راهنما موارد جدید در Gemini 3.8 Flash، تغییرات API، مثالهای کد و راهنمای مهاجرت را توضیح میدهد.
مدل جدید
| مدل | شناسه مدل | سطح تفکر پیشفرض | قیمتگذاری | توضیحات |
|---|---|---|---|---|
| فلش جمینی ۳.۸ | gemini-3.8-flash | medium | فلش ۳.۸ تا پایان سال با قیمت مقدماتی ۰.۷۵ دلار برای هر ۱ میلیون توکن ورودی و ۳.۷۵ دلار برای هر ۱ میلیون توکن خروجی در دسترس است؛ برای جزئیات بیشتر به قیمتگذاری مراجعه کنید. | هوشمندترین مدل فلش ما، که برای مهندسی نرمافزار بلندمدت، عاملهای خودگردان و گردشهای کاری پیچیده سازمانی مهندسی شده است. |
Gemini 3.8 Flash از یک پنجره زمینه ۱ میلیون توکن، حداکثر ۶۴ هزار توکن خروجی، سطوح تفکر قابل تنظیم ( low ، medium ، high ) و همان مجموعه جامع از ابزارهای داخلی پشتیبانی میکند.
برای مشخصات کامل، به صفحه مدل Gemini 3.8 Flash مراجعه کنید. برای جزئیات قیمتگذاری مقدماتی، به بخش قیمتگذاری در زیر یا صفحه قیمتگذاری مراجعه کنید.
شروع سریع
پایتون
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-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.8-flash",
input: "Write a three.js script that renders a realistic 3D black hole.",
});
console.log(interaction.output_text);
جاوا
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.8-flash"))
.input(InteractionsInput.of("Hello world"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
استراحت
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.8-flash",
"input": "Write a three.js script that renders a realistic 3D black hole."
}'
ویژگیهای جدید Gemini 3.8 Flash
- مهندسی نرمافزار با افق بلندمدت: نتایج قوی در معیارهای کدنویسی دنیای واقعی، بازسازی پیچیده چند فایلی و اجرای قطعی ابزار ارائه میدهد. برای جزئیات بیشتر به روش ارزیابی مراجعه کنید.
- عاملهای خودمختار: به شما امکان میدهد برنامهریزی چند مرحلهای انعطافپذیر و گردشهای کاری هماهنگسازی ابزار را ایجاد کنید و به طور قابل توجهی حلقههای ناموفق و خطاها را کاهش دهید.
- گردشهای کاری پیچیده سازمانی: دقت برتر، استدلال عمیق و دقت بالای مبتنی بر واقعیت را در وظایف دامنههای دشوار و خطوط داده در مقیاس بزرگ ارائه میدهد.
- مدل پیشفرض برای عاملهای مدیریتشده: عامل پیشفرض برای عاملهای مدیریتشده: عامل Antigravity ، اکنون از Gemini 3.8 Flash استفاده میکند. Antigravity SDK نیز بهطور پیشفرض از Gemini 3.8 Flash استفاده میکند.
- قیمتگذاری مقدماتی: Gemini 3.8 Flash با نرخ مقدماتی 0.75 دلار برای هر 1 میلیون توکن ورودی و 3.75 دلار برای هر 1 میلیون توکن خروجی تا 31 دسامبر 2026 در دسترس است. قیمتگذاری استاندارد 1.50 دلار برای هر 1 میلیون توکن ورودی و 7.50 دلار برای هر 1 میلیون توکن خروجی از اول ژانویه 2027 اعمال میشود.
Gemini 3.8 Flash به طور خاص میتواند در وظایف طولانیتر و پیچیدهتر از توکنهای بیشتری استفاده کند. برای ارائه نتایج با کیفیت بالاتر در اهداف دشوار و چند مرحلهای، این مدل مراحل استدلال کوچکتری را در نظر میگیرد، ابزارها را به صورت تکراری فراخوانی میکند و کار خود را در طول مسیر تأیید میکند. هر گردش کاری به این سطح از تأیید نیاز ندارد. برای وظایف روزمره، میتوانید تلاش استدلال را برای کاهش مصرف توکن کاهش دهید. از طرف دیگر، Gemini 3.7 Flash همچنان به طور کامل پشتیبانی میشود.
درک سطوح استدلال
Gemini 3.8 Flash با تنظیم سطح تفکر مدل، کنترل انعطافپذیری بر تأخیر و هوش به شما میدهد:
- نیاز کم به تفکر : زمان پاسخگویی به وظایف حساس به تأخیر مانند خطوط لوله پاسخ به حوادث، چت در لحظه، نوشتن پیشنویس و تجزیه و تحلیل سریع دادهها را کاهش میدهد.
- متوسط (پیشفرض): بهترین کیفیت برای اکثر وظایف. برای کدهای پیچیده و موارد استفادهی عاملی توصیه میشود و دقت بالاتری در اولین گام ارائه میدهد.
- تلاش فکری بالا : قابلیتهای استدلال و هماهنگسازی ابزار مدل را به حداکثر میرساند. بهترین گزینه برای استدلال عمیق، ریاضیات و وظایف چند مرحلهای دشوار.
مثال زیر، thinking_level برای یک درخواست تحلیل کد پیچیده، روی medium تنظیم میکند:
پایتون
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-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.8-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);
جاوا
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.8-flash"))
.input(InteractionsInput.of("Hello world"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
استراحت
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.8-flash",
"input": "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
"generation_config": {
"thinking_level": "medium"
}
}'
عامل ضد جاذبه بهروزرسانی شد
با توجه به عملکرد و استدلال بهبود یافته، عامل Antigravity در Gemini Managed Agents اکنون به طور پیشفرض با Gemini 3.8 Flash ساخته شده است.
پایتون
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);
جاوا
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.8-flash"))
.input(InteractionsInput.of("Hello world"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
استراحت
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-api-dev migrate my app to Gemini 3.8 Flash`
مهاجرت به gemini-3.8-flash
- بهروزرسانی شناسه مدل: رشته مدل هدف خود را به
gemini-3.8-flashتغییر دهید. - پارامترهای نمونهبرداری منسوخشده را حذف کنید:
-
temperature،top_pوtop_kرا از پیکربندیهای تولید جدا کنید. - به جای
thinking_budgetعبارت رشتهای enumthinking_levelقرار دهید. توجه داشته باشید کهminimalدر فلش نسخه ۳.۸ پشتیبانی نمیشود. - حذف
candidate_count(در Gemini 3 و بعد از آن پشتیبانی نمیشود).
-
- قوانین اعتبارسنجی نوبت را اجرا کنید:
- استانداردسازی مکالمات چند نوبتی در سمت سرور
previous_interaction_id. - چرخشهای مدل از پیش پر شده را بردارید.
- استانداردسازی مکالمات چند نوبتی در سمت سرور
- فراخوانی تابع حسابرسی:
- داراییهای چندوجهی را درون بار داده پاسخ قرار دهید.
- دستورالعملهای درونخطی را با استفاده از
\n\nقالببندی کنید. - اگر خطاهای
Malformed_Function_Callمرتبط با متن پیش از ابزار را مشاهده کردید، برای الزامات متن پیش از ابزار به راهحلها مراجعه کنید. - فقط در صورت استفاده از generateContent API: مطمئن شوید که همه اشیاء
FunctionResponseشاملcall_idوnameباشند.
- الزامات پایه Gemini 3: برای بهروزرسانیهای SDK و حفظ امضای فکری، به چکلیست مهاجرت Gemini 3.5 مراجعه کنید.
قیمتگذاری
از قیمتهای مقدماتی در سراسر Google AI Studio و Gemini Enterprise Agent Platform تا 31 دسامبر 2026 برای Gemini 3.8 Flash، Gemini 3.7 Flash و Gemini 3.6 Flash بهرهمند شوید. قیمتهای استاندارد از 1 ژانویه 2027 اعمال میشود. برای مشاهدهی سطوح کامل قیمتگذاری، به صفحهی قیمتگذاری مراجعه کنید.
مراحل بعدی
- مشخصات API را در نمای کلی مدلها مرور کنید.
- هماهنگی چندعاملی را در مرور کلی API تعاملات بررسی کنید.
- دستورالعملها را در Google AI Studio آزمایش و اصلاح کنید.