익스프레스 모드의 Gemini Enterprise Agent Platform 개요

익스프레스 모드의 Agent Platform을 사용하면 빠르게 가입하고 에서 생성형 AI 애플리케이션 빌드를 시작할 수 있습니다. Google Cloud이 간소화된 설정 환경은 조직, 결제, 프로젝트 관리를 간소화하여 Google Cloud API에 대한 액세스를 간소화합니다.

익스프레스 모드의 Agent Platform에 대해 자세히 알아보려면 Google Cloud 익스프레스 모드 FAQ를 참조하세요.

익스프레스 모드 가입

Agent Platform은 @gmail.com Google 계정이 있는 개발자를 위한 익스프레스 모드로 제공됩니다.

익스프레스 모드의 Agent Platform에 가입하려면콘솔에서 익스프레스 모드 에 액세스하세요. Google Cloud

익스프레스 모드로 이동

설정이 완료되면 다음 튜토리얼 중 하나를 따라 익스프레스 모드의 Agent Platform을 사용할 수 있습니다.

익스프레스 모드의 Agent Platform 알아보기

익스프레스 모드에 가입하면 Google Cloud 사용자를 대신하여 API를 사용 설정합니다. 이 프로세스는 백그라운드에서 진행되므로 리소스를 수동으로 구성하지 않고도 Agent Platform을 사용할 수 있습니다.

익스프레스 모드에 가입하면 다음 항목에 액세스할 수 있습니다.

  • 핵심 Agent Studio 기능. 다양한 생성형 AI 모델의 프롬프트를 빠르게 테스트하고 맞춤설정하며, 해당 코드를 가져와 애플리케이션에서 사용할 수 있습니다.
  • API 키. 애플리케이션에서 빠르게 인증합니다.
  • 신규 사용자를 위한 90일 무료 등급. Google Cloud 신규 Google Cloud 사용자를 위한 무료 등급의 90 일 제한 기간 동안 익스프레스 모드를 지원하는 Agent Platform API 를 할당량 한도까지 무료로 사용할 수 있습니다. 결제 정보를 제공할 필요는 없습니다. 결제를 사용 설정 하면 언제든지 할당량 한도를 늘릴 수 있습니다.

기존 Google Cloud 사용자이거나 결제를 사용 설정한 후에는 90 일 무료 등급이 삭제됩니다. 확장된 할당량 한도와 추가 Google Cloud 기능에 액세스하려면 유료 등급으로 전환합니다. 할당량이 증가하면 사용한 만큼만 비용을 지불하면 됩니다. 언제든지 익스프레스 모드를 종료하고 모든서비스와 기능을 사용할 수 있습니다. Google Cloud

다음 표에는 익스프레스 모드 환경과 전체 Agent Platform 환경 간의 차이점이 나와 있습니다.

항목 무료 등급의 Agent Platform 익스프레스 모드 전체 Agent Platform
시간 제한 90일 무제한
사용 가능한 서비스 기본 생성형 AI 서비스. Agent Platform을 포함한 모든 Google Cloud 서비스.
데이터 소스 Google Drive 에서 사용할 수 있는 모든 데이터 소스 Google Cloud.
Quota 무료 등급 한도. 익스프레스 모드에서 사용 가능한 모델 및 비율 제한을 참조하세요. 표준 사용한 만큼만 지불 한도. 비율 제한을 참조하세요.
API 엔드포인트의 표준 형식 프로젝트 ID 및 위치 대신 API 키를 지정합니다. 예를 들면 다음과 같습니다.
https://aiplatform.googleapis.com/v1/publishers/google/models/{model}:streamGenerateContent?key={API_KEY} 		프로젝트 ID와 위치를 지정합니다. 예를 들면 다음과 같습니다.
https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:streamGenerateContent

익스프레스 모드에서 사용 가능한 모델 및 비율 제한

최신 Gemini Flash 모델을 비롯한 여러 모델을 익스프레스 모드에서 사용해 볼 수 있습니다. 다음 표에는 익스프레스 모드에서 사용할 수 있는 모델과 비율 제한이 나와 있습니다.

모델 카테고리 사용 가능한 모델 분당 최대 요청 수
Gemini gemini-3.1-flash-image-preview 동적
gemini-3.1-pro-preview 동적
gemini-3-flash-preview 동적
gemini-3-pro-preview 동적
gemini-3-pro-image-preview 동적
gemini-2.5-flash-image 10
gemini-2.5-flash-lite-preview-09-2025 10
gemini-2.5-flash-lite 10
gemini-2.5-pro 10
gemini-2.5-flash 10
gemini-2.5-flash-image 10
gemini-2.0-flash-001 10
gemini-2.0-flash-lite-001 10

Gemini 2.0 모델의 경우 Live API를 Google Cloud 익스프레스 모드의 콘솔에서 사용할 수 없습니다. 익스프레스 모드에서 Live API를 사용하려면 Agent Platform API 또는 Google 생성형 AI SDK를 사용하세요.

익스프레스 모드 워크플로의 Agent Platform

