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 Vertex AI Gemini API harus menyertakan lokasi untuk mengakses model. Firebase AI Logic secara otomatis ditetapkan ke us-central1 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 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, lokasi mungkin harus ditetapkan secara eksplisit. 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 model pratinjau: Lokasi harus ditetapkan secara eksplisit ke global (kecuali untuk Live API model pratinjau).

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

• Gemini 2.5 model: Lokasi dapat ditetapkan secara eksplisit, tetapi direkomendasikan. Jika Anda tidak menentukan lokasi, default-nya adalah us-central1.

• Gemini Live API model: Lokasi dapat ditetapkan secara eksplisit, tetapi direkomendasikan. 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 menggunakan Firebase Remote Config.

Contoh kode

Firebase AI Logic secara otomatis ditetapkan ke us-central1 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 mendetail, lihat Google Cloud dokumentasi).

Perhatikan hal berikut:

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

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

• Saat menggunakan Firebase AI Logic untuk mengakses model Gemini 3.x, satu-satunya lokasi 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.