Speicherort für den Zugriff auf das Modell angeben

Die generativen KI-Modelle von Google sind in bestimmten Regionen verfügbar. Sie können auswä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 die Agent Platform Gemini API (formerly Vertex AI) verwendet, optional den Standort enthalten, an dem auf das Modell zugegriffen werden soll. Firebase AI Logic hat standardmäßige Standorteinstellungen.

• Bei Verwendung der neuen Initialisierungssyntax für die Agent Platform: global
• Bei Verwendung der älteren Initialisierungssyntax für Vertex AI: us-central1

Für fast alle Gemini Modelle unterstützt die Agent Platform Gemini API (formerly Vertex AI) den Standort global. Das bedeutet, dass Ihre Anfrage von einem verfügbaren Modell im globalen Pool verarbeitet wird. Wenn Sie für Ihre Anfragen den Standort global verwenden, können Sie Kapazitätslimits für das Modell vermeiden und die Anzahl der Fehler vom Typ „Dienst überlastet“ (503) reduzieren. Je nach Modell kann die Verwendung des Standorts global auch erforderlich sein.

Wann muss ein Standort explizit festgelegt werden?

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

Je nach Modell kann die explizite Festlegung eines Standorts erforderlich sein. Wenn Ihre Anfrage versucht, auf ein Modell an einem Standort zuzugreifen, an dem es nicht verfügbar ist, wird ein 404-Fehler zurückgegeben, der besagt, dass das Modell was not found or your project does not have access to it.

• Gemini Gemini- und Testmodelle: Nur am Standort global verfügbar (außer für Live API Modelle, siehe unten).

• Gemini 3.x Modelle: Nur verfügbar am Standort global bei Verwendung von Firebase AI Logic. 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 (wenn Ihr Modell den Standort global unterstützt).

• Sie können Firebase Remote Config verwenden, um den Standort 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 geeignet oder nicht unterstützt wird, sollten Sie explizit festlegen, wo Sie auf Modelle zugreifen. Sie können den Standort beispielsweise anhand des Standorts des Endnutzers festlegen, indem Sie Firebase Remote Config verwenden.

Codebeispiele

Firebase AI Logic hat automatische Standardwerte für den Standort (z. B. global bei Verwendung der Initialisierungssyntax für die Agent Platform). Wenn Sie jedoch einen anderen Standort verwenden müssen oder möchten, müssen Sie den Standort bei der Initialisierung 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 europe-west4) 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 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`.
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, wird ein 404-Fehler zurückgegeben, der besagt, 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 Generative AI on Agent Platform angeben.

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

Wichtige Hinweise:

• Firebase AI Logic verwendet standardmäßig den Standort us-central1.

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

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

• Für alle Live API Modelle und alle Imagen Modelle wird der global Standort nicht unterstützt.