Menentukan lokasi untuk mengakses model

Model AI generatif Google tersedia di region tertentu.

Saat melakukan inisialisasi layanan backend Vertex AI Gemini API dalam kode Anda, Anda dapat secara opsional menentukan lokasi untuk model yang Anda akses dalam permintaan Anda. Lihat daftar lokasi yang tersedia di halaman ini.

Berikut beberapa fakta dan praktik terbaik utama tentang lokasi:

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

• Jika Anda tidak menentukan lokasi, defaultnya adalah us-central1.

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

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

Mempelajari lokasi global

Untuk mengakses 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. Menetapkan lokasi ke global untuk permintaan Anda dapat membantu Anda menghindari batas kapasitas untuk model dan mengurangi error kehabisan resource (429).

Contoh kode

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

Generative AI 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).

Semua model Gemini (kecuali model Gemini Live API) juga tersedia di lokasi global. Untuk semua Live API model dan semua Imagen model, lokasi global tidak didukung.