Gemini 2.5 Pro usang: apa yang berubah pada 1 Desember 2026

Pada 1 Desember 2026, Google mengirim setiap permintaan ke Gemini 2.5 Pro ke Gemini 3.8 Flash dan menagihnya dengan tarif 3.8 Flash: $0.75 per juta token masukan dan $3.75 per juta token keluaran sampai 31 Desember 2026 (halaman penghentian Google, diperiksa 4 November 2026). Pada hari itu panggilan tetap berhasil. Badan permintaan yang ditulis untuk model lama tidak, dan sebagian besar perbaikannya kecil.

Tiga suntingan menutup sebagian besar pekerjaan:

• ganti string model menjadi gemini-3.8-flash;
• ganti thinking_budget dengan thinking_level;
• hapus temperature, top_p, top_k, candidate_count dan giliran model yang diisi lebih dulu.

Tiga langkah lain menangani status multi-giliran, pemanggilan fungsi dan SDK. Masing-masing mendapat angka di bawah, beserta apa yang terlihat jika dilewati.

Apa yang terjadi pada 1 Desember?

Tanggalnya berasal dari catatan rilis Google, bukan halaman hitung mundur. Entri bertanggal 2 November 2026 menandai gemini-2.5-pro sebagai usang dan menyebut semua permintaan API akan otomatis menuju gemini-3.8-flash dan ditagih dengan tarif Gemini 3.8 Flash (catatan rilis Google, diperiksa 4 November 2026).

Tabel penghentian menambahkan tanggal di sekitarnya: dirilis 17 Juni 2025, dimatikan 1 Desember 2026, pengganti gemini-3.8-flash (diperiksa 4 November 2026). Halaman modelnya lebih sempit lagi: akses API dibatasi untuk pengguna lama yang aktif memakainya, dan hanya sampai 1 Desember 2026. Pemilih AI Studio sudah menghapus model ini.

Satu detail layak dibaca dua kali. Baris tabel yang sama mencantumkan 1 Desember 2026 sebagai tanggal penghentian sekaligus menjanjikan pengalihan otomatis ke 3.8 Flash. Google tidak menyebut apakah panggilan yang dialihkan melaporkan gemini-2.5-pro atau gemini-3.8-flash di respons, jadi catat ID model yang diterima pada hari pertama.

Apa pun yang dikatakan respons, penggantinya stabil: gemini-3.8-flash dirilis 2 September 2026, punya satu ID versi stabil, dan belum ada tanggal penghentian yang diumumkan (halaman penghentian Google, diperiksa 4 November 2026).

Apa yang berubah pada kode dan tagihan

Aturan pengguna lama berlaku sekarang, sebelum 1 Desember: halaman model 2.5 Pro menyebut akses API dibatasi untuk pengguna lama yang aktif memakainya, dan hanya sampai 1 Desember 2026 (diperiksa 4 November 2026). Uji dengan kunci yang benar-benar dipakai tim Anda sebelum merencanakan sisanya.

Kedua model lebih mirip daripada yang disiratkan aturan itu. Keduanya menerima 1.048.576 token masukan dan mengembalikan hingga 65.536 token, keduanya membaca teks, gambar, video, audio dan PDF, dan keduanya mengembalikan teks (halaman model Google, diperiksa 4 November 2026). Perbedaan muncul di tepinya: halaman 3.8 Flash mencantumkan computer use sebagai didukung, dan halaman 2.5 Pro tidak punya baris computer use. Pembuatan audio, pembuatan gambar dan Live API ditandai tidak didukung pada keduanya.

Lalu tagihannya. Mulai 1 Desember Anda membayar tarif 3.8 Flash untuk permintaan yang sama. Sebelum tanggal itu, 2.5 Pro mempertahankan harganya sendiri dan tingkat 200.000 token.

Apa yang rusak saat pindah ke 3.8 Flash

Enam bentuk permintaan berubah perilaku, dan pemanggilan fungsi butuh pemeriksaan paling teliti. Daftar periksa migrasi ke 3.8 Flash dari Google menyebut setiap perubahan (diperiksa 4 November 2026).

