FAQ dan pemecahan masalah

Perbedaan antara penggunaan Gemini Developer API dan Agent Platform Gemini API (formerly Vertex AI)

Tabel berikut mencantumkan perbedaan penting antara dua penyedia "Gemini API" secara umum, terlepas dari cara Anda mengaksesnya:

¹ Kedua penyedia API memiliki harga bayar sesuai penggunaan yang berbeda (pelajari lebih lanjut dalam dokumentasi masing-masing).

² Files API untuk Gemini Developer API tidak didukung melalui SDK Firebase AI Logic.

Tabel berikut mencantumkan ketersediaan fitur yang sering ditanyakan untuk dua penyedia "Gemini API". Tabel ini berlaku khususnya saat menggunakan Firebase AI Logic client SDK.

Cara menggunakan Gemini Developer API dan Agent Platform Gemini API (formerly Vertex AI)

Anda dapat mengaktifkan kedua penyedia Gemini API di project Firebase, dan Anda dapat menggunakan kedua API tersebut di aplikasi Anda.

Untuk beralih di antara penyedia API dalam kode Anda, pastikan Anda telah menetapkan layanan backend dengan tepat dalam kode Anda.

API yang diperlukan dan cara mengaktifkannya

Untuk menggunakan Firebase AI Logic SDK dengan Agent Platform Gemini API (formerly Vertex AI), project Anda harus mengaktifkan dua API berikut:

