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

Bei fast allen Gemini-Modellen unterstützt 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 verarbeitet wird. Wenn Sie den Standort global für Ihre Anfragen verwenden, können Sie vermeiden, dass die Kapazitätsgrenzen für das Modell erreicht werden, und die Anzahl der Fehler vom Typ „Dienst überlastet“ (503) verringern. Je nach Modell ist die Verwendung des global-Standorts möglicherweise erforderlich.

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 (mit Ausnahme von Live API-Modellen, siehe unten).

• Gemini 3.x-Modelle: Nur am Standort global verfügbar, wenn Firebase AI Logic verwendet wird. Firebase AI Logic unterstützt die Standorte us und eu noch nicht.

• Gemini 2.5-Modelle: An vielen Standorten verfügbar.

• Gemini Live API-Modelle: Nur am Standort us-central1 verfügbar. Der Standort global wird nicht unterstützt.

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 Ihr Modell diesen global Standort unterstützt.

• 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 von global für Ihren Anwendungsfall nicht anwendbar oder nicht unterstützt wird, sollten Sie explizit angeben, wo Sie auf Modelle zugreifen. 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 Orten platziert:

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

• Für alle Gemini-Vorschaumodelle (außer Live API-Modelle) ist der einzige unterstützte Standort global.

• Wenn Sie mit Firebase AI Logic auf Gemini 3.x-Modelle zugreifen, ist der einzige unterstützte Standort global. Firebase AI Logic unterstützt die Standorte us und eu noch nicht.

• Bei allen Live API-Modellen wird der Standort global nicht unterstützt.

Gemini 3.x und spätere Modelle

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

• global

Die Unterstützung für die Standorte us und eu folgt demnächst.

Modelle der älteren Generation

Wenn Sie ältere Gemini-Modelle mit Firebase AI Logic verwenden, werden die folgenden Standorte unterstützt:

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

• Es wurden noch keine Standorte abgelehnt