Menentukan lokasi untuk mengakses model

Model AI generatif Google tersedia di region tertentu. Setiap permintaan Anda yang menggunakan Vertex AI Gemini API harus menyertakan lokasi untuk mengakses model. Firebase AI Logic secara otomatis ditetapkan ke us-central1 secara default untuk semua permintaan.

Untuk hampir semua Gemini model, Vertex AI Gemini API mendukung 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.

Kapan lokasi perlu ditetapkan secara eksplisit?

Karena Firebase AI Logic otomatis ditetapkan ke us-central1 secara default untuk semua permintaan, jika Anda perlu atau ingin menggunakan lokasi lain, Anda harus menentukan lokasi secara eksplisit selama inisialisasi layanan backend Vertex AI Gemini API dalam kode Anda.

Bergantung pada modelnya, penetapan 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.

• Gemini pratinjau model: Penetapan lokasi ke global secara eksplisit diperlukan (kecuali untuk Live API model pratinjau).

• model: Penetapan lokasi ke global secara eksplisit diperlukan saat menggunakan Firebase AI Logic.Gemini 3.x Firebase AI Logic belum mendukung lokasi us dan eu.

• Gemini 2.5 model: Penetapan lokasi secara eksplisit bersifat opsional, tetapi direkomendasikan. Jika Anda tidak menentukan lokasi, default-nya adalah us-central1.

• model: Penetapan lokasi secara eksplisit bersifat opsional, tetapi direkomendasikan.Gemini Live API Jika Anda tidak menentukan lokasi, default-nya adalah us-central1. Perhatikan bahwa lokasi global tidak didukung.

Lihat daftar semua lokasi yang tersedia di halaman ini.

Fakta umum dan praktik terbaik

Berikut beberapa fakta utama dan praktik terbaik tentang lokasi:

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

• Untuk menghindari batas kapasitas yang tidak terduga, sebaiknya tetapkan lokasi ke global (jika model Anda mendukung lokasi global).

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

• Jika menetapkan lokasi ke global tidak berlaku atau tidak didukung untuk kasus penggunaan Anda, sebaiknya distribusikan secara eksplisit tempat Anda mengakses model. Misalnya, Anda dapat menetapkan lokasi berdasarkan lokasi pengguna akhir dengan menggunakan Firebase Remote Config.

Contoh kode

Firebase AI Logic secara otomatis ditetapkan ke us-central1 secara default untuk semua permintaan. Jika Anda perlu atau ingin menggunakan lokasi lain, Anda harus menentukan lokasi secara eksplisit selama inisialisasi layanan backend Vertex AI Gemini API dalam kode Anda.

Perhatikan bahwa contoh ini menunjukkan cara mengakses model Gemini, tetapi Anda juga dapat menentukan lokasi saat mengakses model Imagen.

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

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

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 di Vertex AI yang tersedia secara umum.

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

Perhatikan hal berikut:

• Firebase AI Logic ditetapkan ke lokasi us-central1 secara default.

• Untuk semua Gemini model pratinjau (kecuali model Live API), lokasi satu-satunya yang didukung adalah global.

• Saat menggunakan Firebase AI Logic untuk mengakses model Gemini 3.x, lokasi satu-satunya yang didukung adalah global. Firebase AI Logic belum mendukung lokasi us dan eu.

• Untuk semua Live API model dan semua Imagen model, global lokasi tidak didukung.