Konfigurationsoptionen für den Zugriff auf die Gemini API über das Foundation Models-Framework von Apple

Vorschau: Der Zugriff auf Gemini API über das Foundation Models-Framework von Apple mit Firebase AI Logic befindet sich derzeit in der öffentlichen Vorschau. Das bedeutet, dass es keinem SLA oder keiner Richtlinie zur Einstellung von Produkten und Diensten unterliegt und sich nicht abwärtskompatibel ändern kann.
Außerdem basiert diese Integration auf Beta-APIs. Apps, die sie verwenden, können erst im App Store eingereicht werden, wenn die nächste Xcode-Version die allgemeine Verfügbarkeit (General Availability, GA) erreicht und Produktionsübermittlungen unterstützt.

Bei den Beispielen auf dieser Seite wird davon ausgegangen, dass Sie die Anleitung Erste Schritte: Über das Foundation Models-Framework von Apple auf Gemini API zugreifen durchgearbeitet haben.

In jeder Anfrage an ein Modell können Sie einige Konfigurationseinstellungen senden, um zu steuern, wie das Modell eine Antwort generiert. Für jedes Gemini-Modell sind unterschiedliche Konfigurationsoptionen verfügbar.

Je nach Einstellung bleibt die Konfiguration für die Lebensdauer des geminiLanguageModel oder des LanguageModelSession erhalten. Wenn Sie eine andere Konfiguration verwenden möchten, erstellen Sie ein neues Modell oder eine neue Sitzung mit dieser Konfiguration.

Auf der Seite werden die folgenden Konfigurationsoptionen beschrieben:

• Systemanweisungen
• Nachdenken (auch „Schlussfolgern“)
• Ausgabe generierter Bilder
• Allgemeine Konfiguration

Systemanweisungen angeben

Systemanweisungen sind wie eine „Präambel“, die Sie hinzufügen, bevor das Modell für weitere Anweisungen des Endnutzers freigegeben wird. Sie können das Verhalten des Modells basierend auf Ihren spezifischen Anforderungen und Anwendungsfällen steuern.

Geben Sie auf der LanguageModelSession Systemanweisungen an:

// ...

// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")

// Specify the system instructions as part of creating the session
let session = LanguageModelSession(
    model: model,
    instructions: "You are a cat. Your name is Neko."
)

// ...

---

Denkprozesse (auch als „Schlussfolgerungen“ bezeichnet) konfigurieren

Sie können die Menge an Denkarbeit (auch Begründung genannt) konfigurieren, die ein Gemini-Modell leisten kann, um seine Antwort zu generieren. Weitere Informationen, Best Practices und Anwendungsfälle für das Denken finden Sie im allgemeinen Leitfaden Thinking.

Anstelle von thinking level (Denkebene) verwendet Apple reasoning level (Schlussfolgerungsebene). Sie legen die reasoningLevel in ContextOptions bei jeder Anfrage über eine LanguageModelSession fest:

// ...

// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")

let session = LanguageModelSession(model: model)

// Specify the reasoning level when generating a response
// Possible reasoningLevels: .light, .moderate, .deep, .custom("minimal")
let response = try await session.respond(
  to: "Write a story about a magic backpack.",
  contextOptions: ContextOptions(reasoningLevel: .REASONING_LEVEL)
)

// ...

Unterstützte Werte für den Denkaufwand

Wichtige Hinweise:

• Gemini 3.x-Modelle verwenden immer die Denkweise. Sie können die Denkweise für diese Modelle nicht deaktivieren oder ausschalten.
• Gemini 3.x-Modelle verwenden immer dynamisches Denken. Das Modell entscheidet, wann und wie viel es bis zum konfigurierten Betrag denkt.

In der folgenden Tabelle sind die Denkebenen (reasoningLevel) aufgeführt, die Sie für jedes Gemini-Modell festlegen können. Wenn Sie einen Gemini-Wert verwenden (MINIMAL, LOW, MEDIUM, HIGH), wird dieser automatisch der Apple-Version dieses Werts zugeordnet.

	Apple: .custom("minimal") Gemini: MINIMAL	Apple: .light Gemini: LOW	Apple: .moderate Gemini: MEDIUM	Apple: .deep Gemini: HIGH
	Das Modell verwendet so wenige Tokens wie möglich; es gibt kaum Denkprozesse. Aufgaben mit geringer Komplexität	Das Modell verwendet weniger Tokens, was die Latenz und die Kosten minimiert. Einfache Aufgaben und Aufgaben mit hohem Durchsatz	Das Modell verfolgt einen ausgewogenen Ansatz. Aufgaben mittlerer Komplexität	Das Modell verwendet Tokens bis zum maximalen Limit. Komplexe Prompts, die tiefes Schlussfolgern erfordern
Gemini 3.x Pro gemini-3.1-pro-preview				(Standard)
Gemini 3.x Flash gemini-3.5-flash			(Standard)
Gemini 3.x Flash‑Lite gemini-3.1-flash-lite	(Standard)
Gemini 3.x Pro Image gemini-3-pro-image ("Nano Banana Pro")				(Standard)
Gemini 3.x Flash Image gemini-3.1-flash-image ("Nano Banana 2")				(Standard)
Gemini 3.x Flash‑Lite Image gemini-3.1-flash-lite-image ("Nano Banana 2 Lite")	(Standard)

Hinweis :Gemini-Modelle unterstützen auch Zusammenfassungen von Gedanken. Beispiele für diese Funktion bei Verwendung des Foundation Models-Frameworks von Apple sind bald verfügbar.

---

Bildausgabe konfigurieren

Hinweis :Gemini-Modelle zur Bildgenerierung (z. B. „Nano Banana“-Modelle) unterstützen die Konfiguration der Bildausgabe für Seitenverhältnis und Bildgröße. Beispiele für diese Funktion bei Verwendung des Foundation Models-Frameworks von Apple sind bald verfügbar.

---

Allgemeine Konfiguration

Hinweis :Gemini-Modelle unterstützen allgemeine Konfigurationen, z. B. das Festlegen der maximalen Anzahl von Ausgabetokens und der Anzahl der generierten Antwortvariationen. Beispiele für diese Funktion bei Verwendung des Foundation Models-Frameworks von Apple sind bald verfügbar.

Feedback geben zum Zugriff auf Gemini API über das Foundation Models-Framework von Apple