• Agent Platform API (aiplatform.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

Anda dapat mengaktifkan API ini menggunakan salah satu opsi berikut:

• Opsi 1 (direkomendasikan): Aktifkan API dengan beberapa klik di Firebase console:

  1. Di konsol Firebase, buka halaman AI Services > Firebase AI Logic.

  2. Klik Get started.

  3. Pilih untuk memulai Agent Platform Gemini API (formerly Vertex AI).

     Tindakan ini akan meluncurkan alur kerja terpandu yang mengaktifkan kedua API untuk Anda. Firebase juga akan menyediakan akun layanan yang dikelola Google (P4SA) untuk mengizinkan penggunaan Gemini API, serta menambahkan API Firebase AI Logic ke daftar yang diizinkan untuk kunci API Firebase Anda.

• Opsi 2 (manual; tidak direkomendasikan): Aktifkan API di konsol Google Cloud:

  1. Klik setiap link API di bagian atas entri FAQ ini, lalu klik Enable di halaman setiap API.

  2. Tambahkan Firebase AI Logic API ke daftar yang diizinkan untuk kunci API Firebase Anda.

Cara menonaktifkan API di project Firebase

Untuk Firebase AI Logic, kami mencoba membuat penyiapan project Firebase Anda untuk menggunakan penyedia Gemini API pilihan Anda semudah mungkin. Hal ini termasuk mengaktifkan API yang diperlukan di project Firebase Anda selama perjalanan tertentu, seperti alur kerja terpandu di Firebase console.

Namun, jika Anda memutuskan untuk tidak menggunakan Firebase AI Logic atau salah satu penyedia Gemini API, Anda dapat menonaktifkan API terkait di project Firebase Anda.

Izin yang diperlukan untuk menggunakan Firebase AI Logic

Model yang didukung saat menggunakan Firebase AI Logic

Lihat daftar model yang didukung. Kami sering menambahkan kemampuan baru ke SDK, jadi periksa kembali FAQ ini untuk mengetahui info terbaru (serta di catatan rilis, blog, dan postingan media sosial).

• Firebase AI Logic mendukung model berikut:

  • Gemini Developer API

    • Sebagian besar model dasar Gemini

  • Agent Platform Gemini API (formerly Vertex AI)

    • Sebagian besar model dasar Gemini

• Firebase AI Logic tidak mendukung model berikut (terlepas dari penyedia Gemini API yang Anda pilih):

  • Model yang disesuaikan

  • Model embedding, model Veo, model Lyria, model robotika, model penggunaan komputer, model Gemini Omni, atau model Gemini Cyber

Cara menetapkan batas kapasitas per pengguna

Secara default, Firebase AI Logic menetapkan batas permintaan per pengguna sebesar 100 permintaan per menit (RPM).

Jika ingin menyesuaikan batas kapasitas per pengguna, Anda harus menyesuaikan setelan kuota untuk Firebase AI Logic API.

Pelajari lebih lanjut kuota API Firebase AI Logic. Di halaman tersebut, Anda juga dapat mempelajari cara melihat dan mengedit kuota Anda.

Cara mengurangi latensi dan penggunaan token yang tinggi

Jika Anda mengalami latensi tinggi atau penggunaan token yang tinggi, kemungkinan hal ini disebabkan oleh konfigurasi tingkat penalaran untuk model yang Anda gunakan.

Model Gemini 3 dan yang lebih baru selalu menggunakan "proses berpikir" internal yang secara signifikan meningkatkan kemampuan penalaran dan perencanaan multi-langkah, sehingga sangat efektif untuk tugas-tugas kompleks seperti coding, matematika lanjutan, dan analisis data.

Namun, bergantung pada tugasnya, tingkat penalaran yang lebih tinggi tidak selalu diperlukan, dan Anda dapat mengonfigurasi model untuk menggunakan tingkat penalaran yang lebih rendah. Tingkat penalaran yang lebih rendah akan membantu mengurangi latensi dan penggunaan token. Untuk membantu Anda memutuskan seberapa besar kemampuan penalaran yang mungkin diperlukan model, tinjau perbandingan tingkat kesulitan tugas.

Perhatikan bahwa untuk sebagian besar model Gemini 3 dan yang lebih baru, tingkat penalaran default ditetapkan ke HIGH.

Persyaratan jenis MIME untuk permintaan multimodal (seperti untuk input gambar, PDF, video, dan audio)

Dalam setiap permintaan multimodal, Anda harus selalu memberikan hal berikut:

• mimeType file. Lihat pengecualian di bawah.

• File. Anda dapat memberikan file sebagai data inline atau memberikan file menggunakan URL-nya.

Pelajari jenis file input yang didukung, cara menentukan jenis MIME, dan dua opsi untuk menyediakan file di File input dan persyaratan yang didukung.

Pengecualian untuk menyertakan jenis MIME dalam permintaan Anda

Pengecualian untuk penyediaan jenis MIME adalah input gambar inline untuk permintaan dari aplikasi platform Android dan Apple native.

Firebase AI Logic SDK untuk platform Android dan Apple menyediakan cara yang disederhanakan dan mudah digunakan platform untuk menangani gambar dalam permintaan — semua gambar (apa pun formatnya) dikonversi di sisi klien ke JPEG dengan kualitas 80% sebelum dikirim ke server. Artinya, saat Anda memberikan gambar sebagai data inline menggunakan SDK platform Android dan Apple, Anda tidak perlu menentukan jenis MIME dalam permintaan.

Penanganan yang disederhanakan ini ditampilkan dalam dokumentasi Firebase AI Logic dalam contoh untuk mengirim gambar berenkode base64 dalam permintaan.

Berikut beberapa informasi tambahan khusus platform tentang fitur ini:

• Untuk Android:

  • Anda dapat memanfaatkan cara yang disederhanakan untuk menangani jenis gambar native platform (Bitmap) dalam perintah multimodal yang berisi gambar sebagai data inline (lihat contoh).

  • Untuk kontrol yang lebih besar atas format gambar dan konversi, Anda dapat memberikan gambar sebagai InlineDataPart dan menyediakan jenis MIME tertentu. Contoh:

    content { inlineData(/* PNG as byte array */, "image/png") }

• Untuk platform Apple:

  • Anda dapat memanfaatkan cara yang disederhanakan untuk menangani jenis gambar native platform (UIImage, NSImage, CIImage, dan CGImage) dalam perintah multimodal yang berisi gambar sebagai data inline (lihat contoh).

  • Untuk kontrol yang lebih besar atas format gambar dan konversi, Anda dapat memberikan gambar sebagai InlineDataPart dan menyediakan jenis MIME tertentu. Contoh:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

Fitur lanjutan yang belum tersedia saat menggunakan Firebase AI Logic: Grounding dengan Google Gambar, penyesuaian model, pembuatan embedding, dan pengambilan semantik

Fitur berikut didukung oleh berbagai model dan penyedia API, tetapi tidak tersedia saat menggunakan Firebase AI Logic:

• Grounding dengan Google Penelusuran Gambar
• Menyesuaikan model
• Pembuatan embedding
• Pengambilan semantik

Jika Anda ingin menambahkan ini sebagai permintaan fitur atau memberikan suara pada permintaan fitur yang ada, buka Firebase UserVoice.

Penggunaan data untuk melatih model

Lihat Tata kelola data & Responsible AI.

Model yang tidak digunakan lagi atau dinonaktifkan (dihentikan) - daftar dan penggantinya

Saat Google merilis versi model yang stabil, kami berupaya untuk membuatnya tetap tersedia selama minimal 12 bulan sebelum kami menonaktifkan (menghentikan) model tersebut.

Namun, perhatikan hal-hal berikut:

• Untuk Agent Platform Gemini API (formerly Vertex AI), beberapa model stabil hanya memiliki ketersediaan jangka pendek, yang berarti model tersebut dapat dinonaktifkan (dihentikan) paling cepat 45 hari setelah model pengganti dirilis.

• Untuk Gemini Developer API, terkadang, alih-alih menonaktifkan model, layanan akan otomatis merutekan permintaan ke model yang lebih baru. Permintaan ke model yang lebih baru akan ditagih sesuai tarif model yang lebih baru.

• Beberapa minggu sebelum tanggal penonaktifan, project yang belum pernah menggunakan model akan diblokir agar tidak mulai menggunakannya.

• Saat versi stabil dirilis untuk model tertentu, semua versi eksperimental dan pratinjau model tersebut biasanya akan dihentikan (dihentikan) dalam beberapa hari atau minggu (FAQ ini tidak mencantumkan setiap model pratinjau dan eksperimental sebelumnya).

Model penggunaan umum

^{1 Untuk Agent Platform Gemini API (formerly Vertex AI), ini adalah "model ketersediaan jangka pendek". Lihat Pola penamaan dan pembuatan versi model}

^{Semua model penggunaan umum berikut juga dinonaktifkan: gemini-1.0-pro, gemini-1.0-pro-001, gemini-1.0-pro-002, gemini-1.0-pro-vision, gemini-1.0-pro-vision-001 gemini-1.5-flash-001, gemini-1.5-flash, gemini-1.5-flash-002, gemini-1.5-pro-001, gemini-1.5-pro, gemini-1.5-pro-002}

Model pembuat gambar (Nano Banana dan Imagen)

Audio - Model Live API

Perubahan yang diperlukan saat model tidak digunakan lagi atau dinonaktifkan (dihentikan)

Di mana saya dapat menemukan tanggal penonaktifan model?

Berikut beberapa cara untuk menemukan tanggal penonaktifan model:

• Google akan mengirim email kepada anggota project yang sesuai.

• Kami memposting pengumuman dan pengingat tentang penonaktifan mendatang di berbagai saluran:

  • Catatan rilis (lihat contoh)
  • Banner tingkat halaman di dokumen, halaman model yang didukung, dan FAQ model yang tidak digunakan lagi dan dihentikan

Apa yang harus dilakukan jika model yang Anda gunakan akan dinonaktifkan?

Anda harus melakukan perubahan ini sebelum tanggal penonaktifan; jika tidak, setiap permintaan ke model yang dinonaktifkan akan gagal dengan error 404.

1. Temukan model yang saat ini didukung dan nama modelnya yang sesuai.

   Kami juga menyediakan model pengganti yang direkomendasikan di FAQ model yang tidak digunakan lagi dan dinonaktifkan.

2. Perbarui nama model yang digunakan oleh aplikasi Anda.

   Anda menetapkan nama model selama inisialisasi saat membuat instance GenerativeModel, LiveModel, atau ImagenModel. Pastikan untuk meninjau rekomendasi penting di bawah tentang penggunaan Firebase Remote Config atau template perintah server.

3. Periksa apakah Anda perlu mengupdate kode.

   Anda biasanya tidak perlu mengubah kode apa pun yang benar-benar memanggil model. Berikut beberapa pengecualian:

   • Parameter sampling yang tidak didukung: Model Gemini 4.x dan Gemini 3.x terbaru, beberapa parameter tidak didukung (khususnya temperature, top-K, top-P, frequency penalty, presence penalty, dan candidate count).

   • Thinking level vs Thinking budget: Mulai dari model Gemini 3.x, Anda harus menggunakan thinkingLevel, bukan thinkingBudget (tetapi thinkingBudget masih didukung untuk kompatibilitas mundur). Namun, mulai model Gemini 4.x, thinkingBudget tidak didukung. Pelajari lebih lanjut proses berpikir.

   • Bereksperimen dengan nilai tingkat penalaran: Saat Anda mengupgrade ke generasi baru (misalnya, 2.5 ke 3.8) dan ingin memastikan performa dan perilaku yang sama (misalnya, latensi), sebaiknya bereksperimen dengan menetapkan tingkat penalaran ke nilai yang lebih rendah. Pelajari lebih lanjut proses berpikir.

4. Uji aplikasi Anda untuk memastikan bahwa respons masih sesuai harapan.

Perubahan yang diperlukan untuk rebranding "Vertex AI" menjadi "Agent Platform"

Pada pertengahan tahun 2026, Google Cloud melakukan rebranding "Vertex AI" menjadi "Gemini Enterprise Agent Platform" (atau "Agent Platform"). Dalam ekosistem Firebase, kami menyebut layanan ini sebagai "Gemini API Agent Platform".

Untuk Google Cloud, rebranding ini mencakup hal berikut. Perhatikan bahwa ada perubahan lain, tetapi tidak berlaku untuk Firebase AI Logic.

• Melakukan rebranding produk dari "Vertex AI" menjadi "Gemini Enterprise Agent Platform" (atau "Agent Platform"), yang mencakup URL baru untuk konsol dan dokumentasi Google Cloud.

• Mengubah nama tampilan API dari "Vertex AI API" menjadi "Agent Platform API". Perhatikan bahwa nama layanan tetap sama: aiplatform.googleapis.com.

• Rebranding "Vertex AI Studio" menjadi "Agent Studio".

• Tidak ada perubahan pada kemampuan API yang mendasarinya atau model yang didukung.

Untuk SDK Firebase AI Logic, kami mengakomodasi rebranding ini dengan memperbarui sintaksis inisialisasi untuk layanan backend "Gemini API" dan memperbarui lokasi default untuk mengakses model saat menggunakan sintaksis baru ini.

• Sintaksis inisialisasi baru untuk layanan backend "Gemini API":

  Swift

  Ubah vertexAI menjadi agentPlatform.

  • Sintaksis agentPlatform tersedia mulai SDK v12.17.0+.
  • Sintaksis vertexAI dihapus di SDK v13.0.0.

  BEFORE

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))
  
  // ...
  

  AFTER

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))
  
  // ...
  

  Kotlin

  Ubah vertexAI menjadi agentPlatform.

  • Sintaksis agentPlatform tersedia mulai dari SDK v17.15.0+ dan Firebase Android BoM v34.17.0+.
  • Sintaksis vertexAI telah dihapus di SDK v18.0.0 dan BoM v35.0.0.

  BEFORE

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
  
  // ...
  

  AFTER

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))
  
  // ...
  

  Java

  Ubah vertexAI menjadi agentPlatform.

  • Sintaksis agentPlatform tersedia mulai dari SDK v17.15.0+ dan Firebase Android BoM v34.17.0+.
  • Sintaksis vertexAI telah dihapus di SDK v18.0.0 dan BoM v35.0.0.

  BEFORE

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));
  
  // ...
  

  AFTER

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));
  
  // ...
  

  Web

  Ubah VertexAIBackend menjadi AgentPlatformBackend.

  • Sintaksis AgentPlatformBackend tersedia mulai Firebase JS SDK v12.17.0 dan yang lebih baru.
  • Sintaksis VertexAIBackend dihapus di SDK v13.0.0.

  BEFORE

  import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });
  
  // ...
  

  AFTER

  import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `AgentPlatformBackend` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });
  
  // ...
  

  Dart

  Ubah vertexAI menjadi agentPlatform.

  • Sintaksis agentPlatform tersedia mulai dari plugin v3.15.0+ dan Firebase Flutter BoM v4.18.0+.
  • Sintaksis vertexAI telah dihapus di plugin v5.0.0 dan Firebase Flutter BoM v5.0.0+.

  BEFORE

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  final ai = await FirebaseAI.vertexAI(location: 'LOCATION');
  
  // ...
  

  AFTER

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');
  
  // ...
  

  Unity

  Ubah VertexAI menjadi AgentPlatform.

  • Sintaksis AgentPlatform tersedia mulai Firebase SDK untuk Unity v13.15.0 dan yang lebih baru.
  • Sintaksis VertexAI dihapus di SDK v14.0.0.

  BEFORE

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));
  
  // ...
  

  AFTER

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
  // For the `AgentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));
  
  // ...
  

