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 exigences en termes 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 la position pour accéder 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

À propos de la position 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 "service surchargé" (503). De plus, selon le modèle, l'utilisation de l'emplacement global peut être obligatoire, car il s'agit du seul emplacement disponible pour le modèle (par exemple, un modèle Gemini en version bêta).

Quand est-il nécessaire de définir explicitement une position ?

Firebase AI Logic comporte des 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 l'indiquer explicitement lors de l'initialisation du service de backend Agent Platform Gemini API (formerly Vertex AI) dans votre code.

Selon le modèle, il peut être nécessaire de définir explicitement un lieu. Si votre requête tente d'accéder à un modèle dans un emplacement où il n'est pas disponible, une erreur 404 s'affiche, indiquant que le modèle was not found or your project does not have access to it.

• Gemini Modèles en version bêta et expérimentaux : disponibles uniquement dans la région global.

• Modèles stables 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 pays. 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 points clés et bonnes pratiques concernant les lieux :

• 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 la position sans publier de nouvelle version de votre application.

• Si l'utilisation de l'emplacement global ne s'applique pas à 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 celui de l'utilisateur final à l'aide de Firebase Remote Config.

Exemples de code

Firebase AI Logic comporte des 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 l'indiquer explicitement lors de l'initialisation du service de backend Agent Platform Gemini API (formerly Vertex AI) dans votre code.

Remplacez LOCATION par le code de localisation (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-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 en disponibilité générale d'IA générative sur Agent Platform.

L'IA générative sur Agent Platform est disponible dans les régions suivantes. Il est possible que certains modèles et/ou certaines versions spécifiques ne soient pas disponibles dans toutes les régions (pour connaître la disponibilité détaillée par région, consultez la documentation Google Cloud).

Veuillez noter les points suivants :

• Firebase AI Logic est défini par défaut sur 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

• Gemini Modèles en version bêta et expérimentaux : disponibles uniquement dans la région global.

• Modèles stables 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 pays. 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 versions ultérieures, Firebase AI Logic est compatible avec les zones géographiques suivantes :

• 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 d'anciens modèles Gemini (comme les modèles 2.5), Firebase AI Logic est compatible avec les lieux 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 pays où la fonctionnalité était disponible, mais où elle a été supprimée :

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