Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Panduan developer untuk Gemini 3.8 Flash

Gemini 3.8 Flash adalah model andalan kami yang paling cerdas, yang memberikan peningkatan signifikan dari 3.7 Flash di berbagai bidang, seperti rekayasa software, tugas agentic, dan penalaran multi-langkah yang penting dalam domain khusus. 3.8 Flash memberikan peningkatan yang signifikan dari 3.7 Flash, sering kali mendekati performa model termutakhir yang lebih mahal.

Dokumen ini membahas hal-hal baru di 3.8 Flash, kesesuaiannya dalam rangkaian model Gemini, cara bermigrasi ke 3.8 Flash, dan memberikan panduan memulai untuk menggunakan 3.8 Flash.

Bagaimana posisinya dalam rangkaian model Gemini?

Lini Gemini Flash adalah model andalan utama untuk agen dalam keluarga Gemini 3, yang menjembatani kesenjangan antara model Gemini Pro dengan penalaran mendalam dan model Gemini Flash-Lite dengan throughput tinggi, sekaligus memberikan efisiensi token yang tinggi dan pemrosesan multimodal multi-langkah.

Dibandingkan dengan 3.7 Flash, 3.8 Flash memberikan akurasi yang lebih baik dan performa yang lebih andal, tetapi dengan konsumsi token yang lebih tinggi. Namun, 3.8 Flash juga dilengkapi dengan kontrol upaya melalui tingkat pemikiran agar Anda dapat mengatur konsumsi ini. Pada tingkat penalaran sedang, Anda masih dapat menyelesaikan tugas agen yang kompleks sekaligus mengurangi konsumsi token. Anda juga dapat menggunakan tingkat penalaran yang lebih rendah untuk tugas yang sensitif terhadap latensi guna menghindari overhead komputasi sepenuhnya. Jika Anda ingin mengoptimalkan efisiensi komputasi, pertimbangkan untuk menggunakan 3.7 Flash.

Spesifikasi dan perbandingan model

Tabel berikut adalah perbandingan yang mencakup beberapa spesifikasi antara 3.8 Flash, 3.7 Flash, dan 3.1 Pro:

	Gemini 3.8 Flash	Gemini 3.7 Flash	Gemini 3.1 Pro
ID Model	`gemini-3.8-flash`	`gemini-3.7-flash`	`gemini-3.1-pro-preview`
Tahap peluncuran	GA	GA	Pratinjau
Jenis input	Teks, Gambar, Audio, Video	Teks, Gambar, Audio, Video	Teks, Gambar, Audio, Video
Jenis output	Teks	Teks	Teks
Jendela konteks	1.048.576	1.048.576	1.048.576
Panjang token output maksimum	65.536	65.536	65.536
Region yang didukung	Global, Multi-region	Global, Multi-region	Global
Tingkat penalaran yang didukung	`LOW`, `MEDIUM`, `HIGH` (Default: `MEDIUM`)	`LOW`, `MEDIUM`, `HIGH` (Default: `MEDIUM`)	`LOW`, `MEDIUM`, `HIGH` (Default: `HIGH`)
Fokus utama	Alur kerja agentic, coding, pemahaman video interaktif	Agentic Workflows umum, orkestrasi multilangkah, coding	Tugas dengan penalaran mendalam dan kompleksitas tinggi

Lihat halaman model 3.8 Flash untuk mengetahui daftar lengkap kemampuan, alat, dan opsi konsumsi yang didukung.

Apa yang baru di Gemini 3.8 Flash?

Tabel berikut membandingkan tolok ukur evaluasi developer standar antara Gemini 3.8 Flash dan 3.7 Flash:

Tolok ukur evaluasi	3.8 Flash	3.7 Flash
Terminal-bench 2.1	90,8%	81,6%
SWE-Bench Pro	61,6%	60,4%
SWE-Atlas	51,9%	48,0%
τ³-bench Banking	38,1%	30,9%
CharXiv (Multimodal)	86,2%	84,5%
GDP.pdf	35,0%	34,0%
Humanity's Last Exam (HLE)	45,4%	45,7%

Panduan Memulai

Sebelum memulai, Anda harus melakukan autentikasi ke Agent Platform menggunakan Kredensial Default Aplikasi (ADC) atau kunci API. Lihat Mulai menggunakan Gemini Enterprise Agent Platform untuk informasi selengkapnya.

