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 Agent Platform Gemini API (formerly Vertex AI) peut éventuellement inclure l'emplacement pour accéder au modèle. Firebase AI Logic utilise les 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

À propos de l'emplacement global

Pour presque tous les modèles Gemini, Agent Platform Gemini API (formerly Vertex AI) propose un 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 de surcharge du service (503). De plus, selon le modèle, l'utilisation de l'emplacement global peut être requise, car il s'agit du seul emplacement disponible pour le modèle (par exemple, un modèle Gemini en version preview).

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

Firebase AI Logic utilise des valeurs par défaut automatiques pour l'emplacement (par exemple, global lorsque vous utilisez la syntaxe d'initialisation "Agent Platform"). Toutefois, si vous devez 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.

• Modèles Gemini en preview et expérimentaux : disponibles uniquement dans l'emplacement global.

• Modèles stables Gemini 4.x et Gemini 3.x : disponibles dans l'emplacement global et souvent dans les emplacements us et eu.

• Modèles Gemini 2.5 : disponibles dans de nombreux emplacements. Notez que les modèles Gemini Live API 2.5 ne sont pas disponibles dans global.

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 zones géographiques :

• 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 le modèle est disponible dans l'emplacement global).

• Envisagez d'utiliser Firebase Remote Config pour contrôler l'emplacement à partir duquel 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 à votre cas d'utilisation, envisagez de distribuer explicitement l'emplacement où vous accédez à un modèle (si le modèle est disponible dans des emplacements autres que global). Par exemple, vous pouvez définir l'emplacement en fonction de l'emplacement de l'utilisateur final à l'aide de Firebase Remote Config.

Exemples de code

Firebase AI Logic utilise des valeurs par défaut automatiques pour l'emplacement (par exemple, global lorsque vous utilisez la syntaxe d'initialisation "Agent Platform"). Toutefois, si vous devez 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 us-central1) 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 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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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 obtiendrez 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 en disponibilité générale 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 versions spécifiques peuvent ne pas être disponibles dans tous les emplacements (pour connaître la disponibilité détaillée par emplacement, consultez la documentation Google Cloud).

Veuillez noter les points suivants :

• Firebase AI Logic utilise par défaut les emplacements suivants :

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

• Modèles Gemini en preview et expérimentaux : disponibles uniquement dans l'emplacement global.

• Modèles stables Gemini 4.x et Gemini 3.x : disponibles dans l'emplacement global et souvent dans les emplacements us et eu.

• Modèles Gemini 2.5 : disponibles dans de nombreux emplacements. Notez que les modèles Gemini Live API 2.5 ne sont pas disponibles dans global.

Gemini 3.x et modèles ultérieurs

Lorsque vous utilisez les modèles Gemini 3.x et ultérieurs, Firebase AI Logic est compatible avec les emplacements suivants :

• global
• us
• eu

Pour en savoir plus sur les emplacements disponibles pour chaque modèle, consultez la documentation Google Cloud.

Modèles d'ancienne génération

Lorsque vous utilisez des modèles Gemini plus anciens (comme les modèles 2.5), Firebase AI Logic est compatible avec les emplacements suivants :

Notez que les modèles Gemini Live API 2.5 ne sont pas disponibles dans global.

Pour en savoir plus sur les emplacements disponibles pour chaque modèle, consultez la documentation Google Cloud.

Liste des emplacements précédemment disponibles, mais désormais refusés :

• Aucun établissement n'a encore été refusé