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

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

เมื่อใช้ Firebase AI Logic คำขอแต่ละรายการที่ใช้ 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 ไม่ รองรับตำแหน่ง