• Lokasi default baru untuk mengakses model saat menggunakan sintaksis inisialisasi baru:

  Saat menggunakan sintaksis inisialisasi "Agent Platform" yang baru, lokasi akan ditetapkan secara default ke global.

  Perubahan ini dilakukan karena hampir semua model Gemini didukung di global, dan Google Cloud tidak lagi mendukung lokasi us-central1 untuk rilis baru sebagian besar model Gemini.

Untuk aplikasi Swift - Perubahan yang diperlukan untuk bermigrasi dari FirebaseAI ke FirebaseAILogic

Untuk aplikasi platform Apple, mulai Firebase SDK v12.5.0, Firebase AI Logic didistribusikan di modul FirebaseAILogic. Di SDK v13.0.0, modul FirebaseAI dihapus.

Mengapa kami melakukan perubahan ini?

Sebelumnya, kami mendistribusikan layanan ini di bawah modul FirebaseAI. Namun, kami perlu mengganti namanya menjadi FirebaseAILogic karena alasan berikut:

• Hindari konflik nama antara modul dan class yang menyebabkan masalah dalam distribusi biner.

• Memungkinkan kami menggunakan makro Swift untuk pengembangan fitur di masa mendatang.

Apa yang harus dilakukan jika Anda mengupgrade ke v12.5.0+ atau v13.0.0+?

