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


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


ในคำขอแต่ละรายการที่ส่งไปยังโมเดล คุณสามารถส่งการตั้งค่าการกำหนดค่าบางอย่างเพื่อควบคุมวิธีที่โมเดลสร้างการตอบกลับ โมเดล 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 ใช้ ระดับการให้เหตุผล แทน ระดับการคิด คุณตั้งค่า 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.6-flash
gemini-3.5-flash
(ค่าเริ่มต้น)
Gemini 3.x Flash‑Lite
gemini-3.5-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