透過 Apple 的基礎模型架構存取 Gemini API 時的設定選項


本頁的範例假設您已完成「開始使用：透過 Apple 的 Foundation Models 架構存取 Gemini API」。


在傳送給模型的每個要求中，您可以一併傳送一些設定，藉此控制模型生成回覆的方式。每種 Gemini 型號都提供不同的設定選項。

視設定而定，設定會保留至 geminiLanguageModel 或 LanguageModelSession 的生命週期結束為止。如要使用其他設定，請建立採用該設定的新模型或工作階段。

這個頁面說明下列設定選項：

指定系統指令

系統指令就像「前導提示」，您可以在模型接收使用者提供的任何進一步指令前，先加入這類指令。您可以根據特定需求和用途，引導模型行為。

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

// ...


設定思考 (又稱「推論」)

您可以設定 Gemini 模型生成回覆時的「思考」 (也稱為「推理」) 程度。如要瞭解思考模式的詳細資料、最佳做法和用途，請參閱一般「思考」指南。

Apple 使用「推理程度」，而非「思考程度」。您可以在每項要求中，透過 LanguageModelSession 設定 reasoningLevel 的 ContextOptions：

// ...

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

// ...

支援的思考程度值

注意事項：

  • Gemini 3.x 模型一律會使用思考功能，你無法停用或關閉這些模型的思考功能。
  • Gemini 3.x 模型一律使用動態思考，也就是模型會決定思考的時間和程度，但不會超過設定的數量。

下表列出可為每個 Gemini 模型設定的思考層級 (reasoningLevel)。請注意，如果您使用 Gemini 值 (MINIMAL、LOW、MEDIUM、HIGH)，系統會自動將該值對應至 Apple 版本。

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

模型會盡量減少使用詞元，幾乎不會思考

低複雜度工作

模型使用的權杖較少，可盡量縮短延遲時間並降低成本

簡單工作和高輸送量工作

模型採用攻守平衡策略

中等複雜度的工作

模型使用的權杖數量達到上限

需要深入推論的複雜提示

Gemini 3.x Pro
gemini-3.1-pro-preview 		(預設)
Gemini 3.x Flash
gemini-3.8-flash
gemini-3.7-flash
gemini-3.6-flash
gemini-3.5-flash
「gemini-3.8-flash」或「gemini-3.7-flash」不支援 1 		(預設)
Gemini 3.x Flash‑Lite
gemini-3.5-flash-lite
gemini-3.1-flash-lite 		(預設)
Gemini 3.x Pro Image
gemini-3-pro-image
("Nano Banana Pro") 		(預設)
Gemini 3.x Flash Image
gemini-3.1-flash-image
("Nano Banana 2") 		(預設)
Gemini 3.x Flash‑Lite Image
gemini-3.1-flash-lite-image
("Nano Banana 2 Lite") 		(預設)

1 gemini-3.8-flash 和 gemini-3.7-flash不支援 MINIMAL 思考程度。如果將思考程度設為 MINIMAL，要求會失敗並顯示 400 錯誤。


設定圖片輸出


一般設定


提供意見回饋 ，說明如何透過 Apple 的基礎模型架構存取 Gemini API