Spécifier l'emplacement d'accès au modèle

Les modèles d'IA générative de Google sont disponibles dans des régions spécifiques. Vous pouvez choisir l'emplacement d'accès au modèle en fonction de vos critères de conformité, de latence, de disponibilité et de durabilité.

Lorsque vous utilisez Firebase AI Logic, chacune de vos requêtes qui utilisent l' Agent Platform Gemini API (formerly Vertex AI) peut inclure l'emplacement d'accès au modèle. Firebase AI Logic dispose de paramètres de localisation par défaut.

• Lorsque vous utilisez la nouvelle syntaxe d'initialisation "Agent Platform" : global
• Lorsque vous utilisez l'ancienne syntaxe d'initialisation "Vertex AI" : us-central1

Pour presque tous les Gemini modèles, le Agent Platform Gemini API (formerly Vertex AI) est compatible avec l'emplacement global, ce qui signifie que votre requête sera traitée par un modèle disponible n'importe où dans le pool mondial. L'utilisation de l'emplacement global pour vos requêtes peut vous aider à éviter d'atteindre les limites de capacité du modèle et à réduire les erreurs "service overloaded" (503). De plus, selon le modèle, l'utilisation de l'emplacement global peut être obligatoire.

Quand est-il nécessaire de définir explicitement un emplacement ?

Firebase AI Logic dispose de valeurs par défaut automatiques pour l'emplacement (par exemple, global lorsque vous utilisez la syntaxe d'initialisation "Agent Platform"). Toutefois, si vous avez besoin ou souhaitez utiliser un autre emplacement, vous devez le spécifier explicitement lors de l’initialisation du service de backend Agent Platform Gemini API (formerly Vertex AI) dans votre code.

Selon le modèle, la définition explicite d'un emplacement peut être obligatoire. Si votre requête tente d'accéder à un modèle dans un emplacement où il n'est pas disponible, vous recevrez une erreur 404 indiquant que le modèle was not found or your project does not have access to it.

• Gemini Modèles bêta et expérimentaux : disponibles uniquement dans l'emplacement global (à l'exception des modèles Live API, voir ci-dessous).

• Gemini 3.x modèles : disponibles uniquement dans l'emplacement global lorsque vous utilisez Firebase AI Logic. Firebase AI Logic n'est pas encore compatible avec les emplacements us et eu.

• Gemini 2.5 modèles : disponibles dans de nombreux emplacements.

• Gemini Live API modèles : disponibles uniquement dans l'emplacement us-central1. L'emplacement global n'est pas compatible.

Consultez la liste de tous les emplacements disponibles plus loin sur cette page.

Informations générales et bonnes pratiques

Voici quelques informations clés et bonnes pratiques concernant les emplacements :

• Les limites de capacité sont définies par modèle, par région et par minute.

• Pour éviter d'atteindre les limites de capacité de manière inattendue, envisagez d'utiliser l'emplacement global (si votre modèle est compatible avec cet emplacement).global

• Envisagez d'utiliser Firebase Remote Config pour contrôler l'emplacement où vous accédez au modèle. Vous pouvez ainsi modifier l'emplacement sans publier de nouvelle version de votre application.

• Si l'utilisation de l'emplacement global n'est pas applicable ou compatible avec votre cas d'utilisation, envisagez de distribuer explicitement l'emplacement où vous accédez aux modèles. Par exemple, vous pouvez définir l'emplacement en fonction de celui de l'utilisateur final à l'aide de Firebase Remote Config.

Exemples de code

Firebase AI Logic dispose de valeurs par défaut automatiques pour l'emplacement (par exemple, global lorsque vous utilisez la syntaxe d'initialisation "Agent Platform"). Toutefois, si vous avez besoin ou souhaitez utiliser un autre emplacement, vous devez le spécifier explicitement lors de l’initialisation du service de backend Agent Platform Gemini API (formerly Vertex AI) dans votre code.

Remplacez LOCATION par le code d'emplacement (par exemple, global ou europe-west4) de la liste des emplacements disponibles plus loin sur cette page.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

Notez que si vous spécifiez un emplacement où le modèle n'est pas disponible, vous recevrez une erreur 404 indiquant que le modèle was not found or your project does not have access to it.

Régions acceptées

Google Cloud utilise des régions. Google Cloud ne stocke les données client que dans la région que vous spécifiez pour toutes les fonctionnalités généralement disponibles de l'IA générative sur Agent Platform.

L'IA générative sur Agent Platform est disponible dans les régions suivantes. Certains modèles et/ou certaines versions spécifiques peuvent ne pas être disponibles dans tous les emplacements (pour connaître la disponibilité détaillée des emplacements, consultez la Google Cloud documentation).

Veuillez noter les points suivants :

• Firebase AI Logic utilise par défaut l'emplacement us-central1.

• Pour tous les modèles Gemini en version bêta (à l'exception des modèles Live API), le seul emplacement compatible est global.

• Lorsque vous utilisez Firebase AI Logic pour accéder aux modèles Gemini 3.x, le seul emplacement compatible est global. Firebase AI Logic n'est pas encore compatible avec les emplacements us et eu.

• Pour tous les modèles Live API et tous les modèles Imagen, l'global emplacement n'est pas compatible.