Dalam catatan rilis Gemini API tertanggal 2 November 2026, Google menandai gemini-2.5-pro dan gemini-2.5-flash sebagai deprecated. Kalau aplikasimu masih memanggil salah satunya lewat Gemini Developer API (kunci AI Studio), mulai 1 Desember 2026 request akan otomatis dijawab model lain dan ditagih dengan tarif model pengganti. Waktunya sekitar tiga minggu, cukup untuk uji tanpa terburu-buru.

Apa yang Berubah

Menurut halaman deprecations Google, pemetaannya begini:

  • gemini-2.5-pro dialihkan ke gemini-3.8-flash.
  • gemini-2.5-flash dialihkan ke gemini-3.5-flash-lite.
  • gemini-2.5-flash-lite tidak termasuk deprecated dan tetap tersedia sampai pemberitahuan lebih lanjut.
  • Kedua model yang dialihkan sudah tidak bisa dipilih di AI Studio, dan akses API dibatasi untuk pengguna yang sudah memakainya.

Soal harga, halaman harga Google (tier berbayar, per 1 juta token) menyebut Gemini 3.8 Flash di $0,75 untuk input dan $3,75 untuk output sampai 31 Desember 2026, lalu naik menjadi $1,50 dan $7,50 mulai 1 Januari 2027. Gemini 3.5 Flash-Lite tercatat $0,30 input dan $2,50 output tanpa tarif perkenalan. Sebagai pembanding, 2.5 Pro tercatat $1,25 input dan $10,00 output pada prompt sampai 200 ribu token. Artinya tagihan bisa turun lalu berubah arah di 2027, jadi hitung ulang untuk pola pemakaianmu. Aipolix (3 November) memuat ringkasan yang cocok dengan angka ini.

Yang lebih penting adalah perubahan API di panduan migrasi Google:

  • thinking_budget diganti thinking_level. Pada 3.8 Flash nilainya low, medium (default), atau high. Nilai minimal tidak didukung dan menghasilkan error, sedangkan 3.5 Flash-Lite menerima minimal, medium, dan high.
  • Parameter temperature, top_p, top_k, dan candidate_count harus dihapus. Panduan 3.6 menyebut API akan mengembalikan error untuk parameter sampling pada generasi model berikutnya.
  • Prefilled model turn (giliran terakhir berupa pesan model) menghasilkan HTTP 400. Gunakan system_instruction atau structured output.
  • Function calling: setiap FunctionResponse harus menyertakan call_id dan name, dan thought signature harus dipertahankan.
  • Untuk percakapan multi-turn, Google menyarankan previous_interaction_id di sisi server.

Catatan: halaman Google yang saya baca tidak menjelaskan nasib Vertex AI. Sebuah blog vendor (EvalShift) menyebut Vertex punya jadwal pensiun sendiri tanpa reroute otomatis, tapi saya tidak bisa memverifikasinya, jadi cek dokumentasi Vertex jika kamu memakainya.

Dampaknya untuk Kamu

Developer. Reroute otomatis bukan berarti aman. Kode yang mengirim temperature, thinking_budget, atau prefill bisa mulai gagal, dan perilaku jawaban berubah karena modelnya berbeda. Chatbot, ekstraksi dokumen, atau fitur ringkasan di produkmu bisa terdampak.

Pemilik bisnis dan startup. Tagihan API ikut berubah mengikuti tarif model pengganti. Mintalah tim memproyeksikan biaya Desember dan Januari.

Yang Perlu Dilakukan

  • Cari semua ID model gemini-2.5-pro dan gemini-2.5-flash di kode, konfigurasi, dan environment variable.
  • Tentukan modelnya sendiri, jangan menunggu reroute: gemini-3.8-flash untuk pengganti Pro, gemini-3.5-flash-lite untuk pengganti Flash. Sematkan versi, bukan alias -latest.
  • Ganti thinking_budget ke thinking_level, dan jangan pakai minimal pada 3.8 Flash.
  • Hapus parameter sampling, candidate_count, dan prefill.
  • Perbarui SDK, pastikan call_id, name, dan thought signature terkirim kembali apa adanya.
  • Replay sampel trafik produksi dan bandingkan hasil (JSON, pemanggilan tool) sebelum cutover. Deploy per fitur dengan rencana rollback.
  • Catat versi model yang dipakai di log tiap request supaya perubahan biaya dan kualitas mudah dilacak.
  • Hitung ulang anggaran dengan tarif 3.8 Flash sebelum dan sesudah 1 Januari 2027.

Sumber