Gemini CLI

Gemini CLI는 Google이 만든 오픈소스 터미널 에이전트입니다. 환경 변수 두 개로 Synthorai를 가리키게 하면, Synthorai 키로 게이트웨이의 Gemini 네이티브 엔드포인트를 호출합니다.

시작하기 전에

콘솔의 API 키 페이지에서 키를 만들고 바로 복사하세요. 키는 한 번만 표시됩니다.

1단계 - 환경 변수 설정

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

Gemini CLI가 인증 방식을 물으면 Use Gemini API key를 선택합니다. 키는 x-goog-api-key 헤더로 전송되며, 게이트웨이는 Gemini 네이티브 엔드포인트(/v1beta/models/{model}:generateContent, :streamGenerateContent)에서 이 헤더를 받습니다.

2단계 - 모델 선택

-m에는 키로 호출할 수 있는 Gemini 모델을 지정합니다. 모델 목록은 모델 페이지에 있습니다.

이 경로에서는 generateContent와 streamGenerateContent만 제공합니다. countTokens, embedContent 같은 다른 메서드는 404를 반환하며 과금되지 않습니다.

설정을 파일에 저장

셸마다 export하는 대신 두 변수를 ~/.gemini/.env에 적어 둘 수도 있습니다.

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

문제 해결

401 키가 틀렸거나, gemini를 실행하는 셸에 키가 설정되어 있지 않습니다.

특정 모델에서 404 해당 모델이 키에 허용되어 있지 않습니다. 키로 호출할 수 있는 모델을 고르세요.

URL에 /v1/v1beta가 보임 GOOGLE_GEMINI_BASE_URL에서 /v1을 빼세요.

Gemini 모델별 가격은 모델 가격 비교에서 확인하세요.