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 umum ditanyakan untuk dua penyedia "Gemini API". Tabel ini berlaku khususnya saat menggunakan SDK klien Firebase AI Logic.

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 di aplikasi Anda.

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

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

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

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 Google Cloud dan dokumentasi.

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

• Mengubah nama "Vertex AI Studio" menjadi "Agent Studio".

• Tidak ada perubahan pada kemampuan API pokok 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 dari 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 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 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 dari v12.17.0+ Firebase JS SDK.
  • 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.
  Tersedia mulai dari plugin Firebase AI Logic untuk Flutter v3.15.0+ (Firebase Flutter BoM v4.18.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.
  Tersedia mulai Firebase SDK untuk Unity v13.15.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 tabrakan 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).

API yang diperlukan dan cara mengaktifkannya

Untuk menggunakan Firebase AI Logic SDK dengan Gemini Developer API, project Anda harus mengaktifkan dua API berikut:

• Gemini Developer API (generativelanguage.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

Anda harus mengaktifkan kedua API ini menggunakan konsol Firebase:

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

2. Klik Get started.

3. Pilih untuk memulai Gemini Developer API.

   Tindakan ini akan meluncurkan alur kerja terpandu yang mengaktifkan kedua API tersebut untuk Anda. Firebase juga akan menyediakan akun layanan terkelola Google (P4SA) untuk mengizinkan penggunaan Gemini API, serta menambahkan API Firebase AI Logic 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 agar dapat 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 melihat update (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 robotik, Model penggunaan komputer, Gemini Model Omni, atau Gemini Model Cyber

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

Pastikan untuk meninjau FAQ tentang perubahan yang diperlukan saat model tidak digunakan lagi atau dinonaktifkan (dihentikan).

Gemini 2.5 model stabil - tanggal penonaktifan & penggantian

• Gemini 2.5 Pro, Gemini 2.5 Flash, dan Gemini 2.5 Flash‑Lite

  gemini-2.5-pro
gemini-2.5-flash
gemini-2.5-flash-lite
gemini-2.5-flash-image (alias "Nano Banana")

  • Untuk model penggunaan umum, tanggal penonaktifan bergantung pada penyedia Gemini API yang Anda pilih:

    • Gemini Developer API (Google AI): tidak digunakan lagi, tetapi belum ada tanggal penonaktifan yang diumumkan (hanya project yang sebelumnya aktif yang dapat terus menggunakannya)
    • Agent Platform Gemini API (formerly Vertex AI): 20 Oktober 2026

  • Untuk model pembuatan gambar (Nano Banana), tanggal penonaktifannya sama, terlepas dari penyedia Gemini API yang Anda pilih: 2 Oktober 2026

  Perhatikan bahwa model "Nano Banana" lainnya dan model Gemini Live API 2.5 stabil tidak terpengaruh.

Penggantian: Bermigrasi untuk menggunakan salah satu model Gemini terbaru (seperti gemini-4-argon, gemini-3.8-flash, atau gemini-3.1-flash-image).

Imagen model stabil - tanggal penonaktifan & penggantian

• Semua model Imagen akan dinonaktifkan paling cepat 17 Agustus 2026 (perhatikan bahwa tanggal penonaktifan ini telah diperpanjang dari 30 Juni 2026).

Pengganti: Migrasikan aplikasi Anda untuk menggunakan Gemini model Image (model "Nano Banana").

Gemini 2.0 model stabil - tanggal penonaktifan & penggantian

• Gemini 2.0 Flash dan Gemini 2.0 Flash‑Lite:

  gemini-2.0-flash-001 (dan aliasnya yang diupdate otomatis gemini-2.0-flash)
  gemini-2.0-flash-lite-001 (dan aliasnya yang diupdate otomatisgemini-2.0-flash-lite)

  • 6 Februari 2026: Model ini tidak akan lagi tersedia untuk digunakan dalam proyek yang sebelumnya tidak menggunakan model ini.

  • 31 Maret 2026: Model ini akan dihentikan.

  Perhatikan bahwa model Gemini Live API 2.0 yang stabil tidak terpengaruh.

Penggantian: Bermigrasi untuk menggunakan salah satu model Gemini 3.x baru (seperti gemini-3.1-flash-lite).

Model stabil Gemini 1.5 dan 1.0 - tanggal penghentian & penggantian

• Model Gemini 1.5 Pro:

  • gemini-1.5-pro-002 (dan gemini-1.5-pro): 24 September 2025
  • gemini-1.5-pro-001: 24 Mei 2025

• Model Gemini 1.5 Flash:

  • gemini-1.5-flash-002 (dan gemini-1.5-flash): 24 September 2025
  • gemini-1.5-flash-001: 24 Mei 2025

• Model Gemini 1.0 Pro Vision: 21 April 2025 (sebelumnya dijadwalkan pada 9 April 2025)

• Model Gemini 1.0 Pro: 21 April 2025 (sebelumnya dijadwalkan pada 9 April 2025)

Pengganti: Migrasikan untuk menggunakan salah satu model Gemini 3.x baru (seperti gemini-3.1-flash-lite).

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

Saat Google merilis versi model yang stabil, kami berupaya memastikan bahwa versi tersebut tersedia selama minimal 12 bulan sebelum kami menonaktifkan (menghentikan) model tersebut. Namun, perhatikan bahwa untuk Agent Platform Gemini API (formerly Vertex AI), beberapa model stabil hanya memiliki ketersediaan jangka pendek, yang berarti model tersebut dapat dihentikan (dihentikan penggunaannya) paling cepat 45 hari setelah model pengganti dirilis.

Di mana saya dapat menemukan tanggal penonaktifan model?

Berikut beberapa cara untuk menemukan tanggal penonaktifan model:

• Pada saat rilis: Kami mencantumkan tanggal penonaktifan yang diharapkan untuk setiap model di beberapa tempat dalam dokumentasi penyedia Gemini API serta dalam dokumentasi Firebase (lihat halaman model yang didukung).

• Saat tanggal penutupan semakin dekat:

  • Google mengirim email kepada anggota project yang sesuai.
  • Kami memposting pengingat tentang penghentian mendatang di berbagai saluran:
    • Catatan rilis (lihat contoh)
    • Banner tingkat halaman, halaman model yang didukung, dan FAQ model yang tidak digunakan lagi dan dihentikan

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

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

   Kami juga memberikan model pengganti yang direkomendasikan di FAQ model yang tidak digunakan lagi dan dihentikan.

2. Perbarui nama model yang digunakan oleh aplikasi Anda sebelum tanggal penonaktifan; jika tidak, semua permintaan ke model tersebut akan gagal dengan error 404.

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

   • Saat menggunakan Firebase AI Logic, Anda biasanya tidak perlu mengubah kode apa pun yang benar-benar memanggil model.

     Perhatikan bahwa untuk model Gemini 4.x dan Gemini 3.x terbaru, beberapa parameter tidak didukung (khususnya temperatur, top-K, top-P, penalti frekuensi, penalti kehadiran, dan jumlah kandidat).

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

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 perlu 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.

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. Level 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 ramah 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 di 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 baik atas format dan konversi gambar, Anda dapat memberikan gambar sebagai InlineDataPart dan memberikan 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 bawaan 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 Gambar
• Menyesuaikan model
• Pembuatan embedding
• Pengambilan semantik

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

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 mengaktifkan 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 opsional mulai menggunakan Gemini Developer API).

Penggunaan data untuk melatih model

Lihat Tata kelola data & Responsible AI.

Penegakan App Check wajib 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 mengirim token 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.

Cara menerapkan dan memberlakukan 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. 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)

2. 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, Anda harus mempertimbangkan untuk menerapkan App Check.

3. Terapkan App Check untuk Firebase AI Logic.

4. 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:
Firebase AI Logic Service Agent (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 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 konsol Google Cloud. 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 keliru menggunakan kunci 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 Firebase API" 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 hanya menggunakannya 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 konsol Google Cloud) 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