Di Firebase 12 (mulai v12.5.0+), perubahan nama modul menjadi FirebaseAILogic tidak menyebabkan gangguan dan kompatibel dengan versi lama, sehingga perubahan ini direkomendasikan di Firebase 12. Namun, di Firebase SDK v13.0.0, modul FirebaseAI lama telah dihapus, sehingga perubahan ini diperlukan saat mengupgrade ke Firebase 13.

1. Saat memilih dependensi Swift PM, pilih FirebaseAILogic (bukan FirebaseAI).

2. Ubah pernyataan impor menjadi FirebaseAILogic (bukan FirebaseAI).

Memahami perubahan nama dari "Vertex AI in Firebase" menjadi "Firebase AI Logic"

Pada tahun 2024, kami meluncurkan serangkaian Firebase client SDK yang dapat menggunakan Agent Platform Gemini API (formerly Vertex AI) serta gateway proxy Firebase untuk melindungi API tersebut dari penyalahgunaan dan untuk memungkinkan integrasi dengan produk Firebase lainnya. Kami menyebut produk kami "Vertex AI in Firebase", dan nama produk ini secara akurat menjelaskan kasus penggunaan yang tersedia untuk produk kami pada saat itu.

Namun, sejak saat itu, kami telah memperluas kemampuan produk kami. Misalnya, mulai Mei 2025, kami kini menawarkan dukungan untuk Gemini Developer API, termasuk kemampuan untuk melindungi Gemini Developer API dari penyalahgunaan menggunakan integrasi kami dengan Firebase App Check.

