AI Studio와 Vertex AI

같은 두뇌로 들어가는 두 개의 문

Google은 Gemini를 두 플랫폼으로 제공해. 어느 쪽을 고르느냐에 따라 인증과 결제, 규정 준수, SDK의 vertexai=True 설정까지 모두 달라져. 1주 차에 잘못 고른 선택을 6개월 뒤 리팩터링 비용으로 갚을 수도 있어.

Google AI Studio — 개발자가 들어가는 문

ai.google.dev에서 쓸 수 있어. 인증은 API 키 하나면 되고, 제한은 있지만 실제로 쓸 수 있는 무료 등급도 있어. 키를 받아 GEMINI_API_KEY를 설정하고 genai.Client()를 만들면 5분 안에 작동하는 클라이언트가 나와. 시제품, 사이드 프로젝트, 독립 제품, 특별한 규정 준수 사유가 없는 운영 서비스 대부분은 여기서 시작하는 게 맞아.

Vertex AI — 기업이 들어가는 문

Google Cloud Platform 안에서 제공돼. 서비스 계정이나 ADC로 인증하고, 요금은 기존 GCP 청구서에 합쳐져. SOC 2와 HIPAA를 지원하며 같은 인터페이스에서 Anthropic Claude, Meta Llama를 비롯한 200개 이상의 비Google 모델도 호출할 수 있어. 대신 프로젝트, IAM 바인딩, 리전, 서비스 계정 권한을 모두 잡아야 해서 설정에 몇 시간이 걸려.

선택 기준

강한 규정 준수 요건이나 여러 모델을 함께 써야 한다면 Vertex를 골라. 그 밖에는 AI Studio가 맞아.

AI Studio: 시제품, 스타트업, 독립 제품, 사내 도구, 운영 트래픽 대부분.
Vertex AI: 의료·금융·정부처럼 규제를 받는 산업, 이미 GCP에서 돌아가는 앱, 여러 제공자의 요금을 한 청구서로 받아야 하는 팀.

SDK 패키지는 둘 다 같아. google-genai의 생성자 설정으로 플랫폼만 전환해. 따라서 AI Studio에서 Vertex로 옮길 때 비용이 드는 부분은 애플리케이션 코드보다 인증과 결제 작업이야.

Code

같은 SDK로 두 플랫폼 사용하기·python

from google import genai

# Path A: Google AI Studio
# env 의 GEMINI_API_KEY (또는 GOOGLE_API_KEY) 읽음
client = genai.Client()

# Path B: Vertex AI (enterprise)
client = genai.Client(
    vertexai=True,
    project='my-gcp-project',
    location='us-central1',
)

# Path C: env 로 토글
# export GOOGLE_GENAI_USE_VERTEXAI=true
# export GOOGLE_CLOUD_PROJECT=my-gcp-project
# export GOOGLE_CLOUD_LOCATION=us-central1
client = genai.Client()  # env 변수 자동 인식

엔드포인트 구조도 달라·text

# AI Studio
POST https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent
Header: x-goog-api-key: $GEMINI_API_KEY

# Vertex AI (region scoped, project scoped)
POST https://{LOCATION}-aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL}:generateContent
Header: Authorization: Bearer $(gcloud auth print-access-token)

Exercise

실제 또는 가상의 제품 하나를 골라 봐. 코드 리뷰 봇, 명상 앱, 병원 기록 도우미, 사내 지식 도구 무엇이든 좋아. 어느 플랫폼에서 시작할지, 그 이유가 무엇인지, 어떤 조건에서 다른 쪽으로 옮길지를 세 문장으로 써. 세 번째 문장이 중요해. "좀 커지면" 같은 말 대신 구체적인 전환 조건을 적어.