| ตัวอย่างในหน้านี้จะถือว่าคุณได้ทำตามขั้นตอนในหัวข้อ เริ่มต้นใช้งาน: เข้าถึง 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: .lightGemini: LOW
|
Apple: .moderateGemini: MEDIUM
|
Apple: .deepGemini: HIGH
|
|
|---|---|---|---|---|
|
โมเดลใช้โทเค็นน้อยที่สุดเท่าที่จะเป็นไปได้ แทบไม่มีการคิด งานที่มีความซับซ้อนต่ำ |
โมเดลใช้โทเค็นน้อยลง ลดเวลาในการตอบสนองและค่าใช้จ่าย งานง่ายๆ และงานที่มีปริมาณงานสูง |
โมเดลใช้แนวทางที่สมดุล งานที่มีความซับซ้อนปานกลาง |
โมเดลใช้โทเค็นจนถึงระดับสูงสุด ข้อความแจ้งที่ซับซ้อนซึ่งต้องใช้การให้เหตุผลอย่างละเอียด |
|
Gemini 3.x Progemini-3.1-pro-preview
|
(ค่าเริ่มต้น) | |||
Gemini 3.x Flashgemini-3.6-flashgemini-3.5-flash
|
(ค่าเริ่มต้น) | |||
Gemini 3.x Flash‑Litegemini-3.5-flash-litegemini-3.1-flash-lite
|
(ค่าเริ่มต้น) | |||
Gemini 3.x Pro Imagegemini-3-pro-image("Nano Banana Pro") |
(ค่าเริ่มต้น) | |||
Gemini 3.x Flash Imagegemini-3.1-flash-image("Nano Banana 2") |
(ค่าเริ่มต้น) | |||
Gemini 3.x Flash‑Lite Imagegemini-3.1-flash-lite-image("Nano Banana 2 Lite") |
(ค่าเริ่มต้น) |
กำหนดค่าเอาต์พุตรูปภาพ
การกำหนดค่าทั่วไป
ส่งความคิดเห็น เกี่ยวกับการเข้าถึง Gemini API ผ่านเฟรมเวิร์กโมเดลพื้นฐานของ Apple