ตัวเลือกการกำหนดค่าเมื่อเข้าถึง Gemini API ผ่านเฟรมเวิร์กโมเดลพื้นฐานของ Apple


ตัวอย่างในหน้านี้ถือว่าคุณได้ทำตาม เริ่มต้นใช้งาน: เข้าถึง Gemini API ผ่านเฟรมเวิร์ก Foundation Models ของ Apple แล้ว


ในแต่ละคำขอที่ส่งไปยังโมเดล คุณสามารถส่งการตั้งค่าการกำหนดค่าบางอย่างเพื่อ ควบคุมวิธีที่โมเดลสร้างคำตอบได้ Geminiแต่ละรุ่นมี ตัวเลือกการกำหนดค่าที่แตกต่างกัน

การกำหนดค่าจะยังคงอยู่ตลอดอายุการใช้งานของ geminiLanguageModel หรือ LanguageModelSession ทั้งนี้ขึ้นอยู่กับการตั้งค่า หากต้องการ ใช้การกำหนดค่าอื่น ให้สร้างโมเดลหรือเซสชันใหม่ด้วยการกำหนดค่านั้น

หน้านี้อธิบายตัวเลือกการกำหนดค่าต่อไปนี้

ระบุคำสั่งของระบบ

คำสั่งของระบบเปรียบเสมือน "คำนำ" ที่คุณเพิ่มก่อนที่โมเดลจะได้รับ คำสั่งเพิ่มเติมจากผู้ใช้ปลายทาง ซึ่งช่วยให้คุณกำหนด ลักษณะการทำงานของโมเดลตามความต้องการและ Use Case ที่เฉพาะเจาะจงได้

ระบุวิธีการของระบบใน 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 ใช้ระดับการให้เหตุผลแทนระดับการคิด คุณตั้งค่า reasoningLevel ใน ContextOptions ในคำขอแต่ละรายการผ่าน 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)
)

// ...

ค่าระดับการคิดที่รองรับ

โปรดทราบดังต่อไปนี้

  • โมเดล Gemini 3.x จะใช้การคิดเสมอ คุณปิดหรือ ปิดการคิดสำหรับโมเดลเหล่านี้ไม่ได้
  • โมเดล Gemini 3.x จะใช้การคิดแบบไดนามิกเสมอ ซึ่งหมายความว่าโมเดลจะตัดสินใจ ว่าเมื่อใดและจะคิดมากน้อยเพียงใดตามจำนวนที่กำหนดค่าไว้

ตารางต่อไปนี้แสดงระดับการคิด (reasoningLevel) ที่คุณตั้งค่าได้สำหรับโมเดล Gemini แต่ละรายการ โปรดทราบว่าหากคุณใช้ค่า 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.5-flash 		(ค่าเริ่มต้น)
Gemini 3.x 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") 		(ค่าเริ่มต้น)


กำหนดค่าเอาต์พุตรูปภาพ


การกำหนดค่าทั่วไป


แสดงความคิดเห็น เกี่ยวกับการเข้าถึง Gemini API ผ่านเฟรมเวิร์กโมเดลพื้นฐานของ Apple