ระบุตำแหน่งสำหรับการเข้าถึงโมเดล

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


โมเดล Generative AI ของ Google พร้อมให้บริการในบางภูมิภาค คุณสามารถเลือกตำแหน่งที่จะเข้าถึงโมเดลเพื่อให้เป็นไปตามข้อกำหนดด้านการปฏิบัติตามข้อกำหนด เวลาในการตอบสนอง ความพร้อมใช้งาน และความทนทาน

เมื่อใช้ Firebase AI Logic แต่ละคำขอที่ใช้ Agent Platform Gemini API (formerly Vertex AI) จะมีข้อมูลตำแหน่งที่จะเข้าถึง โมเดลได้โดยไม่บังคับ Firebase AI Logic มีการตั้งค่าตำแหน่งเริ่มต้น

  • เมื่อใช้ไวยากรณ์การเริ่มต้น "Agent Platform" ใหม่: global
  • เมื่อใช้ไวยากรณ์การเริ่มต้น "Vertex AI" แบบเดิม: us-central1

สำหรับโมเดล Gemini เกือบทั้งหมด Agent Platform Gemini API (formerly Vertex AI) รองรับ ตำแหน่ง global ซึ่งหมายความว่าคำขอของคุณจะได้รับการจัดการโดยโมเดลที่พร้อมใช้งาน ทุกที่ในพูลทั่วโลก การใช้ตำแหน่ง global สำหรับคำขอจะช่วยให้คุณหลีกเลี่ยงการเข้าถึงขีดจำกัดความจุของโมเดลและลดข้อผิดพลาด "บริการไม่พร้อมใช้งาน" (503) นอกจากนี้ การใช้ตำแหน่ง global อาจ จำเป็น ด้วย ทั้งนี้ขึ้นอยู่กับโมเดล

กรณีที่ต้องตั้งค่าตำแหน่งอย่างชัดเจน

Firebase AI Logic มีค่าเริ่มต้นอัตโนมัติสำหรับตำแหน่ง (เช่น global เมื่อใช้ไวยากรณ์การเริ่มต้น "Agent Platform") อย่างไรก็ตาม หาก คุณต้องการใช้ตำแหน่งอื่น คุณจะต้อง ระบุตำแหน่งอย่างชัดเจนในระหว่างการเริ่มต้นบริการแบ็กเอนด์ Agent Platform Gemini API (formerly Vertex AI)ในโค้ด

การตั้งค่าตำแหน่งอย่างชัดเจนอาจ จำเป็น ทั้งนี้ขึ้นอยู่กับโมเดล หากคำขอพยายามเข้าถึงโมเดลในตำแหน่งที่โมเดลไม่พร้อมใช้งาน คุณจะได้รับข้อผิดพลาด 404 ที่ระบุว่าโมเดล was not found or your project does not have access to it

  • Gemini โมเดลเวอร์ชันทดลองและ เวอร์ชันเบต้า: พร้อมให้บริการ ในตำแหน่ง global เท่านั้น (ยกเว้น Live API - ดูด้านล่าง)

  • Gemini 3.x โมเดล: พร้อมให้บริการ ในตำแหน่ง global เท่านั้นเมื่อใช้ Firebase AI Logic Firebase AI Logic ยังไม่ รองรับตำแหน่ง us และ eu

  • Gemini 2.5 โมเดล: พร้อมให้บริการในหลายตำแหน่ง.

  • Gemini Live API โมเดล: พร้อมให้บริการ ในตำแหน่ง us-central1 เท่านั้น ระบบ ไม่ รองรับตำแหน่ง global

ดูรายการตำแหน่งทั้งหมดที่พร้อมให้บริการในส่วนท้ายของ หน้านี้

ข้อเท็จจริงและแนวทางปฏิบัติแนะนำทั่วไป

ข้อเท็จจริงและแนวทางปฏิบัติแนะนำที่สำคัญบางประการเกี่ยวกับตำแหน่งมีดังนี้

  • ขีดจำกัดความจุเป็นไปตามโมเดล ต่อภูมิภาค ต่อนาที

  • หากต้องการหลีกเลี่ยงการเข้าถึงขีดจำกัดความจุโดยไม่คาดคิด ให้ลองใช้ตำแหน่ง global (หากโมเดลของคุณรองรับตำแหน่ง global)

  • ลองใช้ Firebase Remote Config เพื่อควบคุมตำแหน่งที่คุณเข้าถึงโมเดล วิธีนี้จะช่วยให้คุณเปลี่ยนตำแหน่งได้โดยไม่ต้องเผยแพร่แอปเวอร์ชันใหม่

  • หากการใช้ตำแหน่ง global ไม่สามารถใช้ได้หรือระบบไม่รองรับกรณีการใช้งานของคุณ ให้ลองกระจายตำแหน่งที่คุณเข้าถึงโมเดลอย่างชัดเจน เช่น คุณสามารถตั้งค่าตำแหน่งตามตำแหน่งของผู้ใช้ปลายทางได้โดยใช้ Firebase Remote Config

