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 où accéder au modèle en fonction de vos exigences en matière 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 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 l'emplacement global

Pour presque tous les Gemini modèles, le Agent Platform Gemini API (formerly Vertex AI) propose un global emplacement, 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 car il s'agit du seul emplacement disponible pour le modèle (par exemple, un modèle Gemini en preview).

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 backend Agent Platform Gemini API (formerly Vertex AI) dans votre code.

Selon le modèle, il peut être obligatoire de définir explicitement un emplacement. 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 en preview et expérimentaux : disponibles uniquement dans l'emplacement global.

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

• Gemini 2.5 modèles : 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 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 le modèle est disponible dans 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 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 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 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. 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 les emplacements suivants 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

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

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

• Gemini 2.5 modèles : 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 versions ultérieures

Lorsque vous utilisez les modèles Gemini 3.x et versions ultérieures, 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 Google Cloud documentation.

Modèles de génération antérieure

Lorsque vous utilisez d'anciens Gemini modèles (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 Google Cloud documentation.

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

• Aucun emplacement n'a encore été désactivé