Gemini CLI
Gemini CLI는 Google native generateContent(/v1beta)로 붙습니다. GOOGLE_GEMINI_BASE_URL은 /v1beta 없는 루트입니다.
설정 예시입니다. Gemini CLI 버전에 따라 메뉴·설정 이름이 조금 다를 수 있습니다.
공통 환경변수는 코딩 에이전트 연결의
#setup을 보세요.설정#
GOOGLE_GEMINI_BASE_URL=https://apirouter.pleum.ai 로 두고 GEMINI_API_KEY와 GOOGLE_API_KEY에 같은 plm_ 키를 넣습니다. /v1beta를 붙이면 경로가 중복됩니다. pleum launch gemini 가 이 env를 넣습니다.
Gemini CLI env
export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx
# GOOGLE_GEMINI_BASE_URL is the ROOT (no /v1beta) — Gemini CLI appends /v1beta itself.
export GOOGLE_GEMINI_BASE_URL=https://apirouter.pleum.ai
export GEMINI_API_KEY=$PLEUM_API_KEY
export GOOGLE_API_KEY=$PLEUM_API_KEY
pleum launch gemini --model gemini-3.8-flash
# or, after launch: /model google/gemini-3.8-flash확인#
pleum launch gemini 후 한 턴을 보내 보세요. 401이면 키, 404면 BASE_URL 끝에 /v1beta나 /v1이 붙은 경우입니다. 세션 안에서는 /model google/<id> 로 바꿉니다.
작동 방식#
이 도구는 Gemini API 형식(generateContent)으로 요청합니다. base URL은 /v1beta가 없는 https://apirouter.pleum.ai 이며 도구가 /v1beta를 스스로 붙입니다.
오류#
스니펫의 plm_xxxxxxxxxxxxxxxx는 더미입니다. 대시보드 API 키에서 발급한 실제 키로 바꾸세요.
| 증상 | 원인과 조치 |
|---|---|
| 401 Unauthorized | 키가 틀렸거나 비활성입니다. 대시보드 API 키에서 plm_ 키를 다시 복사하세요. 다른 서비스의 키를 넣지 않았는지도 확인하세요. |
| 402 Payment Required | 크레딧 잔액이 부족하거나 키의 일·주·월 예산이나 월 토큰 한도를 다 썼습니다. 충전하거나 API 키의 예산과 한도를 확인하세요. |
| 404 Not Found | base URL이 틀렸거나 모델 ID가 카탈로그에 없습니다. OpenAI 호환 도구는 /v1까지, Anthropic·Gemini 도구는 /v1이 없는 루트 주소입니다. 끝에 /chat/completions 같은 경로를 직접 붙이지 마세요. 오류 코드가 model_not_found면 모델 ID를 확인하세요. |
| 429 Too Many Requests | 키당 분당 요청 한도나 동시 요청 한도(concurrency_limit_exceeded)를 넘었거나, 모델 공급자 쪽 한도에 걸렸습니다(upstream_rate_limited). 에이전트의 병렬 실행 수를 줄이고 사용량 제한을 확인하세요. |
| model not found | 카탈로그에 없는 모델 ID입니다. GET /v1/models로 정확한 ID를 확인하고 대소문자까지 그대로 쓰세요. |