Especifica la ubicación para acceder al modelo

Haz clic en tu proveedor de Gemini API para ver el contenido y el código específicos del proveedor en esta página.


Los modelos de IA generativa de Google están disponibles en regiones específicas.

Cuando inicializas el servicio de backend de Vertex AI Gemini API en tu código, puedes especificar de forma opcional la ubicación del modelo al que accedes en tus solicitudes. Consulta la lista de ubicaciones disponibles más adelante en esta página.

Estos son algunos datos clave y prácticas recomendadas sobre las ubicaciones:

  • Los límites de capacidad son por modelo, por región y por minuto.

  • Si no especificas una ubicación, el valor predeterminado es us-central1.

  • Para evitar alcanzar los límites de capacidad de forma inesperada, te recomendamos que establezcas la ubicación en global en tus solicitudes.

  • Si establecer la ubicación en global no es aplicable a tu caso de uso, considera distribuir explícitamente dónde accedes a los modelos. Por ejemplo, puedes establecer la ubicación según la de tu usuario final con Firebase Remote Config.

Información sobre la ubicación de global

Para acceder a casi todos los modelos de Gemini, la Vertex AI Gemini API admite una ubicación de global, lo que significa que tu solicitud será procesada por un modelo disponible en cualquier lugar del grupo global. Establecer la ubicación en global para tus solicitudes puede ayudarte a evitar alcanzar los límites de capacidad del modelo y reducir los errores de recursos agotados (429).

Muestras de código

Ten en cuenta que estos ejemplos muestran el acceso a un modelo Gemini, pero también puedes especificar una ubicación cuando accedes a un modelo Imagen.

Reemplaza LOCATION por el código de ubicación (por ejemplo, europe-west4) de la lista de ubicaciones disponibles que se encuentra más adelante en esta página.

Swift

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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")

// ...

Kotlin

// ...

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

// ...

Java

// ...

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

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

Web

// ...

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

// Initialize the Vertex AI Gemini API backend service
// Specify the 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' });

// ...

Dart

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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');

// ...

Unity

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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");

// ...

Ten en cuenta que, si especificas una ubicación en la que el modelo no está disponible, recibirás un error 404 que indica que el modelo was not found or your project does not have access to it.

Ubicaciones disponibles

Google Cloud usa regiones. Google Cloud solo almacena los datos del cliente en la región que especifiques para todas las funciones de disponibilidad general de la IA generativa en Vertex AI.

La IA generativa en Vertex AI está disponible en las siguientes regiones. Es posible que algunos modelos o versiones específicos no estén disponibles en todas las ubicaciones (para obtener información detallada sobre la disponibilidad por ubicación, consulta la documentación de Google Cloud).

Todos los modelos Gemini (excepto los modelos de Gemini Live) también están disponibles en una ubicación global. En el caso de los modelos de Imagen, no se admite la ubicación global.

Estados Unidos

  • Columbus, Ohio (us-east5)
  • Dallas, Texas (us-south1)
  • Iowa (us-central1)
  • Las Vegas, Nevada - (us-west4)
  • Moncks Corner, Carolina del Sur (us-east1)
  • Virginia del Norte (us-east4)
  • Oregón (us-west1)

Canadá

  • Montreal (northamerica-northeast1)

Sudamérica

  • São Paulo, Brasil (southamerica-east1)

Europa

  • Bélgica (europe-west1)
  • Finlandia (europe-north1)
  • Fráncfort, Alemania (europe-west3)
  • Londres, Reino Unido (europe-west2)
  • Madrid, España (europe-southwest1)
  • Milán, Italia (europe-west8)
  • Países Bajos (europe-west4)
  • París, Francia (europe-west9)
  • Varsovia, Polonia (europe-central2)
  • Zúrich, Suiza (europe-west6)

Asia-Pacífico

  • Condado de Changhua, Taiwán (asia-east1)
  • Hong Kong, China (asia-east2)
  • Bombay, India (asia-south1)
  • Seúl, Corea (asia-northeast3)
  • Singapur (asia-southeast1)
  • Sídney, Australia (australia-southeast1)
  • Tokio, Japón (asia-northeast1)

Oriente Medio

  • Dammam, Arabia Saudita (me-central2)
  • Doha, Catar (me-central1)
  • Tel Aviv, Israel (me-west1)