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

Firebase AI LogicGemini API


本頁面的範例假設您已完成「開始使用：透過 Apple 的基礎模型框架存取 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.1-pro-preview (預設)
gemini-3.5-flash (預設)
gemini-3.1-flash-lite (預設)
gemini-3-pro-image-preview (「Nano Banana Pro」) (預設)
gemini-3.1-flash-image-preview (「Nano Banana 2」) (預設)


設定圖片輸出


一般設定


提供意見 如何透過 Apple 的基礎模型框架存取 Gemini API