Oleh karena itu, nama "Vertex AI in Firebase" tidak lagi secara akurat mewakili cakupan produk kami yang diperluas. Oleh karena itu, nama baru — Firebase AI Logic — lebih mencerminkan set fitur kami yang terus berkembang dan memungkinkan kami untuk terus memperluas penawaran kami di masa mendatang.

Lihat panduan migrasi untuk memastikan Anda mendapatkan semua fitur terbaru dari Firebase AI Logic (dan secara opsional mulai menggunakan Gemini Developer API).

Penegakan App Check yang diperlukan untuk semua versi aplikasi

App Check harus diterapkan untuk semua versi aplikasi Anda yang menggunakan Firebase AI Logic.

Sangat penting untuk menerapkan App Check sedini mungkin — terutama sebelum Anda meng-commit aplikasi ke sistem kontrol kode sumber yang tersedia untuk publik, membagikan aplikasi, atau menyediakan aplikasi untuk publik.

Jika Anda langsung menerapkan App Check di codebase aplikasi, semua versi aplikasi Anda dapat mengirim token App Check yang valid. Permintaan yang tidak mengirimkan token yang valid dianggap tidak terverifikasi dan akan diblokir saat App Check diterapkan.

Jika Anda telah merilis versi aplikasi kepada pengguna akhir yang tidak menerapkan App Check, lihat FAQ tentang cara menerapkan dan menerapkan App Check untuk aplikasi yang sudah dirilis.