Dalam blok kode berikut, ganti PROJECT_ID dengan project ID Anda.

Penginstalan

Pastikan Anda menggunakan google-genai SDK terbaru:

pip install --upgrade google-genai

Permintaan dasar

Python

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.8-flash",
  contents="How does AI work?",
)
print(response.text)

REST

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.8-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Aturan API dan konvensi perilaku wajib

Gemini 3.8 Flash menerapkan konvensi API standar rangkaian Gemini 3 berikut secara ketat:

Parameter sampling yang tidak digunakan lagi (temperature, top_k, top_p): Parameter ini diabaikan oleh backend. Sebagai gantinya, Anda dapat mengontrol determinisme menggunakan thinking_level (LOW, MEDIUM, HIGH) dan response_schema atau json_schema.
Parameter yang tidak didukung (frequency_penalty, presence_penalty, candidate_count): Meneruskan frequency_penalty, presence_penalty, atau candidate_count akan menampilkan error API aktif. Hapus dari kode klien lama.
Aturan panggilan fungsi yang ketat: Giliran FunctionResponse harus benar-benar cocok dengan id, name, dan jumlah eksekusi FunctionCall sebelumnya.
- Aset multimodal: Selalu tempatkan aset multimodal di dalam payload respons.
- Pemformatan dan teks pra-alat: Format petunjuk inline menggunakan \n\n. Jika Anda mengalami error Malformed_Function_Call yang terkait dengan teks pra-alat, bersihkan komentar di awal sebelum panggilan alat.
- Untuk meneruskan catatan kerja sementara atau pembaruan status sebelum panggilan alat, gabungkan dalam panggilan fungsi update() khusus, bukan memunculkan XML atau teks mentah:
```
{
  "name": "update",
  "description": "Update working notes before tool execution",
  "parameters": {
    "type": "OBJECT",
    "properties": {
      "previous_step": {"type": "STRING"},
      "plan": {"type": "STRING"},
      "next_step": {"type": "STRING"}
    },
    "required": ["previous_step", "plan", "next_step"]
  }
}
```
Validasi urutan chat:
- Payload histori tidak boleh diakhiri dengan giliran peran "model".
- Respons model yang telah disiapkan tidak didukung dan harus dihapus saat mengupgrade.
- Giliran kosong dalam histori percakapan akan otomatis dihapus atau akan menghasilkan error validasi.

3.8 Flash dari 3.7 Flash atau 3.6 Flash

Untuk bermigrasi ke 3.8 Flash dari 3.7 Flash atau 3.6 Flash, lakukan langkah-langkah berikut:

Perbarui ID model: Ubah string model dalam panggilan API Anda menjadi gemini-3.8-flash.
Ganti parameter anggaran penalaran: Ganti konfigurasi thinking_budget bilangan bulat dengan enum string thinking_level yang ditetapkan ke salah satu nilai berikut:
- HIGH: Direkomendasikan untuk QA visual yang padat, deteksi gerakan dalam hitungan detik (olahraga, pengeditan), atau penalaran multi-langkah di video berdurasi 60+ menit.
- MEDIUM: Tingkat penalaran default. Tingkat ini memberikan keseimbangan optimal untuk Tanya Jawab video umum, ringkasan materi, dan pengambilan klip.
- LOW: Direkomendasikan untuk tugas seperti penelusuran cepat yang berfokus pada transkrip atau ekstraksi metadata dasar.
Menghapus parameter yang tidak digunakan lagi dan tidak didukung:
- Menghapus temperature, top_p, dan top_k.
- Menghapus candidate_count, frequency_penalty, dan presence_penalty.
- Hapus semua respons model yang telah disiapkan dari histori percakapan.

Checklist ringkasan untuk developer

ID model target: gemini-3.8-flash

Gunakan thinking_level (MEDIUM secara default; nilai yang valid: LOW, MEDIUM, HIGH) sebagai ganti kolom thinking_budget atau temperature yang tidak digunakan lagi. MINIMAL tidak didukung untuk model ini.

Hapus parameter yang tidak didukung berikut: frequency_penalty, presence_penalty, candidate_count, temperature, top_p, dan top_k.

Hapus semua respons model yang telah disiapkan dari histori permintaan multi-turn chat.

Pastikan pencocokan FunctionResponse yang ketat (id atau call_id dan name) dan format petunjuk pra-alat dengan \n\n.