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

> Pada 1 Desember 2026, Google mengalihkan setiap permintaan gemini-2.5-pro ke gemini-3.8-flash dengan tarif 3.8 Flash. Apa yang rusak dan apa yang diubah.

- Canonical HTML: https://omniakey.com/id/blog/gemini-2-5-pro-deprecated-migration-guide
- Markdown: https://omniakey.com/id/blog/gemini-2-5-pro-deprecated-migration-guide.md
- Published: 2026-11-04 (updated 2026-11-04)
- Author: Kiki, COO at OmniaKey
- Language: id
- Category: Guide
- Reading time: 8 min
- All posts: https://omniakey.com/blog/llms.txt

---

Pada 1 Desember 2026, Google mengirim setiap permintaan ke [Gemini 2.5 Pro](https://omniakey.com/id/gemini-2-5-pro) ke [Gemini 3.8 Flash](https://omniakey.com/id/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).

|Yang Anda kirim|Yang terjadi|Yang perlu diubah|
|-|-|-|
|`thinking_budget`|diganti di permintaan 3.8|kirim `thinking_level`|
|`thinking_level: "minimal"`|mengembalikan galat|pakai `low`, `medium` atau `high`|
|`temperature`, `top_p`, `top_k`|diabaikan sekarang, HTTP 400 pada generasi berikutnya|hapus|
|`candidate_count`|tidak didukung di Gemini 3 dan sesudahnya|satu kandidat per panggilan|
|giliran akhir dengan `role: "model"`|HTTP 400|pindahkan aturannya ke `system_instruction`|
|`FunctionResponse` tanpa `call_id` dan `name`|`Malformed_Function_Call`|tambahkan kedua bidang|

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:

```json
{
  "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:

```json
{
  "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](https://omniakey.com/id/gemini-3-8-flash) mencantumkan ID, konteks 1M dan tiga tingkat pemikiran. Tarif terkini kedua model ada di [halaman harga](https://omniakey.com/id/pricing).

## 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).

|Model|Masukan per 1M|Keluaran per 1M|
|-|-|-|
|`gemini-2.5-pro`, sampai 200k|$1.25|$10.00|
|`gemini-2.5-pro`, di atas 200k|$2.50|$15.00|
|`gemini-3.8-flash`, sampai 31 Des 2026|$0.75|$3.75|
|`gemini-3.8-flash`, mulai 1 Jan 2027|$1.50|$7.50|

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](https://omniakey.com/id/blog/gemini-3-8-flash-api-pricing).

## 2.5 Flash dan 2.5 Flash-Lite

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

|Model|Penghentian|Pengganti|
|-|-|-|
|`gemini-2.5-flash`|1 Desember 2026|`gemini-3.5-flash-lite`|
|`gemini-2.5-flash-lite`|belum diumumkan|tetap tersedia|

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](https://ai.google.dev/gemini-api/docs/deprecations)
- [Catatan rilis API Google Gemini](https://ai.google.dev/gemini-api/docs/changelog)
- [Migrasi ke Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8)
- [Perubahan dan parameter API Gemini 3.6](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6)
- [Halaman model Gemini 2.5 Pro](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro)
- [Halaman model Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash)
- [Harga API Gemini](https://ai.google.dev/gemini-api/docs/pricing)