Tunda penerapan otomatis App Check untuk Firebase AI Logic

Mulai 2 November 2026, Firebase akan otomatis menerapkan Firebase App Check untuk Firebase AI Logic di project Firebase Anda (jika belum diterapkan).

Jika App Check diterapkan, setiap permintaan ke Firebase AI Logic tanpa token App Check yang valid akan diblokir. Hal ini mencakup versi aplikasi yang dirilis yang tidak memiliki penyedia pengesahan produksi yang diterapkan.

Jika Anda telah merilis versi aplikasi yang tidak menerapkan App Check, Anda dapat menunda sementara penerapan otomatis App Check untuk Firebase AI Logic. Namun, sebelum 21 Januari 2027, Anda harus berupaya menerapkan dan memberlakukan App Check untuk aplikasi yang sudah dirilis.

Berikut cara menunda penerapan otomatis App Check untuk Firebase AI Logic:

1. Di Firebase console, buka tab Security > App Check > APIs.

2. Temukan baris untuk Firebase AI Logic.

3. Di akhir baris, temukan pemilih tanggal Enforces: dengan ikon editEdit.

4. Pilih tanggal yang Anda inginkan agar App Check diterapkan secara otomatis untuk Firebase AI Logic.

   Tanggal terakhir yang memungkinkan adalah 21 Januari 2027. Setelah tanggal tersebut, Anda tidak dapat menunda penerapan otomatis App Check untuk Firebase AI Logic.

5. Klik Save.

Cara menerapkan dan menerapkan App Check untuk aplikasi yang sudah dirilis

Untuk versi aplikasi yang tidak menerapkan App Check, permintaan ke Firebase AI Logic dari versi tersebut tidak memiliki token App Check yang valid dan dianggap belum diverifikasi. Permintaan ini akan diblokir saat App Check diterapkan untuk Firebase AI Logic.

