Các lựa chọn cấu hình khi truy cập vào Gemini API thông qua khung Foundation Models của Apple


Các ví dụ trên trang này giả định rằng bạn đã hoàn tất phần Bắt đầu: Truy cập vào Gemini API thông qua khung Foundation Models của Apple.


Trong mỗi yêu cầu gửi đến một mô hình, bạn có thể gửi kèm một số chế độ cài đặt cấu hình để kiểm soát cách mô hình tạo ra phản hồi. Mỗi mô hình Gemini đều có các lựa chọn cấu hình khác nhau.

Tuỳ thuộc vào chế độ cài đặt, cấu hình sẽ được duy trì trong suốt thời gian tồn tại của geminiLanguageModel hoặc LanguageModelSession. Nếu bạn muốn sử dụng một cấu hình khác, hãy tạo một mô hình hoặc phiên mới bằng cấu hình đó.

Trang này mô tả các lựa chọn cấu hình sau:

Chỉ định chỉ dẫn hệ thống

Hướng dẫn cho hệ thống giống như một "lời nói đầu" mà bạn thêm vào trước khi mô hình tiếp xúc với bất kỳ hướng dẫn nào khác của người dùng cuối. Bạn có thể điều chỉnh hành vi của mô hình dựa trên nhu cầu và trường hợp sử dụng cụ thể của mình.

Chỉ định hướng dẫn hệ thống trên 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."
)

// ...



Thiết lập tư duy (còn gọi là "lý luận")

Bạn có thể định cấu hình mức độ tư duy (còn gọi là suy luận) mà mô hình Gemini có thể thực hiện để tạo câu trả lời. Để biết thông tin chi tiết, các phương pháp hay nhất và trường hợp sử dụng cho tư duy, hãy xem hướng dẫn chung về Tư duy.

Thay vì mức độ tư duy, Apple sử dụng mức độ suy luận. Bạn đặt reasoningLevel trong ContextOptions trên mỗi yêu cầu thông qua 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)
)

// ...

Các giá trị được hỗ trợ cho cấp độ tư duy

Lưu ý những điều sau:

  • Các mô hình Gemini 3.x luôn sử dụng tính năng suy nghĩ; bạn không thể tắt tính năng suy nghĩ cho các mô hình này.
  • Các mô hình Gemini 3.x luôn sử dụng tư duy linh hoạt – mô hình sẽ quyết định thời điểm và mức độ suy nghĩ (tối đa là số lượng đã định cấu hình).

Bảng sau đây liệt kê các cấp độ tư duy (reasoningLevel) mà bạn có thể đặt cho từng mô hình Gemini. Xin lưu ý rằng nếu bạn sử dụng giá trị Gemini (MINIMAL, LOW, MEDIUM, HIGH), thì giá trị đó sẽ tự động được liên kết với phiên bản của Apple.

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

Mô hình sử dụng càng ít mã thông báo càng tốt; gần như không cần suy nghĩ

Việc cần làm có độ phức tạp thấp

Mô hình sử dụng ít mã thông báo hơn; giảm thiểu độ trễ và chi phí

Tác vụ đơn giản và tác vụ có thông lượng cao

Mô hình sử dụng một cách tiếp cận cân bằng

Các nhiệm vụ có độ phức tạp vừa phải

Mô hình sử dụng mã thông báo lên đến mức tối đa

Câu lệnh phức tạp đòi hỏi khả năng suy luận sâu sắc

Gemini 3.x Pro
gemini-3.1-pro-preview
(mặc định)
Gemini 3.x Flash
gemini-3.6-flash
gemini-3.5-flash
(mặc định)
Gemini 3.x Flash‑Lite
gemini-3.5-flash-lite
gemini-3.1-flash-lite
(mặc định)
Gemini 3.x Pro Image
gemini-3-pro-image
("Nano Banana Pro")
(mặc định)
Gemini 3.x Flash Image
gemini-3.1-flash-image
("Nano Banana 2")
(mặc định)
Gemini 3.x Flash‑Lite Image
gemini-3.1-flash-lite-image
("Nano Banana 2 Lite")
(mặc định)



Định cấu hình đầu ra hình ảnh



Cấu hình chung


Gửi ý kiến phản hồi về việc truy cập vào Gemini API thông qua khung Mô hình cơ bản của Apple