|
Gemini API 제공업체를 클릭하여 이 페이지에서 제공업체별 콘텐츠 및 코드를 확인합니다. |
Google의 생성형 AI 모델은 특정 리전에서 사용할 수 있습니다. 규정 준수, 지연 시간, 가용성, 내구성 요구사항에 맞게 모델에 액세스할 위치를 선택할 수 있습니다.
Firebase AI Logic을 사용할 때 Agent Platform Gemini API (formerly Vertex AI)을 사용하는 각 요청에는 모델에 액세스할 위치가 선택적으로 포함될 수 있습니다. Firebase AI Logic에는 기본 위치 설정이 있습니다.
- 새 'Agent Platform' 초기화 구문을 사용하는 경우:
global - 이전 'Vertex AI' 초기화 구문을 사용하는 경우:
us-central1
global 위치 정보
거의 모든 Gemini 모델에서 Agent Platform Gemini API (formerly Vertex AI)는
global 위치를 제공합니다. 즉, 전역 풀의 사용 가능한
모델에서 요청을 처리합니다.
요청에 global 위치를 사용하면 모델의 용량 한도를 초과하지 않고 '서비스 과부하'(503) 오류를 줄일 수 있습니다.
또한 모델에 따라 global 위치가 모델에 사용할 수 있는 유일한 위치 (예: 프리뷰 Gemini 모델)이므로 필요할
수 있습니다.
위치를 명시적으로 설정해야 하는 경우는 언제인가요?
Firebase AI Logic에는 위치에 대한 자동 기본값이 있습니다 (예:
global 'Agent Platform' 초기화 구문을 사용하는 경우). 하지만 다른 위치를 사용해야 하거나
사용하려는 경우 코드에서
Agent Platform Gemini API (formerly Vertex AI)백엔드 서비스를 초기화하는 동안 위치를 명시적으로
지정해야 합니다.
모델에 따라 위치를 명시적으로 설정해야 할 수도 있습니다.
요청이 모델을 사용할 수 없는 위치의 모델에 액세스하려고 하면 모델 was not found or your project does not have access to it이라는 404 오류가 발생합니다.
Gemini 프리뷰 및 실험 모델:
global위치에서만 사용할 수 있습니다.Gemini 4.x 및 Gemini 3.x 안정화 모델:
global위치에서 사용할 수 있으며us및eu위치에서도 사용할 수 있는 경우가 많습니다.Gemini 2.5 모델: 여러 위치에서 사용할 수 있습니다. Gemini Live API 2.5 모델은 사용할 수 없습니다.
global
이 페이지 뒷부분에서 사용 가능한 모든 위치 목록을 확인하세요.
일반적인 사실 및 권장사항
위치에 관한 몇 가지 주요 사실과 권장사항은 다음과 같습니다.
용량 한도는 모델별, 리전별, 분당입니다.
용량 한도를 예기치 않게 초과하지 않으려면
global위치를 사용하는 것이 좋습니다 (모델이global위치에서 사용 가능한 경우).Firebase Remote Config 을 사용하여 모델에 액세스하는 위치를 제어하는 것이 좋습니다. 이렇게 하면 앱의 새 버전을 출시하지 않고도 위치를 변경할 수 있습니다.
사용 사례에
global위치를 사용하는 것이 적합하지 않은 경우 모델에 액세스하는 위치를 명시적으로 배포하는 것이 좋습니다 (모델이global이외의 위치에서 사용 가능한 경우). 예를 들어 Firebase Remote Config을 사용하여 최종 사용자의 위치를 기반으로 위치를 설정할 수 있습니다.
코드 샘플
Firebase AI Logic에는 위치에 대한 자동 기본값이 있습니다 (예:
global 'Agent Platform' 초기화 구문을 사용하는 경우). 하지만 다른 위치를 사용해야
하거나 사용하려는 경우 코드에서
Agent Platform Gemini API (formerly Vertex AI)백엔드 서비스를 초기화하는 동안 위치를 명시적으로
지정해야 합니다.
이 페이지 뒷부분의 사용 가능한 위치 목록에서 LOCATION을 위치 코드 (예: global 또는
us-central1)로 바꿉니다.
Agent Platform 구문
Swift
agentPlatform 구문은 SDK v12.17.0 이상에서 사용할 수 있습니다.
// ...
// 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
agentPlatform 구문은 SDK v17.15.0 이상
및 Firebase Android BoM v34.17.0 이상에서 사용할 수 있습니다.
// ...
// 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
agentPlatform 구문은 SDK v17.15.0 이상
및 Firebase Android BoM v34.17.0 이상에서 사용할 수 있습니다.
// ...
// 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
AgentPlatformBackend 구문은 Firebase JS SDK v12.17.0 이상에서 사용할 수 있습니다.
// ...
// 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 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
vertexAI 구문은 SDK v13.0.0에서 삭제되었습니다.
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))
// ...
Kotlin
vertexAI 구문은 SDK v18.0.0 및
BoM v35.0.0에서 삭제되었습니다.
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
// ...
Java
vertexAI 구문은 SDK v18.0.0 및
BoM v35.0.0에서 삭제되었습니다.
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));
// ...
Web
VertexAIBackend 구문은 SDK v13.0.0에서 삭제되었습니다.
// ...
// Initialize FirebaseApp
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));
// ...
모델을 사용할 수 없는 위치를 지정하면 모델 was not found or your project does not have access to it이라는 404 오류가 발생합니다.
사용 가능한 위치
Google Cloud는 리전을 사용합니다. Google Cloud는 Agent Platform의 생성형 AI의 모든 정식 버전에 대해 지정하는 리전에만 고객 데이터를 저장합니다.
Agent Platform의 생성형 AI는 다음 리전에서 사용할 수 있습니다. 일부 모델 또는 특정 버전은 모든 위치에서 사용할 수 없을 수 있습니다. (자세한 위치 가용성은 Google Cloud 문서를 참고하세요.)
다음에 유의하세요.
Firebase AI Logic은 기본적으로 다음 위치를 사용합니다.
- 새 'Agent Platform' 초기화 구문을 사용하는 경우:
global - 이전 'Vertex AI' 초기화 구문을 사용하는 경우:
us-central1
- 새 'Agent Platform' 초기화 구문을 사용하는 경우:
Gemini 프리뷰 및 실험 모델:
global위치에서만 사용할 수 있습니다.Gemini 4.x 및 Gemini 3.x 안정화 모델:
global위치에서 사용할 수 있으며us및eu위치에서도 사용할 수 있는 경우가 많습니다.Gemini 2.5 모델: 여러 위치에서 사용할 수 있습니다. Gemini Live API 2.5 모델은 사용할 수 없습니다.
global
Gemini 3.x 이상 모델
Gemini 3.x 이상 모델을 사용할 때 Firebase AI Logic은 다음 위치를 지원합니다.
globaluseueurope-west2(영국 런던)asia-southeast1(싱가포르)
각 모델에 사용할 수 있는 위치에 관한 자세한 내용은 Google Cloud 문서를 참고하세요.
이전 세대 모델
이전 Gemini 모델 (예: 2.5 모델)을 사용할 때 Firebase AI Logic 은 다음 위치를 지원합니다.
전역
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)
Gemini Live API 2.5 모델은 사용할 수 없습니다. global
각 모델에 사용할 수 있는 위치에 관한 자세한 내용은 Google Cloud 문서를 참고하세요.
이전에 사용 가능했지만 현재 종료된 위치 목록:
- 아직 종료된 위치가 없습니다.