Google Gemini 최신 소식 — 구글 '제미나이 API CLI' 오픈소스 공개, 에이전트가 터미널에서 이미지·영상·음악까지 (2026.10.26)
출처: 구글 제공 자료 — AI타임스 “구글, 터미널서 AI 에이전트 다루는 ‘제미나이 API CLI’ 오픈소스 공개”(2026.10.24) 게재 이미지
한 줄 요약: “내 에이전트는 그대로, 제미나이는 명령어로”
구글이 제미나이 API CLI(Gemini API CLI, 실행 파일 이름 gemini-api) 를 실험적 프리뷰로 공개했습니다. 10월 22일 구글 개발자 채널에서 먼저 소개됐고, 23일(현지시간) 프리뷰 공개 사실이 전해지면서 24일 국내외 테크 매체에 보도됐습니다.
핵심은 이게 새로운 챗봇이나 코딩 에이전트가 아니라는 점입니다. 이미 터미널에서 돌아가는 AI 에이전트 — 클로드 코드, 코덱스, 커서, 안티그래비티, 오픈클로, 헤르메스 같은 것들 — 에게 제미나이 API를 호출할 수 있는 “손” 을 하나 달아주는 도구입니다. 에이전트는 계획을 세우고, 실제 모델 호출과 미디어 생성은 gemini-api가 처리합니다.
gemini-api image "A friendly robot mascot for a developer tool" --out ./assets/
프롬프트를 넣으면 파일이 프로젝트 폴더에 떨어지고, stdout으로는 파일 경로만 돌아옵니다. 에이전트는 그 경로를 그대로 다음 단계에 넘기면 됩니다. 이미지·영상·음악을 base64 문자열로 받아 헤매던 문제를 없앤 설계입니다.
무엇이 공개됐나 — 구글 AI 개발 도구의 3계층
보도에서 정리한 구글의 개발 도구 생태계는 이렇게 나뉩니다.
| 계층 | 역할 | 대상 |
|---|---|---|
| Gemini API | 추론·멀티모달 분석·미디어 생성·에이전트 실행 | 모든 호출의 기반 |
| Generative AI SDK | Python·TypeScript·Go·Java 클라이언트 | 실제 서비스·백엔드 |
| Gemini API CLI | 위 API를 셸 명령으로 노출 | 터미널에서 작업하는 개발자, 셸 권한을 가진 AI 에이전트 |
구글의 설명 논리는 명확합니다. 운영 서비스에는 타입이 명확한 SDK가 맞지만, 터미널에서 자율적으로 명령을 조합하는 에이전트에게는 상태를 유지하지 않으면서도 스스로 구조를 파악할 수 있는 CLI가 맞다는 것입니다. 그래서 이 도구는 매 호출이 독립적으로 끝나는 무상태(stateless) 방식으로 설계됐고, 컨텍스트는 호스트 에이전트가 들고 갑니다.
- 라이선스: Apache 2.0
- 배포: 의존성 없는 단일 Go 바이너리 — macOS·Linux·Windows
- 버전: 0.4.x (2026년 10월 26일 기준 최신 릴리스 v0.4.4, 10월 23일 공개)
- 저장소:
github.com/google-gemini/gemini-api-cli(10월 26일 기준 스타 296개)
출처: Google AI for Developers 공식 사이트(ai.google.dev) Gemini API 공유 이미지
명령어 한 장 정리 — 어떤 모델이 붙나
README의 명령 체계를 표로 옮기면 이렇습니다. 괄호 안은 기본 모델입니다.
| 분류 | 명령 | 하는 일 |
|---|---|---|
| 생성 | generate |
텍스트·멀티모달 생성 (gemini-3.8-flash) |
image |
이미지 생성·편집 (gemini-nano-banana-2.1) |
|
tts |
음성 합성, 다중 화자 지원 (gemini-3.8-flash-tts) |
|
music |
배경음악 생성 (lyria-3.5) |
|
video |
대화형 영상 생성·편집 (gemini-omni-1.1-flash) |
|
| 이해 | analyze |
PDF·이미지·오디오·영상·CSV·유튜브 URL에 질문 (gemini-3.8-flash) |
transcribe |
오디오·영상을 md·text·json·srt 자막으로 변환 | |
| 관리 | agent |
매니지드 에이전트 실행·상태·취소·정의 관리 |
files |
Files API 업로드·목록·삭제 (48시간 보관) | |
models |
오프라인 모델 카탈로그 / 실시간 모델 조회 | |
| 고급 | environments |
샌드박스 환경 생성·파일 업/다운로드 |
webhooks |
이벤트 수신 엔드포인트·서명 시크릿 관리 | |
triggers |
매니지드 에이전트용 크론 트리거 조회·실행·수정 | |
| 유틸 | configure / auth / whoami |
키 등록(OS 키체인 지원)·인증 확인 |
여기서 눈에 띄는 건 마지막 줄입니다. triggers는 매니지드 에이전트를 정해진 시각에 돌리는 크론 트리거를 CLI에서 관리하는 명령입니다. 웹훅까지 붙어 있으니, “정해진 시간에 깨어나 조사하고 결과를 콜백으로 받는” 무인 파이프라인을 굳이 별도 서버를 세우지 않고도 조립할 수 있는 구조입니다.
설치와 첫 실행
의존성 설치가 필요 없습니다. 스크립트 한 줄, 또는 Go로 직접 빌드합니다.
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/google-gemini/gemini-api-cli/main/scripts/install.sh | bash
# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/google-gemini/gemini-api-cli/main/scripts/install.ps1 | iex
# Go
go install github.com/google-gemini/gemini-api-cli/cmd/gemini-api@latest
키를 등록할 때는 OS 키체인을 쓸 수 있습니다. 환경변수로 평문 노출하는 방식보다 이쪽이 낫습니다.
gemini-api configure --api-key "YOUR_API_KEY" # macOS Keychain / Secret Service / Credential Manager
gemini-api whoami # 현재 키 출처 확인
gemini-api generate "Hello from my agent" --dry-run # 네트워크 호출 없이 검증
에이전트에 붙이는 방법 — 자기설명 인터페이스
이 도구의 진짜 설계 포인트는 바이너리가 스스로를 설명한다는 점입니다. 에이전트가 외부 문서를 읽거나 사람에게 물어보지 않고도 쓸 수 있게 만들었습니다.
| 에이전트가 필요한 것 | 실행하는 명령 |
|---|---|
| 명령·플래그 파악 | gemini-api --help / --usage (KDL 형식 전체 트리) |
| 요청 본문 스키마 확인 | gemini-api agent run --schema (JSON Schema 2020-12) |
| 오프라인 검증 | gemini-api image "..." --dry-run |
| 구조화 응답 받기 | --stream=false --output-format json |
| 필드만 뽑기 | --jq '.agents[].id' |
| 오류를 기계적으로 구분 | 종료 코드 0(성공) / 1(API 오류) / 2(사용법 오류) / 3(인증 오류) |
에이전트 지침 파일에 넣는 블록도 README에 그대로 예시로 있습니다. AGENTS.md, CLAUDE.md, .cursorrules 어디에 붙여도 됩니다.
You have access to gemini-api through the shell.
Use it to call Gemini models, generate or edit media, analyze files, or launch managed agents.
1. Inspect --help or --usage to choose a command, and --schema when building a --body JSON payload.
2. Preview API calls with --dry-run.
3. For discrete JSON output, pass --stream=false --output-format json.
4. Capture returned file paths and interaction IDs to continue multi-step tasks.
실제 작업 흐름은 이렇게 됩니다.
# 문서 분석 결과를 파일로
gemini-api analyze --input product-brief.pdf "What should we build first, and why?" > plan.md
# 인터뷰 영상 → SRT 자막
gemini-api transcribe --input interview.mp4 --format srt --out interview.srt
# 다중 화자 음성
gemini-api tts "Alice: Welcome to the demo! Bob: Let's dive right in." \
--multi-speaker "Alice=Kore,Bob=Puck" --out ./assets/dialogue.wav
영상 생성은 --async로 걸어두고 나중에 회수하는 방식도 지원합니다. 긴 작업을 동기로 붙잡고 있지 않아도 된다는 뜻입니다.
영향 ① 개발자: 벤더 종속을 피하는 우회로
지금까지 “에이전트에 이미지 생성 능력을 붙인다”는 건 사실상 해당 벤더의 도구 안에서만 가능한 일이었습니다. 클로드 코드에 이미지 생성기를 달려면 MCP 서버를 따로 띄우거나, 파이썬 스크립트를 짜서 감싸야 했습니다.
gemini-api는 그 지점을 셸 한 줄로 눌렀습니다. 호스트 에이전트는 무엇이든 되고, 미디어·분석 능력만 제미나이에서 빌려옵니다. 모델 선택도 호출 단위로 바뀝니다. 텍스트는 3.8 플래시, 이미지는 나노 바나나 2.1, 음악은 리리아 3.5처럼 같은 파이프라인 안에서 목적별로 모델을 갈아끼울 수 있습니다.
영향 ② 업무 자동화 운영자: 크론·웹훅·매니지드 에이전트
자동화 파이프라인을 운영하는 입장에서 실질적인 변화는 세 가지입니다.
- 미디어 산출물이 파일로 떨어진다 — 썸네일·내레이션·배경음악을 생성해 바로 조립 단계로 넘길 수 있습니다.
- 장기 작업을 위임할 수 있다 — 매니지드 에이전트에 조사를 맡기고 상호작용 ID로 상태를 폴링합니다. 에이전트가 몇 시간짜리 작업에 묶여 있지 않습니다.
- 트리거와 웹훅이 CLI 안에 있다 — 정해진 시각 실행과 결과 콜백을 서버 없이 관리할 수 있습니다.
여기에 --dry-run이 붙어 있는 게 생각보다 큽니다. 에이전트가 루프를 돌며 잘못된 요청을 수백 번 던져 과금이 튀는 사고를, 네트워크 호출 전에 막을 수 있기 때문입니다.
한계와 주의점 — 지금 도입한다면
솔직히 지금 단계에서 만능 도구로 보기는 어렵습니다. 공식 문서에 적힌 것과, 구조상 생기는 리스크를 같이 적어둡니다.
| 항목 | 내용 |
|---|---|
| 실험적 프리뷰 | 0.4.x 버전. 인터페이스가 예고 없이 바뀔 수 있고, 구글의 정식 지원(SLA) 대상이 아닙니다. |
| 과금 | CLI 자체는 무료지만 모든 호출은 Gemini API 과금입니다. 12월 1일부터 Argon 계열 단가가 2배가 되는 일정도 겹칩니다. |
| 파일 보관 48시간 | Files API에 올린 파일은 48시간 뒤 사라집니다. 재사용이 필요한 자산은 로컬에 남겨야 합니다. |
| 보안 표면 | 셸 권한을 가진 에이전트 + API 키 조합입니다. 키를 환경변수로 넘기기보다 키체인(configure)을 쓰고, 에이전트가 실행할 수 있는 명령 범위를 좁히는 편이 안전합니다. |
| Gemini CLI와 다름 | 이름이 비슷한 Gemini CLI는 터미널에서 대화하는 코딩 에이전트입니다. gemini-api는 대화하지 않고 API를 호출하는 무상태 도구입니다. 용도가 완전히 다릅니다. |
| 네이티브 통합 예고 | 안티그래비티에서는 지금도 쓸 수 있지만, 네이티브 통합은 추후 지원 예정이라고 밝혔습니다. |
전망: “에이전트의 표준 손”이 될 수 있을까
이번 공개의 무게는 기능 목록보다 포지셔닝에 있습니다. 구글은 자사 에이전트를 하나 더 밀어붙이는 대신, 남의 에이전트가 제미나이를 쓰도록 만드는 쪽을 택했습니다. 지원 사례로 클로드 코드와 코덱스를 먼저 언급한 게 상징적입니다.
이 방향이 굳어지면 경쟁 축은 “어느 모델이 똑똑한가”에서 “어느 모델이 남의 에이전트에 가장 잘 붙는가“로 옮겨갑니다. CLI 하나로 모델·미디어·에이전트 실행을 전부 노출하고, 스키마와 종료 코드까지 기계가 읽을 수 있게 맞춰둔 건 그 준비로 읽힙니다.
당장 할 일은 명확합니다. 자동화 파이프라인에서 미디어 생성이나 문서 분석을 별도 스크립트로 처리하고 있다면, 그 구간만 gemini-api로 바꿔보는 겁니다. --dry-run으로 요청만 검증해보고, 비용과 지연이 납득되면 그때 실제 호출을 붙이면 됩니다.
참고 링크
- 저장소:
github.com/google-gemini/gemini-api-cli(Apache 2.0) - 문서: Google AI for Developers — Gemini API (
ai.google.dev/gemini-api/docs), 매니지드 에이전트 가이드 - 보도: AI타임스 “구글, 터미널서 AI 에이전트 다루는 ‘제미나이 API CLI’ 오픈소스 공개” (2026.10.24)
- 발표: Dmitry Lyalin(구글) 공개 게시물 (2026.10.22)