ตัวเลือกการกำหนดค่าเมื่อเข้าถึง 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.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") (ค่าเริ่มต้น)



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



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


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