通过 Apple 的 Foundation Models 框架访问 Gemini API 时的配置选项

预览版：通过 Apple 的 Foundation Models 框架使用 Firebase AI Logic 访问 Gemini API 的功能目前处于预览版阶段，这意味着它不受任何服务等级协议 (SLA) 或弃用政策的约束，并且可能会以不向后兼容的方式更改。

本页面中的示例假定您已完成使用入门：通过 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 在每个请求的 ContextOptions 中设置 reasoningLevel：

// ...

// 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
	模型使用尽可能少的 token；几乎不进行思考 低复杂度任务	模型使用的词元更少，可最大限度地降低延迟时间和费用 简单任务和高吞吐量任务	模型采用平衡的方法 中等复杂度的任务	模型使用的 token 数量达到上限 需要深度推理的复杂提示
Gemini 4 Argon gemini-4-argon	^1		（默认）
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 Nano Banana 2.1 gemini-nano-banana-2.1			（默认）
Gemini Nano Banana 2 gemini-3.1-flash-image				（默认）
Gemini Nano Banana 2 Lite gemini-3.1-flash-lite-image	（默认）
Gemini Nano Banana Pro gemini-3-pro-image				（默认）

^{1 gemini-4-argon、gemini-3.8-flash 和 gemini-3.7-flash 不支持 MINIMAL 思考等级。如果您将思考等级设置为 MINIMAL，请求将失败并显示 400 错误。}

注意： Gemini 模型还支持思考摘要。使用 Apple 的 Foundation Models 框架时，此功能的示例即将推出！

---

配置图片输出

注意： Gemini Nano Banana 模型支持为图片输出配置宽高比和图片大小。我们即将推出使用 Apple 的 Foundation Models 框架时此功能的示例！

---

常规配置

注意： 将 Apple 的 Foundation Models 框架与 Firebase AI Logic 搭配使用时，您可以为 Gemini 模型配置输出词元数上限。此功能的示例即将推出！

提供反馈，说明通过 Apple 的 Foundation Models 框架访问 Gemini API 的体验