AI Studio vs Vertex AI

같은 brain, 두 개의 front door

Google 이 Gemini 를 두 platform 으로 ship 해. auth, billing, compliance, SDK 의 vertexai=True 스위치까지 다 어느 쪽 쓰느냐에 따라 변해. week 1 에 잘못 고르면 month 6 에 refactor 비용 으로 갚아야 돼.

Google AI Studio — developer 의 front door

ai.google.dev 에 살아. auth 는 API key 한 개. free tier 있고 (제한적이지만 진짜 한도). 5 분이면 동작하는 client 만들 수 있어 — key 받고, GEMINI_API_KEY 세팅하고, genai.Client() 하나면 끝. prototype, 사이드 프로젝트, indie product, compliance 이유 없는 production 대부분 여기서 시작하는 게 맞아.

Vertex AI — enterprise 의 front door

Google Cloud Platform 안에 살아. auth 는 service account 나 ADC. billing 은 기존 GCP invoice 에 합쳐져. SOC 2, HIPAA 받고, 같은 surface 로 non-Google 모델 (Anthropic Claude, Meta Llama, 200+ 개) 호출할 수 있어. 세팅은 시간 단위 — project, IAM binding, region 선택, service account 권한 다 잡아야 돼.

결정 매트릭스

compliance 압박이나 multi-model 필요? Vertex. 그 외 다? AI Studio.

AI Studio: prototype, 스타트업, indie product, 사내 도구, production 트래픽 대부분.
Vertex AI: regulated 산업 (의료, 금융, 정부), 이미 GCP 에 사는 앱, provider 통합 청구서가 필요한 팀.

SDK 는 같은 패키지 — google-genai — constructor flag 로 platform 만 토글해. 즉 AI Studio → Vertex 이전 비용은 application 코드가 아니라 auth + billing 작업이야.

Code

같은 SDK, 두 platform·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 변수 자동 인식

endpoint 모양도 달라·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

실제 또는 가상의 product 하나 골라 (코드 리뷰 봇, 명상 앱, 병원 scribe, 사내 지식 도구). 세 문장 써: 어느 platform 에서 시작할지, 왜, 그리고 다른 쪽으로 마이그레이션 trigger 가 뭘지. 세 번째 문장이 중요해 — "좀 커지면" 아니라 구체적인 trigger 를 적어.