Petunjuk berikut membantu Anda memigrasikan aplikasi sehingga Anda dapat menerapkan App Check dengan cara yang menghindari gangguan layanan untuk aplikasi yang sudah dirilis yang tidak memiliki App Check.

1. Tunda penerapan otomatis App Check untuk Firebase AI Logic:

   1. Di Firebase console, buka tab Security > App Check > APIs.

   2. Temukan baris untuk Firebase AI Logic.

   3. Di akhir baris, temukan pemilih tanggal Enforces: dengan ikon editEdit.

   4. Pilih tanggal yang Anda inginkan agar App Check diterapkan secara otomatis untuk Firebase AI Logic.

      Tanggal terakhir yang memungkinkan adalah 21 Januari 2027. Setelah tanggal tersebut, Anda tidak dapat menunda penerapan otomatis App Check untuk Firebase AI Logic.

   5. Klik Save.

2. Terapkan penyedia pengesahan produksi di aplikasi Anda sesegera mungkin.

   • Platform Apple: DeviceCheck atau App Attest atau reCAPTCHA Enterprise
   • Android: Play Integrity atau reCAPTCHA Enterprise
   • Web: reCAPTCHA Enterprise
   • Flutter: Mendukung semua penyedia di atas, termasuk reCAPTCHA Enterprise
   • Unity: Mendukung semua penyedia di atas (dukungan untuk reCAPTCHA Enterprise akan segera hadir)

3. Pantau permintaan dari aplikasi Anda untuk membantu Anda memutuskan kapan waktu yang aman untuk menerapkan App Check.

   Misalnya, jika hampir semua permintaan terbaru berasal dari klien terverifikasi, sebaiknya pertimbangkan untuk menerapkan App Check.

4. Terapkan App Check untuk Firebase AI Logic.

5. Untuk pengembangan lokal saat App Check diterapkan, Anda dapat menyiapkan penyedia debug App Check dan tetap menerapkan App Check untuk Firebase AI Logic.

Memahami upgrade keamanan (pertengahan 2026) untuk Gemini Developer API dan Firebase AI Logic

Sebelumnya, Gemini Developer API mengandalkan kunci API Gemini standar untuk mengizinkan penggunaan Gemini Developer API (generativelanguage.googleapis.com). Jika Anda mengaktifkan Firebase AI Logic dan memilih untuk menggunakan Gemini Developer API, Firebase akan membuat kunci API Gemini untuk Anda yang dibatasi untuk Gemini Developer API. Kunci ini diberi nama Gemini Developer API key (auto created by Firebase).

Mulai pertengahan tahun 2026, Gemini Developer API akan diupgrade ke alternatif yang lebih aman yang disebut "Kunci otorisasi (auth)" (yang pada dasarnya adalah akun layanan). Firebase AI Logic telah diupgrade secara bersamaan. Alih-alih menggunakan kunci API Gemini standar, Firebase AI Logic kini menangani otorisasi untuk Gemini Developer API menggunakan akun layanan yang dikelola Google (P4SA) yang kami sediakan secara otomatis untuk Anda:
Agen Layanan Firebase AI Logic (service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com)

Untuk project yang sudah ada dan yang baru, jika Anda mengakses Gemini Developer API melalui Firebase AI Logic, Anda tidak perlu melakukan tindakan apa pun untuk memanfaatkan upgrade keamanan ini mulai pertengahan tahun 2026.

Cara memigrasikan kunci API Gemini ke "Kunci otorisasi (auth)"

Untuk project yang sudah ada dan yang baru, jika Anda mengakses Gemini Developer API melalui Firebase AI Logic, Anda tidak perlu melakukan tindakan apa pun untuk memanfaatkan upgrade keamanan mulai pertengahan tahun 2026 (termasuk bermigrasi ke "Kunci otorisasi (auth)").