다음 세 단계로 애플리케이션에서 Agent Platform API로 요청 전송을 시작할 수 있습니다.

  1. 익스프레스 모드에 가입한 후 Agent Studio를 사용하여 Agent Platform 기능을 빠르게 사용해 보세요.

    Agent Studio로 이동

    예를 들어 Agent Studio > 프롬프트 만들기 를 선택하여 다양한 Gemini 모델을 사용하여 멀티모달 프롬프트를 만들고 최적화합니다.

  2. UI로 구현한 코드 가져오기

    프롬프트 페이지에서 코드로 빌드 > 코드 가져오기 를 클릭합니다. UI에서 구현한 것과 동일한 요청을 프로그래매틱 방식으로 전송하는 코드가 표시된 패널이 열립니다. 프로그래밍 언어 또는 curl의 코드를 가져올 수 있습니다. Google Colab을 사용하여 Python 코드를 사용해 볼 수 있습니다.

  3. API 키를 사용하여 Agent Platform API로 인증합니다.

    익스프레스 모드의 Google Cloud 콘솔에서 API 및 서비스 > 사용자 인증 정보 를 엽니다.

    사용자 인증 정보로 이동

    그런 다음 Generative Language API 키를 "YOUR_API_KEY"라고 표시된 코드에 복사합니다. 예를 들면 다음과 같습니다.

    Python

    Python용 Google 생성형 AI SDK는 PyPI 및 GitHub에서 사용 가능합니다.

    자세한 내용은 Python SDK 참조 (새 탭에서 열기)를 참조하세요. 

    from google import genai

# TODO(developer): Update below line
API_KEY = "YOUR_API_KEY"

client = genai.Client(vertexai=True, api_key=API_KEY)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain bubble sort to me.",
)

print(response.text)
# Example response:
# Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

익스프레스 모드의 차이점

익스프레스 모드의 Agent Platform은 생성형 AI의 기능 하위 집합을 제공합니다. 따라서 익스프레스 모드에 가입한 경우 일부 Agent Platform 문서가 관련이 없습니다. 익스프레스 모드에서 사용 가능한 API 엔드포인트에 대한 자세한 내용은 익스프레스 모드의 Agent Platform REST API 참조를 확인하세요.

또한 고객은 일반적으로 Google Cloud 조직 및 프로젝트를 사용하여 리소스와 상호작용합니다 (예: API 엔드포인트 호출). 익스프레스 모드의 Agent Platform을 사용하는 경우 조직이나 프로젝트에 대해 걱정할 필요가 없습니다. 하지만 익스프레스 모드의 Agent Platform을 사용하는 동안 참조하는 일부 Google Cloud 문서에 언급될 수 있습니다. 문서를 계속 사용할 수 있지만 조직 및 프로젝트를 참조하는 개념과 안내는 무시하세요. 또한 익스프레스 모드에 가입할 때 선택한 위치는 전반적인 환경에서 사용됩니다.

익스프레스 모드에서 REST API 엔드포인트를 호출할 때는 익스프레스 모드의 엔드포인트 형식을 사용하고 API 키를 지정합니다. 예를 들면 다음과 같습니다.

표준 엔드포인트 URL https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:streamGenerateContent
익스프레스 모드의 엔드포인트 URL https://aiplatform.googleapis.com/v1/publishers/google/models/{model}:streamGenerateContent?key={API_KEY}

API 키 보기 및 관리

익스프레스 모드를 지원하는 Agent Platform API 엔드포인트로 인증하려면 가입 중에 생성된 API 키 또는 익스프레스 모드에서 생성한 키를 사용하세요. API 키는 익스프레스 모드에 가입할 때 자동으로 생성되는 암호화된 문자열입니다. 이러한 API 키는 API 및 서비스 페이지에서 보고 관리할 수 있습니다.

API 키 관리 권장사항에 대해 자세히 알아보려면 API 키 관리 권장사항을 참조하세요.

API 키를 보고 관리하려면 다음 단계를 따르세요.

  1. 콘솔에서 API 키 페이지로 이동합니다. Google Cloud

    API 키로 이동

결제 사용 설정 및 관리

결제를 사용 설정하면 할당량을 늘리고 90일 제한을 삭제할 수 있습니다.

결제를 사용 설정한 후에는 사용한 만큼만 비용을 지불하면 됩니다. 프롬프트를 저장하고 결제가 사용 설정되지 않은 경우 회색으로 표시되는 Google Cloud 콘솔에서 추가 설정에 액세스할 수도 있습니다.

결제를 관리하려면 다음 단계를 따르세요.

  1. 익스프레스 모드의 Agent Studio 개요 페이지로 이동합니다.

    Agent Studio로 이동

  2. 익스프레스 모드의 Google Cloud 콘솔에서 결제 를 엽니다.

    결제로 이동

  3. 결제 계정을 관리합니다.

모든 Google Cloud 기능 및 서비스 사용 시작

익스프레스 모드는 빠르게 시작할 수 있도록 설계되었습니다. 다른 Google Cloud 서비스를 사용할 준비가 되었거나 환경을 더 세부적으로 제어해야 하는 경우 익스프레스 모드 계정을 표준 Google Cloud 계정으로 전환할 수 있습니다. 이 프로세스를 업그레이드 라고도 합니다.

익스프레스 모드 계정을 업그레이드하여 프로젝트에서 사용할 수 있는 모든기능과 서비스를 사용할 수 있습니다. Google Cloud

익스프레스 모드에서 업그레이드하려면 다음 단계를 따르세요.

  1. 익스프레스 모드의 Agent Studio 개요 페이지로 이동합니다.

    Agent Studio로 이동

  2. 지금 활성화 를 클릭하고 안내에 따라 진행합니다.

익스프레스 모드에서 업그레이드한 후에는 REST API 엔드포인트를 호출할 때 API 키 대신 프로젝트 ID와 위치를 지정합니다. 예를 들면 다음과 같습니다.

https://{location}-aiplatform.googleapis.com/v1/projects/{projectid}/locations/{location}/publishers/google/models/{model}:streamGenerateContent