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

โมเดล Generative AI ของ Google พร้อมให้บริการในบางภูมิภาค

เมื่อเริ่มต้นบริการแบ็กเอนด์ของ Vertex AI Gemini API ในโค้ด คุณสามารถระบุตำแหน่งของโมเดลที่ต้องการเข้าถึงใน คำขอได้ ดูรายการตำแหน่งที่พร้อมให้บริการในส่วนท้ายของ หน้านี้

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

คุณอาจต้องตั้งค่าตำแหน่งนี้ ทั้งนี้ขึ้นอยู่กับโมเดล

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

• Gemini 3.x โมเดล: ต้องตั้งค่าตำแหน่งเป็น global เมื่อใช้ Firebase AI Logic

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

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

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

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

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

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

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

โปรดทราบว่าตัวอย่างเหล่านี้แสดงการเข้าถึงโมเดล 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เอกสารประกอบ)

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

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

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

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