구글이 터미널에서 제미나이 API의 주요 기능을 사용할 수 있는 명령줄 도구(CLI) '제미나이 API CLI(Gemini API CLI)'를 공개했다. AI 에이전트가 간단한 명령어만으로 이미지와 영상, 음악을 생성하고 문서 분석과 음성 전사까지 수행할 수 있도록 지원한다.

구글은 23일(현지시간) 제미나이 API CLI의 실험적 프리뷰 버전을 공개했다고 밝혔다. 이 도구는 별도의 의존성 설치 없이 실행할 수 있는 바이너리 형태로 제공되며, 맥OS와 리눅스, 윈도우에서 사용할 수 있다. 소스 코드로 직접 설치하는 방식도 지원한다.

이번 도구는 AI 에이전트의 API 활용 과정을 간소화하는 데 초점을 맞췄다. 기존에는 에이전트가 모델 식별자를 직접 찾아야 했고, 일회성 SDK 스크립트를 작성하거나 복잡한 ‘curl’ 명령어를 반복해서 사용해야 했다. 생성된 미디어 데이터를 불필요하게 긴 문자열 형태로 처리하는 문제도 있었다.

구글은 실제 서비스 환경과 터미널에서 작동하는 AI 에이전트의 요구사항이 다르다고 설명했다. 운영 서비스에는 자료형이 명확하게 정의된 클라이언트 라이브러리가 적합하지만, 터미널에서 작업하는 개발자와 자율적으로 명령을 실행하는 에이전트에는 상태를 유지하지 않으면서도 명령어와 입력 형식을 쉽게 파악할 수 있는 CLI가 필요하다는 것이다. 이에 따라 입력과 출력 형식을 예측할 수 있는 인터페이스를 제공해 모델 호출과 결과 처리 과정을 단순화했다.

구글의 AI 개발 도구 생태계는 크게 세 계층으로 구성된다. 첫 번째는 추론과 멀티모달 분석, 미디어 생성, 에이전트 실행을 담당하는 제미나이 API다. 두 번째는 파이썬과 타입스크립트, Go, 자바를 지원하는 구글 제너레이티브 AI SDK로, 실제 서비스와 백엔드 개발에 활용된다. 세 번째인 제미나이 API CLI는 개발자와 셸 기반 AI 에이전트가 터미널에서 API에 직접 접근하도록 지원한다.

제미나이 API CLI는 이러한 과정을 명령어 중심으로 통합했다. 개발자와 AI 에이전트는 터미널에서 모델을 탐색하고 프롬프트를 테스트하는 것은 물론, 이미지·영상·음악 생성과 멀티모달 분석, 음성 전사 등을 실행할 수 있다.

미디어 생성 기능은 구글의 다양한 AI 모델과 연동된다. 이미지 생성에는 '나노 바나나 2.1', 영상 생성에는 '제미나이 옴니 1.1 플래시', 음악 생성에는 '리리아 3.5' 등을 활용할 수 있다. 음성 합성에는 '제미나이 3.8 플래시 TTS'가 포함된다.

음성 합성 기능을 이용하면 여러 화자가 대화하는 음성을 만들 수 있으며, 리아를 통해 배경음악용 연주곡도 생성할 수 있다. 이미지와 영상 생성 결과는 파일로 저장되고, 명령어 출력에는 해당 파일의 경로가 표시된다. 이에 따라 후속 작업에서 생성된 결과물을 별도의 변환 과정 없이 활용할 수 있다.

문서와 미디어 분석 기능도 제공한다. 사용자는 PDF와 이미지, 오디오 파일을 입력해 내용을 요약하거나 음성을 텍스트로 변환할 수 있다. 오디오 전사 결과는 타임스탬프가 포함된 SRT 자막 파일로도 생성할 수 있다. 유튜브 영상 분석도 지원한다.

제미나이 API CLI는 구글의 자체 개발 환경에만 국한되지 않는다. 셸 명령어를 실행할 수 있는 AI 에이전트라면 활용할 수 있으며, 구글은 클로드 코드, 코덱스, 오픈클로, 헤르메스, 커서 등을 지원 사례로 제시했다.

구글의 AI 개발 환경인 '안티그래비티(Antigravity)'에서도 현재 이 도구를 사용할 수 있다. 사용자가 에이전트에 이미지나 영상, 오디오 생성 또는 문서 분석을 요청하면, 에이전트가 CLI를 호출해 작업을 수행하고 결과 파일이나 작업 식별자를 후속 단계에 전달하는 방식이다. 안티그래비티와의 네이티브 통합은 추후 지원할 예정이다.

여러 단계에 걸친 조사나 코딩 작업은 백그라운드에서 실행되는 '매니지드 에이전트(Managed Agents)'에 맡길 수 있다. 딥 리서치(Deep Research)와 같은 에이전트에 작업을 위임한 뒤 상호작용 식별자를 이용해 진행 상황을 확인하고 구조화된 결과를 받을 수 있다.

안정적인 자동화 작업을 위한 기능도 갖췄다. 모든 명령어와 옵션을 오프라인에서 확인할 수 있고, ‘--schema’ 옵션으로 요청 형식을 살펴볼 수 있다. ‘--dry-run’을 사용하면 네트워크에 연결하지 않고 요청을 검증할 수 있으며, JSON이나 TOON 형식으로 결과를 출력하거나 ‘--jq’ 옵션으로 필요한 데이터만 추출할 수도 있다.

설치 후에는 제미나이 API 키를 환경변수나 운영체제 키체인에 저장하거나 설정 파일을 통해 등록하면 된다. 구글은 대화형 설정 기능도 제공한다.

제미나이 API CLI는 아파치 2.0 오픈소스 라이선스를 채택해 개발자들이 직접 기여하고 확장할 수 있는 개방형 생태계를 지향한다. 이를 통해 AI 에이전트가 셸 환경에서 도구를 자율적으로 다루기 위한 표준 인터페이스를 제공함으로써, 단순한 개발 보조 도구를 넘어 차세대 AI 에이전트 생태계의 핵심 인프라로 자리 잡을 전망이다.

현재 0.4.x 버전의 실험적 프리뷰 단계로 깃허브를 통해 제공된다. 구글은 개발자 피드백을 바탕으로 도구를 발전시키겠다는 방침이다.

박찬 기자 cpark@aitimes.com