Menentukan lokasi untuk mengakses model

Model AI generatif Google tersedia di region tertentu. Anda dapat memilih tempat untuk mengakses model yang memenuhi persyaratan kepatuhan, latensi, ketersediaan, dan ketahanan Anda.

Saat menggunakan Firebase AI Logic, setiap permintaan Anda yang menggunakan Agent Platform Gemini API (formerly Vertex AI) dapat secara opsional menyertakan lokasi untuk mengakses model. Firebase AI Logic memiliki setelan lokasi default.

• Saat menggunakan sintaksis inisialisasi "Agent Platform" yang baru: global
• Saat menggunakan sintaksis inisialisasi "Vertex AI" lama: us-central1

Tentang lokasi global

Untuk hampir semua model Gemini, Agent Platform Gemini API (formerly Vertex AI) menawarkan lokasi global, yang berarti permintaan Anda akan ditangani oleh model yang tersedia di mana saja dalam kumpulan global.

Menggunakan lokasi global untuk permintaan Anda dapat membantu Anda menghindari batas kapasitas untuk model dan mengurangi error "layanan kelebihan beban" (503). Selain itu, bergantung pada modelnya, penggunaan lokasi global mungkin diperlukan karena ini adalah satu-satunya lokasi yang tersedia untuk model tersebut (misalnya, model Gemini pratinjau).

Kapan penetapan lokasi secara eksplisit diperlukan?

Firebase AI Logic memiliki default otomatis untuk lokasi (misalnya, global saat menggunakan sintaksis inisialisasi "Agent Platform"). Namun, jika Anda perlu atau ingin menggunakan lokasi yang berbeda, Anda harus secara eksplisit menentukan lokasi selama inisialisasi layanan backend Agent Platform Gemini API (formerly Vertex AI) dalam kode Anda.

Bergantung pada modelnya, menetapkan lokasi secara eksplisit mungkin diperlukan. Jika permintaan Anda mencoba mengakses model di lokasi yang tidak tersedia, Anda akan mendapatkan error 404 yang menyatakan bahwa model was not found or your project does not have access to it.

• Model Gemini preview dan experimental: Hanya tersedia di lokasi global.

• Model stabil Gemini 4.x dan Gemini 3.x: Tersedia di lokasi global dan sering kali di lokasi us dan eu.

• Model Gemini 2.5: Tersedia di banyak lokasi. Perhatikan bahwa model Gemini Live API 2.5 tidak tersedia di global.

Lihat daftar semua lokasi yang tersedia nanti di halaman ini.

Fakta umum dan praktik terbaik

Berikut beberapa fakta penting dan praktik terbaik tentang lokasi:

• Batas kapasitas berlaku per model, per region, per menit.

• Untuk menghindari batas kapasitas yang tidak terduga, pertimbangkan untuk menggunakan lokasi global (jika model tersedia di lokasi global).

• Pertimbangkan untuk menggunakan Firebase Remote Config untuk mengontrol lokasi tempat Anda mengakses model. Dengan begitu, Anda dapat mengubah lokasi tanpa merilis versi baru aplikasi.

• Jika penggunaan lokasi global tidak berlaku untuk kasus penggunaan Anda, pertimbangkan untuk mendistribusikan secara eksplisit tempat Anda mengakses model (jika model tersedia di lokasi selain global). Misalnya, Anda dapat menetapkan lokasi berdasarkan lokasi pengguna akhir menggunakan Firebase Remote Config.

Contoh kode

Firebase AI Logic memiliki setelan default otomatis untuk lokasi (misalnya, global saat menggunakan sintaksis inisialisasi "Agent Platform"). Namun, jika Anda perlu atau ingin menggunakan lokasi lain, Anda harus menentukan lokasi secara eksplisit selama inisialisasi layanan backend Agent Platform Gemini API (formerly Vertex AI) dalam kode Anda.

Ganti LOCATION dengan kode lokasi (misalnya, global atau us-central1) dari daftar lokasi yang tersedia di halaman ini.

// ...

// 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"))

// ...

// ...

// 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"))

// ...

// ...

// 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"));

// ...

// ...

// 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') });

// ...

// ...

// 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');

// ...

// ...

// 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"));

// ...

// ...

// 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"))

// ...

// ...

// 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"))

// ...

// ...

// 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"));

// ...

// ...

// 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') });

// ...

// ...

// 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');

// ...

// ...

// 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"));

// ...

Perhatikan bahwa jika Anda menentukan lokasi tempat model tidak tersedia, Anda akan mendapatkan error 404 yang menyatakan bahwa model was not found or your project does not have access to it.

Lokasi yang tersedia

Google Cloud menggunakan region. Google Cloud hanya menyimpan data pelanggan di region yang Anda tentukan untuk semua fitur AI Generatif yang tersedia secara umum di Agent Platform.

AI Generatif di Agent Platform tersedia di region berikut. Beberapa model dan/atau versi tertentu mungkin tidak tersedia di semua lokasi (untuk mengetahui ketersediaan lokasi secara mendetail, lihat dokumentasi Google Cloud).

Perhatikan hal berikut:

• Firebase AI Logic ditetapkan secara default ke lokasi berikut:

  • Saat menggunakan sintaksis inisialisasi "Agent Platform" baru: global
  • Saat menggunakan sintaksis inisialisasi "Vertex AI" lama: us-central1

• Model Gemini pratinjau dan eksperimental: Hanya tersedia di lokasi global.

• Model stabil Gemini 4.x dan Gemini 3.x: Tersedia di lokasi global dan sering kali di lokasi us dan eu.

• Model Gemini 2.5: Tersedia di banyak lokasi. Perhatikan bahwa model Gemini Live API 2.5 tidak tersedia di global.

Gemini 3.x dan model yang lebih baru

Saat menggunakan model Gemini 3.x dan yang lebih baru, Firebase AI Logic mendukung lokasi berikut:

• global
• us
• eu

Untuk mengetahui detail tentang lokasi yang tersedia untuk setiap model, lihat dokumentasi Google Cloud.

Model generasi lama

Saat menggunakan model Gemini yang lebih lama (seperti model 2.5), Firebase AI Logic mendukung lokasi berikut:

Perhatikan bahwa model Gemini Live API 2.5 tidak tersedia di global.

Untuk mengetahui detail tentang lokasi yang tersedia untuk setiap model, lihat dokumentasi Google Cloud.

Daftar lokasi yang sebelumnya tersedia, tetapi kini dinonaktifkan:

• Belum ada lokasi yang ditolak