Speicherort für den Zugriff auf das Modell angeben

Die generativen KI-Modelle von Google sind in bestimmten Regionen verfügbar. Sie können wählen, wo Sie auf das Modell zugreifen möchten, damit Ihre Anforderungen an Compliance, Latenz, Verfügbarkeit und Langlebigkeit erfüllt werden.

Wenn Sie Firebase AI Logic verwenden, kann jede Ihrer Anfragen, die Agent Platform Gemini API (formerly Vertex AI) verwenden, optional den Standort für den Zugriff auf das Modell enthalten. Firebase AI Logic hat standardmäßige Standorteinstellungen.

• Bei Verwendung der neuen Initialisierungssyntax für die Agent Platform: global
• Bei Verwendung der alten Initialisierungssyntax für „Vertex AI“: us-central1

Informationen zum global-Standort

Bei fast allen Gemini-Modellen bietet die Agent Platform Gemini API (formerly Vertex AI) einen global-Standort. Das bedeutet, dass Ihre Anfrage von einem verfügbaren Modell an einem beliebigen Ort im globalen Pool bearbeitet wird.

Wenn Sie den Standort global für Ihre Anfragen verwenden, können Sie Kapazitätsbeschränkungen für das Modell vermeiden und die Anzahl der Fehler vom Typ „Dienst überlastet“ (503) reduzieren. Je nach Modell ist die Verwendung des Standorts global möglicherweise erforderlich, da dies der einzige verfügbare Standort für das Modell ist (z. B. ein Gemini-Vorschaumodell).

Wann muss ein Standort explizit festgelegt werden?

Firebase AI Logic hat automatische Standardwerte für den Standort (z. B. global bei Verwendung der Initialisierungssyntax „Agent Platform“). Wenn Sie jedoch einen anderen Standort verwenden müssen oder möchten, müssen Sie den Standort beim Initialisieren des Agent Platform Gemini API (formerly Vertex AI)-Backend-Dienstes in Ihrem Code explizit angeben.

Je nach Modell ist es möglicherweise erforderlich, einen Standort explizit festzulegen. Wenn in Ihrer Anfrage versucht wird, auf ein Modell an einem Standort zuzugreifen, an dem es nicht verfügbar ist, erhalten Sie einen 404-Fehler mit der Meldung, dass das Modell was not found or your project does not have access to it.

• Gemini-Modelle in der Vorschau und experimentelle Modelle:Nur am Standort global verfügbar.

• Gemini 3.x Stabile Modelle:Verfügbar am Standort global und häufig auch an den Standorten us und eu.

• Gemini 2.5-Modelle:An vielen Standorten verfügbar. Gemini Live API-Modelle der Version 2.5 sind in global nicht verfügbar.

Eine Liste aller verfügbaren Standorte finden Sie weiter unten auf dieser Seite.

Allgemeine Fakten und Best Practices

Hier sind einige wichtige Fakten und Best Practices zu Standorten:

• Kapazitätslimits gelten pro Modell, pro Region und pro Minute.

• Um unerwartete Kapazitätslimits zu vermeiden, sollten Sie den Standort global verwenden, sofern das Modell dort global verfügbar ist.

• Verwenden Sie Firebase Remote Config, um den Ort zu steuern, an dem Sie auf das Modell zugreifen. So können Sie den Standort ändern, ohne eine neue Version Ihrer App zu veröffentlichen.

• Wenn die Verwendung des Standorts global für Ihren Anwendungsfall nicht infrage kommt, sollten Sie explizit angeben, wo Sie auf ein Modell zugreifen (sofern das Modell an anderen Standorten als global verfügbar ist). Sie können den Standort beispielsweise anhand des Standorts des Endnutzers mit Firebase Remote Config festlegen.

Codebeispiele

Firebase AI Logic hat automatische Standardeinstellungen für den Standort (z. B. global bei Verwendung der Initialisierungssyntax „Agent Platform“). Wenn Sie jedoch einen anderen Standort verwenden müssen oder möchten, müssen Sie den Standort beim Initialisieren des Agent Platform Gemini API (formerly Vertex AI)-Backend-Dienstes in Ihrem Code explizit angeben.

Ersetzen Sie LOCATION durch den Standortcode (z. B. global oder us-central1) aus der Liste der verfügbaren Standorte weiter unten auf dieser Seite.

// ...

// 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"));

// ...

Wenn Sie einen Standort angeben, an dem das Modell nicht verfügbar ist, erhalten Sie einen 404-Fehler mit der Meldung, dass das Modell was not found or your project does not have access to it.

Verfügbare Standorte

Google Cloud verwendet Regionen. Google Cloud speichert Kundendaten nur in der Region, die Sie für alle allgemein verfügbaren Funktionen von generativer KI in Agent Platform angeben.

Generative AI in Agent Platform ist in den folgenden Regionen verfügbar. Einige Modelle und/oder bestimmte Versionen sind möglicherweise nicht an allen Standorten verfügbar. (Die Verfügbarkeit an bestimmten Standorten finden Sie in der Google Cloud-Dokumentation.)

Wichtige Hinweise:

• Firebase AI Logic wird standardmäßig an den folgenden Speicherorten gespeichert:

  • Bei Verwendung der neuen Initialisierungssyntax für die Agent Platform: global
  • Bei Verwendung der alten Initialisierungssyntax für „Vertex AI“: us-central1

• Gemini-Modelle in der Vorschau und experimentelle Modelle:Nur am Standort global verfügbar.

• Gemini 3.x Stabile Modelle:Verfügbar am Standort global und häufig auch an den Standorten us und eu.

• Gemini 2.5-Modelle:An vielen Standorten verfügbar. Gemini Live API-Modelle der Version 2.5 sind in global nicht verfügbar.

Gemini 3.x und spätere Modelle

Wenn Sie Gemini 3.x und spätere Modelle verwenden, unterstützt Firebase AI Logic die folgenden Standorte:

• global
• us
• eu

Details zu den verfügbaren Standorten für jedes Modell finden Sie in der Dokumentation zu Google Cloud.

Modelle der älteren Generation

Bei älteren Gemini-Modellen (z. B. 2.5-Modellen) unterstützt Firebase AI Logic die folgenden Standorte:

Gemini Live API-Modelle der Version 2.5 sind in global nicht verfügbar.

Details zu den verfügbaren Standorten für jedes Modell finden Sie in der Dokumentation zu Google Cloud.

Liste der zuvor verfügbaren, aber jetzt deaktivierten Standorte:

• Es wurden noch keine Standorte abgelehnt