Parameter sampling adalah kegagalan yang senyap. Catatan 3.6 Google menyebut temperature, top_p dan top_k sudah usang dan diabaikan sekarang, dan mengirimkannya mengembalikan HTTP 400 pada generasi model berikutnya (diperiksa 4 November 2026). Untuk prompt yang sudah disetel, diabaikan lebih buruk daripada ditolak: pengaturan determinisme berhenti berpengaruh dan tidak ada galat yang memberi tahu.

Pengisian lebih dulu adalah yang berisik. Permintaan yang giliran terakhirnya tidak kosong berupa giliran model mengembalikan HTTP 400, dan perbaikannya adalah system_instruction atau keluaran terstruktur (catatan 3.6 Google, diperiksa 4 November 2026). Percakapan multi-giliran sebaiknya membawa previous_interaction_id daripada transkrip yang disusun ulang dengan giliran terakhir terisi.

Untuk pemanggilan fungsi, taruh aset multimodal di dalam badan respons, pisahkan instruksi sebaris dengan \n\n, dan pakai cara pintas Google jika Malformed_Function_Call muncul di sekitar teks sebelum alat. Pada panggilan generateContent lama, setiap FunctionResponse butuh call_id dan name.

Tanda tangan pemikiran adalah butir keenam, dan penting saat SDK Anda lebih tua daripada modelnya. Daftar periksa 3.8 mengarahkan ke halaman tanda tangan pemikiran Google untuk pembaruan SDK dan penyimpanan tanda tangan.

Enam perubahan, langkah demi langkah

Kerjakan dengan urutan ini. Dua langkah pertama menyentuh setiap permintaan; sisanya menyentuh fitur tertentu.

1. Ganti string model. Kirim gemini-3.8-flash alih-alih gemini-2.5-pro, di konfigurasi dan bukan di pembantu percobaan ulang, supaya log menampilkan ID yang memang ingin Anda panggil.
2. Ganti anggaran pemikiran. thinking_budget menjadi thinking_level dengan nilai low, medium atau high. medium adalah bawaan dan minimal mengembalikan galat.
3. Hapus parameter sampling dan giliran yang diisi lebih dulu. temperature, top_p, top_k, candidate_count dan giliran model di akhir semuanya hilang.
4. Pindahkan status multi-giliran. Seragamkan pada previous_interaction_id di sisi server.
5. Audit pemanggilan fungsi. Aset di dalam badan respons, \n\n di antara instruksi sebaris, call_id dan name pada setiap FunctionResponse.
6. Perbarui SDK dan pertahankan tanda tangan pemikiran. Daftar periksa 3.8 menautkan halaman tanda tangan pemikiran Google untuk ini.

Diff permintaannya muat dalam satu blok. Sebelum:

{
  "model": "gemini-2.5-pro",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_budget": 8192,
    "temperature": 0.7,
    "top_p": 0.9
  }
}

Sesudah:

{
  "model": "gemini-3.8-flash",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_level": "medium"
  }
}

Jalankan satu permintaan nyata ke gemini-3.8-flash sebelum 1 Desember dan catat ID model di respons ke dalam log.

Jika ingin cara lain memanggil gemini-3.8-flash selama masa transisi, halaman model Gemini 3.8 Flash mencantumkan ID, konteks 1M dan tiga tingkat pemikiran. Tarif terkini kedua model ada di halaman harga.

Selisih harga

Pada tingkat berbayar standar, sampai 31 Desember 2026, 3.8 Flash lebih murah kurang dari setengah 2.5 Pro pada keluaran dan 40% lebih murah pada masukan (halaman harga Google, diperiksa 4 November 2026).

Permintaan dengan 100.000 token masukan dan 20.000 token keluaran membuat selisihnya konkret. Di 2.5 Pro biayanya $0.125 + $0.20 = $0.325. Di 3.8 Flash biayanya $0.075 + $0.075 = $0.15 sampai 31 Desember 2026, dan $0.15 + $0.15 = $0.30 mulai 1 Januari 2027.

Baca baris 2027 sebelum bersenang-senang. Masukan naik 20% di atas $1.25 milik 2.5 Pro, dan keluaran tetap 25% di bawah $10.00 milik 2.5 Pro. Permintaan yang sebagian besar berisi masukan akan lebih mahal tahun depan daripada hari ini dengan 2.5 Pro.

