Panduan developer untuk Gemini 3.8 Flash

Gemini 3.8 Flash adalah model andalan kami yang paling cerdas, yang menghadirkan peningkatan signifikan dari 3.7 Flash di seluruh teknik software, tugas agen, dan penalaran multi-langkah yang penting di domain khusus. 3.8 Flash memberikan peningkatan substansial dari 3.7 Flash, yang sering kali mendekati performa model termutakhir yang lebih mahal.

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

Bagaimana kesesuaiannya dalam keluarga Gemini?

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

Dibandingkan dengan 3.7 Flash, 3.8 Flash memberikan akurasi yang lebih baik dan performa yang lebih andal dengan biaya konsumsi token yang lebih tinggi. Namun, 3.8 Flash juga dilengkapi dengan kontrol upaya melalui tingkat penalaran agar Anda dapat memodulasi 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 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:

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:

Panduan memulai

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

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

Penginstalan

Pastikan Anda menggunakan SDK google-genai terbaru:

pip install --upgrade google-genai

Permintaan dasar

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)

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 secara ketat menerapkan konvensi API keluarga Gemini 3 standar berikut:

• Parameter pengambilan sampel 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 parameter tersebut dari kode klien lama.

• Aturan panggilan fungsi yang ketat: Giliran FunctionResponse harus 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, hapus komentar utama sebelum panggilan alat.

  • Untuk meneruskan catatan kerja atau update status sementara sebelum panggilan alat, sertakan dalam panggilan fungsi update() khusus, bukan menampilkan 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".
  • Giliran model yang telah diisi sebelumnya tidak didukung dan harus dihapus saat mengupgrade.
  • Giliran kosong dalam histori percakapan akan otomatis dihilangkan 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:

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

Checklist ringkasan untuk developer

Referensi lainnya

• Halaman model Gemini 3.8 Flash
• Notebook pengantar