เริ่มต้นใช้งาน: เข้าถึง Gemini API ผ่านเฟรมเวิร์ก Foundation Models ของ Apple


ในงาน WWDC 2026 Apple ได้เปิดเฟรมเวิร์กโมเดลพื้นฐานให้กับตัวดัดแปลงโมเดลของบุคคลที่สาม ซึ่งหมายความว่าคุณสามารถเข้าถึงโมเดลที่โฮสต์ในระบบคลาวด์ (เช่น Gemini) ผ่านเฟรมเวิร์กโมเดลพื้นฐานโดยใช้ API เดียวกัน กับที่ใช้เพื่อเข้าถึงโมเดลในอุปกรณ์

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

  • โมเดลในอุปกรณ์มอบความเป็นส่วนตัวสูงสุด ไม่มีค่าใช้จ่าย และรองรับการใช้งานแบบออฟไลน์
  • โมเดล Gemini ที่โฮสต์ในระบบคลาวด์มีหน้าต่างบริบทขนาดใหญ่ ความสามารถขั้นสูง และพลังการให้เหตุผลที่มากขึ้น

คุณเข้าถึงโมเดล Gemini ที่โฮสต์ในระบบคลาวด์ได้ผ่าน เฟรมเวิร์ก Foundation Models ของ Apple โดยใช้ Firebase SDK สำหรับแพลตฟอร์ม Apple ซึ่งก็คือFirebase AI Logic ไลบรารี คู่มือนี้แสดงวิธี เริ่มต้นใช้งาน

คู่มือนี้ยังแสดงวิธีตั้งค่า Firebase App Check เพื่อปกป้องการเข้าถึงโมเดล Gemini ซึ่งเป็นสิ่งสำคัญแม้ในระหว่างการพัฒนา

ข้อกำหนดเบื้องต้น

  • ติดตั้ง Xcode 27 เวอร์ชันเบต้าล่าสุด

  • โปรแกรมจำลองแพลตฟอร์ม Apple หรืออุปกรณ์จริงที่ใช้ ระบบปฏิบัติการเวอร์ชันเบต้าที่เกี่ยวข้อง (เช่น iOS 27 เบต้า)

  • โปรเจ็กต์ Xcode ใหม่ของแอปแพลตฟอร์ม Apple ที่ใช้อินเทอร์เฟซ SwiftUI

รุ่น Gemini ที่รองรับ

การผสานรวมกับเฟรมเวิร์กโมเดลพื้นฐานของ Apple รองรับโมเดลGeminiต่อไปนี้

  • โมเดลอเนกประสงค์

    • gemini-3.1-pro-preview
    • gemini-3.6-flash (และ gemini-3.5-flash รุ่นเก่า)
    • gemini-3.5-flash-lite (และ gemini-3.1-flash-lite รุ่นเก่า)

  • โมเดลสร้างรูปภาพ

    • gemini-3-pro-image (หรือที่รู้จักในชื่อ "Nano Banana Pro")
    • gemini-3.1-flash-image (หรือที่เรียกว่า "Nano Banana 2")
    • gemini-3.1-flash-lite-image (หรือที่เรียกว่า "Nano Banana 2 Lite")

ระบบไม่รองรับโมเดล Gemini Live API และโมเดล Imagen โปรดทราบว่าเราGemini 2.5รองรับโมเดลทางเทคนิค แต่ไม่แนะนำให้ใช้กับโปรเจ็กต์ใหม่ และต้องมีการกำหนดค่าพิเศษที่ไม่ได้กล่าวถึงในคำแนะนำเหล่านี้

ขั้นตอนที่ 1: สร้างโปรเจ็กต์ Firebase

เราขอแนะนำให้เริ่มต้นด้วยโปรเจ็กต์ Firebase ใหม่เพื่อสำรวจการผสานรวมนี้

  1. ลงชื่อเข้าใช้คอนโซล Firebase

  2. คลิกสร้างโปรเจ็กต์ Firebase ใหม่

  3. ทำตามวิธีการบนหน้าจอ คุณไม่จําเป็นต้องเปิดใช้ Google Analytics

ขั้นตอนที่ 2: เชื่อมต่อแอปกับ Firebase