Harga batch menjaga bentuk yang sama: 2.5 Pro menagih $0.625 untuk masukan dan $5.00 untuk keluaran sampai 200k token, dan 3.8 Flash menagih $0.375 dan $1.875 sampai 31 Desember 2026 (halaman harga Google, diperiksa 4 November 2026).

Tabel tarif lengkap, dengan cache, Priority dan angka 2027, ada di panduan harga Gemini 3.8 Flash.

2.5 Flash dan 2.5 Flash-Lite

2.5 Flash memakai tanggal 1 Desember yang sama; 2.5 Flash-Lite tidak.

Halaman penghentian Google (diperiksa 4 November 2026) menempatkan gemini-2.5-flash pada ketentuan yang sama dengan 2.5 Pro: dirilis 17 Juni 2025, permintaan menuju gemini-3.5-flash-lite mulai 1 Desember 2026, dan penagihan pindah ke tarif 3.5 Flash-Lite. gemini-2.5-flash-lite tidak usang dan tetap tersedia sampai pemberitahuan berikutnya.

Dua ID audio butuh catatan kalender sendiri. gemini-2.5-pro-preview-tts dan gemini-2.5-flash-preview-tts dimatikan pada 17 November 2026, digantikan gemini-3.8-flash-tts atau gemini-3.8-flash-lite-tts.

Pratinjau 2.5 Pro versi tetap yang lebih lama sudah mati. gemini-2.5-pro-preview-03-25, -05-06 dan -06-05 punya tanggal penghentian 2 Desember 2025, jadi konfigurasi yang masih menyebut salah satunya sudah gagal hari ini.

Pertanyaan umum

Apakah Gemini 2.5 Pro sudah usang?

Ya. Catatan rilis Google bertanggal 2 November 2026 menandai gemini-2.5-pro sebagai usang, dan halaman penghentian menetapkan 1 Desember 2026 sebagai hari setiap permintaan API pindah ke gemini-3.8-flash (diperiksa 4 November 2026). Model ini sudah hilang dari pemilih AI Studio.

Apa yang terjadi pada panggilan saya pada 1 Desember 2026?

Panggilan tetap mengembalikan jawaban. Google menyebut permintaan ke gemini-2.5-pro otomatis menuju gemini-3.8-flash dan ditagih dengan tarif 3.8 Flash. Tabel yang sama juga mencantumkan 1 Desember 2026 sebagai tanggal penghentian, dan Google tidak menyebut ID model mana yang dilaporkan respons, jadi catat di log pada hari pertama.

Apakah Gemini 2.5 Pro masih ada di AI Studio?

Tidak. Google menghapus gemini-2.5-pro dari pemilih AI Studio dan membatasi akses API untuk pengguna lama yang aktif memakainya, sampai 1 Desember 2026 (halaman penghentian dan halaman model Google, diperiksa 4 November 2026).

Apakah kode saya rusak jika tidak mengubah apa pun?

Perkirakan kegagalan di tempat 3.8 Flash menolak bidang lama: thinking_level: "minimal", candidate_count, giliran model di akhir, dan objek FunctionResponse tanpa call_id dan name. thinking_budget harus menjadi thinking_level, dan temperature, top_p serta top_k sudah diabaikan. Panduan migrasi Google mencantumkan setiap perubahan, dan permintaan yang berakhir pada giliran model tidak kosong sudah mengembalikan HTTP 400.

Berapa lebih murah Gemini 3.8 Flash?

Sampai 31 Desember 2026, harganya 40% lebih murah pada masukan dan 62,5% lebih murah pada keluaran daripada 2.5 Pro di bawah 200k token: $0.75 dibanding $1.25, dan $3.75 dibanding $10.00 per juta. Mulai 1 Januari 2027, masukan berbiaya 20% lebih mahal daripada 2.5 Pro dan keluaran 25% lebih murah.

Sumber yang diperiksa

• Penghentian model API Google Gemini
• Catatan rilis API Google Gemini
• Migrasi ke Gemini 3.8 Flash
• Perubahan dan parameter API Gemini 3.6
• Halaman model Gemini 2.5 Pro
• Halaman model Gemini 3.8 Flash
• Harga API Gemini