Atas nama developer kami, Firebase AI Logic otomatis menangani semua perubahan keamanan yang diperlukan untuk mengakomodasi transisi Gemini Developer API agar memerlukan "Kunci otorisasi (auth)".

Mulai pertengahan tahun 2026, Firebase AI Logic tidak lagi menyediakan atau menggunakan kunci API Gemini standar. Sebagai gantinya, Firebase AI Logic kini menangani otorisasi untuk Gemini Developer API menggunakan akun layanan yang dikelola Google (P4SA) yang kami sediakan secara otomatis untuk Anda di project Firebase Anda:
Firebase AI Logic Service Agent (service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com)

Dengan adanya perubahan ini, Anda dapat meninjau dan menghapus kunci API apa pun yang bernama Gemini Developer API key (auto created by Firebase). Anda dapat menghapus kunci ini di Google Cloud console. Tinjau hal berikut sebelum menghapus kunci:

• Kunci API Gemini ini dibuat oleh Firebase hanya untuk digunakan dengan Firebase AI Logic, sehingga seharusnya aman untuk dihapus. Namun, sebelum menghapus kunci ini, Anda tetap harus memeriksa untuk memastikan bahwa Anda tidak salah menggunakan kunci tersebut dengan alat lain yang dapat memberikan akses ke Gemini Developer API, seperti SDK server GenAI atau Genkit. Berikut cara memeriksa penggunaan:
  1. Di Google Cloud console, buka halaman untuk Gemini Developer API, lalu klik Manage.
  2. Di tab Metrics, di dropdown Credentials, pilih kunci bernama Gemini Developer API key (auto created by Firebase).
  3. Jika grafik yang ditampilkan tidak menunjukkan penggunaan sejak awal Juli 2026 (saat Firebase AI Logic berhenti menggunakan kunci API ini), kunci tersebut aman untuk dihapus.
     Namun, jika grafik menunjukkan penggunaan, berarti Anda menggunakan kunci dengan alat lain dan Anda harus mengganti nama kunci agar jelas bahwa kunci tersebut digunakan dengan alat tersebut (dan bukan dengan Firebase AI Logic).
• Pastikan Anda tidak menghapus kunci API lain dengan nama yang berisi segmen (auto created by Firebase).

Jangan menambahkan kunci API Gemini ke codebase aplikasi seluler atau web

Saat menggunakan Firebase AI Logic SDK, Anda tidak memerlukan kunci API Gemini untuk mengizinkan penggunaan Gemini Developer API, dan Anda tidak boleh menambahkan kunci API Gemini ke codebase aplikasi Anda.

Jangan gunakan "kunci API Firebase" sebagai kunci API Gemini

Jangan pernah menggunakan "kunci Firebase API" Anda sebagai kunci API Gemini. Sebaiknya Anda tidak menambahkan Gemini Developer API ke daftar yang diizinkan untuk kunci API Firebase Anda.

Kunci Firebase API adalah kunci API yang tercantum dalam file atau objek konfigurasi Firebase yang Anda tambahkan ke codebase aplikasi untuk menghubungkan aplikasi ke Firebase. Anda boleh menyertakan kunci Firebase API dalam kode jika Anda hanya menggunakan kunci tersebut dengan API terkait Firebase (seperti Firebase AI Logic). Pelajari informasi penting tentang kunci Firebase API.

Di panel APIs & Services > Credentials di Google Cloud console, berikut tampilan kunci API Firebase:

Karena Anda perlu menambahkan kunci Firebase API ke codebase aplikasi agar API terkait Firebase berfungsi, dan karena Gemini Developer API dapat diotorisasi melalui kunci API, kami sangat menyarankan agar Anda TIDAK menambahkan Gemini Developer API (disebut "Generative Language API" di Google Cloud console) ke daftar yang diizinkan API untuk kunci Firebase API Anda. Jika Anda melakukannya, Anda akan mengekspos Gemini Developer API ke potensi penyalahgunaan.

Cara menjaga keamanan kunci API Gemini