หากต้องการเชื่อมต่อแอปกับ Firebase คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase และเพิ่มไฟล์การกำหนดค่าลงในโค้ดเบส

  1. ที่กึ่งกลางหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า

  2. ลงทะเบียนแอปโดยทำดังนี้

    1. ป้อนรหัสชุดของแอป ตรวจสอบว่าตรงกับรหัสชุดของ โปรเจ็กต์ที่คุณสร้างใน Xcode

    2. คลิกลงทะเบียนแอป

  3. เพิ่มไฟล์กำหนดค่า Firebase ไฟล์นี้มีการตั้งค่าสำหรับ Firebase SDK เพื่อเชื่อมต่อกับ โปรเจ็กต์ Firebase ของคุณ

    1. คลิกดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์ การกำหนดค่า

    2. ย้าย GoogleService-Info.plist ไปยังรูทของโปรเจ็กต์ Xcode แล้วเพิ่ม ไปยังเป้าหมายทั้งหมด

    3. คลิกถัดไปในคอนโซล Firebase

  4. เวิร์กโฟลว์ในคอนโซลมีวิธีการทั่วไปสําหรับการเพิ่ม Firebase SDK ลงในแอปของคุณ ให้ข้ามไปยังขั้นตอนถัดไปในคําแนะนํานี้ เพื่อดูวิธีการเฉพาะสําหรับ Firebase AI Logic

ขั้นตอนที่ 3: เพิ่มไลบรารี Firebase และเริ่มต้น Firebase ในแอป

  1. ใช้ Swift Package Manager เพื่อเพิ่มไลบรารี Firebase ที่จำเป็น

    1. เปิดโปรเจ็กต์แอปใน Xcode แล้วเลือกไฟล์ > เพิ่มแพ็กเกจ

    2. ป้อน URL ของที่เก็บ Firebase Apple SDK ดังนี้

      https://github.com/firebase/firebase-ios-sdk

    3. เลือกกฎการขึ้นต่อกันเป็น Branch แล้วป้อน wwdc26-preview

    4. คลิกเพิ่มแพ็กเกจ Xcode จะแก้ไขและดาวน์โหลดทรัพยากร Dependency

    5. เมื่อได้รับข้อความแจ้ง ให้เพิ่มไลบรารี FirebaseAILogic และ FirebaseAppCheck ลงในเป้าหมายแอป

  2. เริ่มต้น Firebase เมื่อแอปของคุณเริ่มขึ้นโดยเพิ่มโค้ดต่อไปนี้ลงในจุดแรกเข้าหลักของแอป

    import SwiftUI
import FirebaseCore

@main
struct YourApp: App {
  init() {
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

ขั้นตอนที่ 4: เปิดใช้และรักษาความปลอดภัยของบริการ Firebase

ตอนนี้แอปได้รับการกำหนดค่าให้ใช้ Firebase แล้ว คุณต้องเปิดใช้Firebase AI LogicบริการFirebase App Checkและปกป้องการเข้าถึง API ที่เชื่อมโยงโดยใช้ Firebase AI LogicFirebase App Check

ขั้นตอนที่ 4ก: ตั้งค่า Firebase AI Logic ในโปรเจ็กต์ Firebase

  1. ในFirebaseคอนโซล ให้ไปที่บริการ AI > ตรรกะ AI

  2. คลิกเริ่มต้นใช้งานเพื่อเปิดเวิร์กโฟลว์การตั้งค่าแบบมีคำแนะนำ

  3. เมื่อระบบขอให้เลือก "ผู้ให้บริการ Gemini API" เราขอแนะนำให้เลือก Gemini Developer API ซึ่งช่วยให้คุณเริ่มต้นใช้งานได้อย่างรวดเร็วโดยไม่มีค่าใช้จ่าย

    คุณสามารถตั้งค่า Vertex AI Gemini API (และข้อกำหนดสำหรับการเรียกเก็บเงิน) ได้ทุกเมื่อ

  4. ทําตามขั้นตอนในเวิร์กโฟลว์เพื่อตั้งค่า API ที่จําเป็นและบริการที่เกี่ยวข้อง สําหรับ Firebase AI Logic

    ตั้งแต่ต้นเดือนกรกฎาคม 2026 เป็นต้นไป ขั้นตอนนี้ของเวิร์กโฟลว์จะบังคับใช้ Firebase App Check สำหรับ AI Logic โดยอัตโนมัติ ซึ่งเป็นบริการที่สำคัญที่จะช่วยปกป้อง Gemini API เมื่อมีการเข้าถึงโดยตรงจากแอปของคุณ ในขั้นตอนการเริ่มต้นใช้งาน (ดูขั้นตอนในส่วนถัดไปของคู่มือนี้) คุณจะต้องกำหนดค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่อง สำหรับการพัฒนาในเครื่องเมื่อมีการบังคับใช้ App Check

ขั้นตอนที่ 4b: กำหนดค่าผู้ให้บริการแก้ไขข้อบกพร่อง App Check สำหรับการพัฒนาในเครื่อง

สำหรับการพัฒนาในเครื่อง คุณต้องกำหนดค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่อง เพื่อข้ามการรับรองในขณะที่ยังคงบังคับใช้ App Check

  1. ในโปรเจ็กต์ Xcode ให้นำเข้า FirebaseAppCheck และเริ่มต้น App Check ด้วยโรงงานผู้ให้บริการแก้ไขข้อบกพร่องก่อนกำหนดค่า Firebase

    import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  2. รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้

    1. เปิดแอปในโปรแกรมจำลองหรือบนอุปกรณ์ทดสอบ

    2. เปิดคอนโซล Xcode แล้วมองหาApp Checkโทเค็นการแก้ไขข้อบกพร่อง เช่น

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)