ตัวอย่างโค้ด

Firebase AI Logic มีค่าเริ่มต้นอัตโนมัติสำหรับตำแหน่ง (เช่น global เมื่อใช้ไวยากรณ์การเริ่มต้น "Agent Platform") อย่างไรก็ตาม หาก คุณต้องการใช้ตำแหน่งอื่น คุณจะต้อง ระบุตำแหน่งอย่างชัดเจนในระหว่างการเริ่มต้นบริการแบ็กเอนด์ Agent Platform Gemini API (formerly Vertex AI)ในโค้ด

แทนที่ LOCATION ด้วยรหัสตำแหน่ง (เช่น global หรือ europe-west4) จากรายการตำแหน่งที่พร้อมให้บริการ ในส่วนท้ายของหน้านี้

ไวยากรณ์ของ Agent Platform

Swift

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

Kotlin

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

Java

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

Web

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

Dart

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

Unity

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

ไวยากรณ์ของ Vertex AI

Swift

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))

// ...

Kotlin

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

Java

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

Web

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

Dart

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

Unity

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

โปรดทราบว่าหากคุณระบุตำแหน่งที่โมเดลไม่พร้อมใช้งาน คุณจะได้รับ ข้อผิดพลาด 404 ที่ระบุว่าไม่พบโมเดล was not found or your project does not have access to it

ตำแหน่งที่พร้อมให้บริการ

Google Cloud ใช้ ภูมิภาค. Google Cloud จะจัดเก็บข้อมูลลูกค้าในภูมิภาคที่คุณระบุไว้สำหรับฟีเจอร์ Generative AI ทั้งหมดที่พร้อมให้บริการโดยทั่วไปใน Agent Platform เท่านั้น

Generative AI ใน Agent Platform พร้อมให้บริการในภูมิภาคต่อไปนี้ โมเดลและ/หรือเวอร์ชันบางรายการอาจไม่พร้อมให้บริการในบางตำแหน่ง (ดูความพร้อมให้บริการในตำแหน่งโดยละเอียดได้ใน Google Cloudเอกสารประกอบ)

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

  • Firebase AI Logic จะใช้ตำแหน่ง us-central1 เป็นค่าเริ่มต้น

  • สำหรับโมเดล Gemini เวอร์ชันทดลอง ทั้งหมด (ยกเว้นโมเดล Live API ) ตำแหน่งที่รองรับ เท่านั้น คือ global

  • เมื่อใช้ Firebase AI Logic เพื่อเข้าถึงโมเดล Gemini 3.x ตำแหน่งที่รองรับ เท่านั้น คือ global Firebase AI Logic ยังไม่ รองรับตำแหน่ง us และ eu

  • สำหรับโมเดล Live API ทั้งหมดและโมเดล Imagen ทั้งหมด ระบบ global ไม่ รองรับตำแหน่ง

ทั่วโลก

  • global

สหรัฐอเมริกา

  • โคลัมบัส รัฐโอไฮโอ (us-east5)
  • ดัลลัส รัฐเท็กซัส (us-south1)
  • ไอโอวา (us-central1)
  • ลาสเวกัส รัฐเนวาดา (us-west4)
  • มอนก์สคอร์เนอร์ รัฐเซาท์แคโรไลนา (us-east1)
  • เวอร์จิเนียตอนเหนือ (us-east4)
  • โอเรกอน (us-west1)

แคนาดา

  • มอนทรีออล (northamerica-northeast1)

อเมริกาใต้

  • เซาเปาโล บราซิล (southamerica-east1)

ยุโรป

  • เบลเยียม (europe-west1)
  • ฟินแลนด์ (europe-north1)
  • แฟรงก์เฟิร์ต เยอรมนี (europe-west3)
  • ลอนดอน สหราชอาณาจักร (europe-west2)
  • มาดริด สเปน (europe-southwest1)
  • มิลาน อิตาลี (europe-west8)
  • เนเธอร์แลนด์ (europe-west4)
  • ปารีส ฝรั่งเศส (europe-west9)
  • วอร์ซอ โปแลนด์ (europe-central2)
  • ซูริก สวิตเซอร์แลนด์ (europe-west6)

เอเชียแปซิฟิก

  • เขตจางฮั่ว ไต้หวัน (asia-east1)
  • ฮ่องกง จีน (asia-east2)
  • มุมไบ อินเดีย (asia-south1)
  • โซล เกาหลี (asia-northeast3)
  • สิงคโปร์ (asia-southeast1)
  • ซิดนีย์ ออสเตรเลีย (australia-southeast1)
  • โตเกียว ญี่ปุ่น (asia-northeast1)

ตะวันออกกลาง

  • ดัมมัม ซาอุดีอาระเบีย (me-central2)
  • โดฮา กาตาร์ (me-central1)
  • เทลอาวีฟ อิสราเอล (me-west1)