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

โมเดล Generative AI ของ Google พร้อมให้บริการในบางภูมิภาค คำขอแต่ละรายการที่ใช้ Vertex AI Gemini API จะต้องมีสถานที่ตั้ง เพื่อเข้าถึงโมเดล Firebase AI Logic จะมีค่าเริ่มต้นเป็น us-central1 สำหรับคำขอทั้งหมดโดยอัตโนมัติ

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

เมื่อใดที่ต้องตั้งค่าตำแหน่งอย่างชัดเจน

เนื่องจาก Firebase AI Logic จะตั้งค่าเริ่มต้นเป็น us-central1 โดยอัตโนมัติสำหรับคำขอทั้งหมด หากคุณต้องการใช้ตำแหน่งอื่น คุณจะต้อง ระบุตำแหน่งอย่างชัดเจนในระหว่างการเริ่มต้น บริการแบ็กเอนด์ Vertex AI Gemini API ในโค้ด

การตั้งค่าตำแหน่งอย่างชัดเจนอาจจำเป็น ทั้งนี้ขึ้นอยู่กับรุ่น หากคำขอพยายามเข้าถึงโมเดลในสถานที่ที่ไม่มีให้บริการ คุณจะได้รับข้อผิดพลาด 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 โมเดล: การตั้งค่าตำแหน่งอย่างชัดเจน ไม่บังคับ แต่แนะนำ หากไม่ได้ระบุตำแหน่ง ค่าเริ่มต้นจะเป็น us-central1

• Gemini Live API โมเดล: การตั้งค่าตำแหน่งอย่างชัดเจน ไม่บังคับ แต่แนะนำ หากไม่ได้ระบุตำแหน่ง ค่าเริ่มต้นจะเป็น us-central1 โปรดทราบว่าระบบไม่รองรับglobalตำแหน่ง

ดูรายการสถานที่ตั้งทั้งหมดที่พร้อมให้บริการได้ในภายหลังในหน้านี้

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

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

• ขีดจำกัดความจุจะขึ้นอยู่กับแต่ละโมเดล แต่ละภูมิภาค และต่อนาที

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

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

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

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

Firebase AI Logic จะมีค่าเริ่มต้นเป็น us-central1 โดยอัตโนมัติสำหรับคำขอทั้งหมด หากต้องการใช้ตำแหน่งอื่น คุณจะต้องระบุตำแหน่งอย่างชัดเจนในระหว่างการเริ่มต้นบริการแบ็กเอนด์ Vertex AI Gemini APIในโค้ด

โปรดทราบว่าตัวอย่างเหล่านี้แสดงการเข้าถึงโมเดล Gemini แต่คุณยังระบุตำแหน่งเมื่อเข้าถึงโมเดล Imagen ได้ด้วย

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

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

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

ประเทศที่ให้บริการ

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

Generative AI ใน Vertex AI พร้อมให้บริการในภูมิภาคต่อไปนี้ บางรุ่นและ/หรือบางเวอร์ชันอาจไม่พร้อมให้บริการในบางพื้นที่ (ดูความพร้อมให้บริการโดยละเอียดได้ใน 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 ไม่รองรับตำแหน่ง