  3. ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้

    1. ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป

    2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง

    3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ

ขั้นตอนที่ 5: เริ่มต้นบริการ AI Logic ในแอป

คลิกผู้ให้บริการ Gemini API เพื่อดูเนื้อหาและโค้ดเฉพาะของผู้ให้บริการ ในหน้านี้

เมื่อกำหนดค่า Firebase และ App Check แล้ว คุณจะเริ่มต้นใช้บริการ Firebase AI Logic ในแอปได้

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-3.6-flash")

ขั้นตอนที่ 6: ส่งคำขอไปยังโมเดล Gemini

เมื่อตั้งค่า Firebase AI Logic ป้องกัน และเริ่มต้นในแอปแล้ว คุณก็พร้อมที่จะส่งคำขอไปยังโมเดล Gemini

ตัวอย่างต่อไปนี้แสดงคำขอประเภทพื้นฐานที่สุด ซึ่งก็คือการสร้างข้อความ จากพรอมต์ที่เป็นข้อความเท่านั้น

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-3.6-flash")


// Create a session by injecting the model into Apple's `LanguageModelSession`.
let session = LanguageModelSession(model: model)

// Generate a text response to a prompt.
let response = try await session.respond(to: "Write a story about a magic backpack.")
print(response.content)

Gemini ยังรองรับคำขอประเภทอื่นๆ เช่น การวิเคราะห์รูปภาพและ PDF การสร้างเอาต์พุต JSON ที่มีโครงสร้าง และ การสร้างรูปภาพ (โดยใช้โมเดล "Nano Banana") ดูตัวอย่างคำขอประเภทเหล่านี้ได้ใน เอกสารหรือในแอปตัวอย่าง

สตรีมคำตอบ

คุณสามารถโต้ตอบได้เร็วขึ้นโดยไม่ต้องรอผลลัพธ์ทั้งหมดจากการสร้างโมเดล แต่ให้ใช้การสตรีมเพื่อจัดการผลลัพธ์บางส่วนแทน หากต้องการ สตรีมคำตอบ ให้ใช้ streamResponse(to:) แทน respond(to:)

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-3.6-flash")


// Create a session by injecting the model into Apple's `LanguageModelSession`.
let session = LanguageModelSession(model: model)

// Generate a streamed text response to a prompt.
// To stream the response, use `streamResponse(to:)` instead of `respond(to:)`
let stream = session.streamResponse(to: "Write a story about a magic backpack.")
var response = ""
for try await snapshot in stream {
  // The snapshot contains *all* content generated so far.
  response = snapshot.content
}

ขั้นตอนถัดไป

  • สำรวจความสามารถที่มี เมื่อเข้าถึง Gemini API ผ่าน เฟรมเวิร์กโมเดลพื้นฐานของ Apple
  • ดูวิธี กำหนดค่าโมเดล เพื่อควบคุมคำตอบ รวมถึงการตั้งค่าระดับการคิด ("การให้เหตุผล")
  • ดูวิธีมอบเครื่องมือให้โมเดล รวมถึงการอ้างอิงสำหรับข้อมูลล่าสุด
  • อ่านเพิ่มเติมเกี่ยวกับ Firebase App Check และวิธีที่ฟีเจอร์นี้ปกป้องทรัพยากรของคุณ


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