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-prodialihkan kegemini-3.8-flash.gemini-2.5-flashdialihkan kegemini-3.5-flash-lite.gemini-2.5-flash-litetidak 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_budgetdigantithinking_level. Pada 3.8 Flash nilainyalow,medium(default), atauhigh. Nilaiminimaltidak didukung dan menghasilkan error, sedangkan 3.5 Flash-Lite menerimaminimal,medium, danhigh.- Parameter
temperature,top_p,top_k, dancandidate_countharus 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_instructionatau structured output. - Function calling: setiap
FunctionResponseharus menyertakancall_iddanname, dan thought signature harus dipertahankan. - Untuk percakapan multi-turn, Google menyarankan
previous_interaction_iddi 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-prodangemini-2.5-flashdi kode, konfigurasi, dan environment variable. - Tentukan modelnya sendiri, jangan menunggu reroute:
gemini-3.8-flashuntuk pengganti Pro,gemini-3.5-flash-liteuntuk pengganti Flash. Sematkan versi, bukan alias-latest. - Ganti
thinking_budgetkethinking_level, dan jangan pakaiminimalpada 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
- Google AI for Developers, Gemini API changelog (entri deprecation 2 November 2026): https://aistudio.google.com/docs/changelog
- Google AI for Developers, Gemini API deprecations (jadwal dan pemetaan model): https://aistudio.google.com/docs/deprecations
- Google AI for Developers, Gemini API pricing: https://aistudio.google.com/docs/pricing
- Google AI for Developers, panduan migrasi ke Gemini 3.8 Flash: https://aistudio.google.com/docs/whats-new-gemini-3.8
- AI Polix, "Google deprecates Gemini 2.5 Pro and 2.5 Flash in the Gemini API and will automatically reroute their traffic...", 3 November 2026: https://aipolix.com/en-us/news/google-deprecates-gemini-2-5-pro-flash-api-auto-route-3-8-flash-3-5-flash-lite-december-1