Opcje konfiguracji podczas uzyskiwania dostępu do interfejsu Gemini API za pomocą platformy modeli podstawowych Apple


Przykłady na tej stronie zakładają, że masz już za sobą sekcję Pierwsze kroki: dostęp do Gemini API za pomocą platformy Foundation Models firmy Apple.


W każdym żądaniu wysyłanym do modelu możesz przesłać ustawienia konfiguracji, które określają, jak model ma generować odpowiedź. Każdy Gemini model oferuje inne opcje konfiguracji.

W zależności od ustawienia konfiguracja jest zachowywana przez cały okres istnienia geminiLanguageModel lub LanguageModelSession. Jeśli chcesz użyć innej konfiguracji, utwórz nowy model lub sesję z tą konfiguracją.

Na tej stronie opisujemy te opcje konfiguracji:

Określanie instrukcji systemowych

Instrukcje systemowe są jak „preambuła”, którą dodajesz, zanim model zostanie udostępniony użytkownikowi końcowemu. Pozwalają one sterować zachowaniem modelu na podstawie konkretnych potrzeb i przypadków użycia.

Określ instrukcje systemowe w LanguageModelSession:

// ...

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

// ...



Konfigurowanie myślenia (inaczej „rozumowania”)

Możesz skonfigurować ilość myślenia (inaczej rozumowania), jaką model Gemini może wykonać, aby wygenerować odpowiedź. Więcej informacji, sprawdzonych metod i przypadków użycia myślenia znajdziesz w ogólnym przewodniku po myśleniu.

Zamiast poziomu myślenia Apple używa poziomu rozumowania. Ustaw reasoningLevel w ContextOptions w każdym żądaniu za pomocą LanguageModelSession:

// ...

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

// ...

Obsługiwane wartości poziomu myślenia

Pamiętaj:

  • Modele Gemini 3.x zawsze używają myślenia. Nie możesz wyłączyć ani wyłączyć myślenia w przypadku tych modeli.
  • Modele Gemini 3.x zawsze używają myślenia dynamicznego – model decyduje kiedy i ile myśli, aż do skonfigurowanej ilości.

W tabeli poniżej znajdziesz poziomy myślenia (reasoningLevel), które możesz ustawić dla każdego Gemini modelu. Pamiętaj, że jeśli użyjesz wartości Gemini (MINIMAL, LOW, MEDIUM, HIGH), zostanie ona automatycznie przypisana do wersji Apple tej wartości.

Apple: .custom("minimal")
Gemini: MINIMAL
Apple: .light
Gemini: LOW
Apple: .moderate
Gemini: MEDIUM
Apple: .deep
Gemini: HIGH

Model używa jak najmniejszej liczby tokenów; prawie nie myśli

Zadania o niskim stopniu złożoności

Model używa mniejszej liczby tokenów; minimalizuje opóźnienie i koszty

Proste zadania i zadania o dużej przepustowości

Model stosuje zrównoważone podejście

Zadania o średnim stopniu złożoności

Model używa tokenów do maksymalnego poziomu

Złożone prośby wymagające głębokiego rozumowania

Gemini 3.x Pro
gemini-3.1-pro-preview
(domyślnie)
Gemini 3.x Flash
gemini-3.6-flash
gemini-3.5-flash
(domyślnie)
Gemini 3.x Flash‑Lite
gemini-3.5-flash-lite
gemini-3.1-flash-lite
(domyślnie)
Gemini 3.x Pro Image
gemini-3-pro-image
(„Nano Banana Pro”)
(domyślnie)
Gemini 3.x Flash Image
gemini-3.1-flash-image
(„Nano Banana 2”)
(domyślnie)
Gemini 3.x Flash‑Lite Image
gemini-3.1-flash-lite-image
(„Nano Banana 2 Lite”)
(domyślnie)



Konfigurowanie obrazu wyjściowego



Konfiguracja ogólna


Prześlij opinię na temat dostępu do Gemini API za pomocą platformy Foundation Models firmy Apple