Menentukan lokasi untuk mengakses model

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

Untuk hampir semua model Gemini, Vertex AI Gemini API mendukung lokasi global, yang berarti permintaan Anda akan ditangani oleh model yang tersedia di mana pun dalam kumpulan global. Menggunakan lokasi global untuk permintaan Anda dapat membantu Anda menghindari batas kapasitas 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, setelan 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 pratinjau Gemini : Anda harus menetapkan lokasi secara eksplisit ke global (kecuali untuk model pratinjau Live API).

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

• Model Gemini 2.5: Setelan lokasi secara eksplisit bersifat opsional, tetapi direkomendasikan. Jika Anda tidak menentukan lokasi, defaultnya adalah us-central1.

• Model Gemini Live API: Setelan lokasi secara eksplisit bersifat opsional, tetapi direkomendasikan. Jika Anda tidak menentukan lokasi, defaultnya 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 penting dan praktik terbaik tentang lokasi:

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

• Untuk menghindari batas kapasitas yang tidak terduga, pertimbangkan untuk menyetel lokasi ke global (jika model Anda mendukung lokasi global).

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

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

Contoh kode

Firebase AI Logic otomatis ditetapkan secara default ke us-central1 untuk semua permintaan. Jika perlu atau ingin menggunakan lokasi yang berbeda, 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 wilayah. Google Cloud hanya menyimpan data pelanggan di region yang Anda tentukan untuk semua fitur yang tersedia secara umum dari AI Generatif di Vertex AI.

AI Generatif di Vertex AI tersedia di wilayah berikut. Beberapa model dan/atau versi tertentu mungkin hanya tersedia di lokasi tertentu (untuk ketersediaan lokasi yang mendetail, lihat dokumentasi Google Cloud).

Perhatikan hal berikut:

• Secara default, Firebase AI Logic berada di lokasi us-central1.

• Untuk semua model pratinjau Gemini (kecuali model Live API), hanya 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 model Live API dan semua model Imagen, lokasi global tidak didukung.