모델에 액세스할 위치 지정

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 Gemini API (formerly Vertex AI) 백엔드 서비스를 초기화하는 동안 위치를 명시적으로 지정해야 합니다.

모델에 따라 위치를 명시적으로 설정해야 할 수도 있습니다(필수). 요청이 모델을 사용할 수 없는 위치의 모델에 액세스하려고 하면 모델 was not found or your project does not have access to it이라는 404 오류가 표시됩니다.

  • Gemini 미리보기 및 실험 모델: global 위치에서만 사용할 수 있습니다.

  • 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 Gemini API (formerly Vertex AI) 백엔드 서비스를 초기화하는 동안 위치를 명시적으로 지정해야 합니다.

LOCATION을 이 페이지의 사용 가능한 위치 목록에 있는 위치 코드 (예: global 또는 us-central1)로 바꿉니다.

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 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"));

// ...

모델을 사용할 수 없는 위치를 지정하면 모델 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

  • Gemini 미리보기 및 실험 모델: global 위치에서만 사용할 수 있습니다.

  • Gemini 3.x 안정화 모델: global 위치에서 사용할 수 있으며 us 및 eu 위치에서도 사용할 수 있습니다.

  • Gemini 2.5 모델: 많은 지역에서 사용 가능 Gemini Live API 2.5 모델은 global에서 사용할 수 없습니다.

Gemini 3.x 이상 모델

Gemini 3.x 이상 모델을 사용하는 경우 Firebase AI Logic는 다음 위치를 지원합니다.

  • global
  • us
  • eu

각 모델에 사용할 수 있는 위치에 관한 자세한 내용은 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 문서를 참고하세요.

이전에 사용할 수 있었지만 현재는 사용할 수 없는 지역 목록:

  • 아직 거부된 위치가 없습니다.