두 인증 path

한 모델 family, 두 front door

AI Studio vs Vertex split (developer-vs-enterprise 선택) 너머에, Google 이 ship 하는 세 번째 path: Cloud Code Assist. Gemini CLI, IDE 확장, (여기서 관련) cwkPippa 의 free OAuth fallback 이 사용하는 OAuth 기반 endpoint.

두 path 나란히

Aspect	API Key (developer)	OAuth (Cloud Code Assist)
Endpoint	`generativelanguage.googleapis.com`	`cloudcode-pa.googleapis.com`
Auth header	`x-goog-api-key: KEY`	`Authorization: Bearer TOKEN`
비용	유료 (또는 AI Studio free tier)	개인 Gmail 무료
Rate limit	5–15 RPM (free tier)	~60 RPM
Pre-flight	없음	`loadCodeAssist` 먼저 호출
Token refresh	N/A — key 만료 X	표준 OAuth refresh

OAuth path 왜 신경 써야

OAuth path 가 "진짜 rate limit 의 free tier" power. 개인 Google account 있으면 billing setup 없이 hit 가능. Trade-off: internal API, 모양이 적은 알림으로 변할 수 있고, 일일 quota. Primary production 아니라 fallback 으로 사용.

Credential 파일

OAuth credential 이 ~/.gemini/oauth_creds.json 에 살아 (Gemini CLI 가 거기 둠). 포맷은 표준 Google OAuth refresh-token JSON.

Code

Path A — API Key·text

POST https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent
Header: x-goog-api-key: $GEMINI_API_KEY
Header: Content-Type: application/json

Body:
{
  "contents": [{"parts": [{"text": "Hello"}]}]
}

Path B — OAuth (Cloud Code Assist)·text

POST https://cloudcode-pa.googleapis.com/v1internal:generateContent
Header: Authorization: Bearer $ACCESS_TOKEN
Header: Content-Type: application/json

Body (note the wrapper):
{
  "model": "gemini-2.5-flash",
  "project": "projects/.../locations/global/...",   ← from loadCodeAssist
  "request": {
    "contents": [{"role": "user", "parts": [{"text": "Hello"}]}],
    "generationConfig": {}
  }
}

Credential 파일 모양·json

// ~/.gemini/oauth_creds.json
{
  "access_token": "ya29.a0...",
  "refresh_token": "1//06...",
  "token_type": "Bearer",
  "expiry_date": 1756789012345
}

한 모델 family, 두 front door

두 path 나란히

OAuth path 왜 신경 써야

Credential 파일

Code

External links

Exercise

Progress

댓글 0