Gemini Live API 개요

Gemini Live API는 Gemini와의 지연 시간이 짧은 실시간 음성 및 동영상 상호작용을 지원합니다. Gemini Live는 오디오, 동영상 또는 텍스트로 구성된 연속 스트림을 처리하여 즉각적이고 사람과 유사한 음성 대답을 제공합니다. 이렇게 하면 사용자에게 자연스러운 대화형 환경이 제공됩니다. Live Avatar는 음성 응답과 동기화되는 사람과 유사한 아이콘과 상호작용할 수 있는 옵션을 추가하여 사용자에게 개선되고 친근한 경험을 제공합니다.

Agent Studio에서 Gemini Live API 사용해 보기

사용 사례

Gemini Live API는 다음과 같은 다양한 업계의 실시간 음성 및 동영상 에이전트를 빌드하는 데 사용할 수 있습니다.

  • 브랜드 기업 홍보대사: 기업 웹 속성 또는 모바일 애플리케이션에 배포된 대화형 브랜드 담당자로, 승인된 직원 초상권 또는 기업 출시가 실행된 유료 인재로부터 생성됩니다.

  • 이커머스 및 리테일 업종: 맞춤 추천을 제공하는 쇼핑 어시스턴트와 고객 문제를 해결하는 고객 지원 담당자

  • 게임: 대화형 논플레이어 캐릭터 (NPC), 인게임 도움말 어시스턴트, 인게임 콘텐츠의 실시간 번역

  • 차세대 인터페이스: 로봇 공학, 스마트 글라스, 차량에서 음성 및 동영상 지원 환경

  • 의료: 시설 및 치료 물류를 지원하는 탐색 가이드

  • 금융 서비스: 일상적인 은행 업무 요청을 분류하는 대화형 에이전트

  • 교육: 맞춤형 안내와 의견을 제공하는 AI 멘토 및 학습자 도우미

주요 특징

Gemini Live API는 강력한 음성 및 동영상 에이전트를 빌드하기 위한 포괄적인 기능 세트를 제공합니다.

  • 높은 오디오 품질: Gemini Live API는 여러 언어로 자연스럽고 사실적인 음성을 제공합니다.

  • 다국어 지원: 지원되는 24개 언어로 대화할 수 있습니다.

  • 통화 참여: 사용자는 언제든지 모델을 중단하여 응답형 상호작용을 할 수 있습니다.

  • 공감형 대화: 사용자의 입력 표현에 맞게 대답 스타일과 어조를 조정합니다.

  • 도구 사용: 함수 호출 및 Google 검색과 같은 도구를 통합하여 역동적인 상호작용을 지원합니다.

  • 오디오 스크립트 작성: 사용자 입력과 모델 출력의 텍스트 스크립트를 제공합니다. 대화의 부가 채널이 아닌 최종 목표로서의 스크립트에 관해서는 Gemini 3.5 Transcribe를 참고하세요.

  • 능동적 오디오: 모델이 응답하는 시점과 컨텍스트를 제어할 수 있습니다.

기술 사양

다음 표에는 Gemini Live API의 기술 사양이 나와 있습니다.

카테고리 세부정보
입력 모달리티 오디오 (원시 16비트 PCM 오디오, 16kHz, 리틀 엔디안), 이미지/동영상 (JPEG 1FPS), 텍스트
출력 모달리티 오디오(원시 16비트 PCM 오디오, 24kHz, little-endian), 텍스트
동영상 (라이브 아바타) 동영상 (mp4)
프로토콜 스테이트풀 WebSocket 연결(WSS)

지원되는 모델

다음 모델은 Gemini Live API를 지원합니다. 상호작용 요구사항에 따라 적절한 모델을 선택합니다.

모델 ID 가용성 사용 사례 주요 특징
gemini-3.8-live 일반 안정화 버전 권장사항. 지연 시간이 짧은 음성 에이전트. 원활한 다국어 전환을 지원합니다.
  • 네이티브 오디오
  • 오디오 스크립트
  • 음성 활동 감지
  • 공감형 대화
  • 능동적 오디오
  • 도구 사용
  • 라이브 아바타
gemini-live-2.5-flash-native-audio 정식 버전 권장사항. 지연 시간이 짧은 음성 에이전트. 원활한 다국어 전환과 감정적 어조를 지원합니다.
  • 네이티브 오디오
  • 오디오 스크립트
  • 음성 활동 감지
  • 공감형 대화
  • 능동적 오디오
  • 도구 사용
gemini-3.5-transcribe-live-preview 미리보기 음성 텍스트 변환만 지원됩니다. 실시간 자막, 음성 텍스트 변환, 통화 스크립트 작성 오디오가 아닌 텍스트를 반환하므로 대화를 유지하지 않습니다.
  • 임시 및 최종 스크립트
  • 코드 전환을 통한 자동 언어 감지
  • 발화 수준 타임스탬프
  • 맞춤 어휘 바이어싱

시작하기

개발 환경에 맞는 가이드를 선택합니다.

사용 편의성을 위해 권장됨

생성형 AI SDK를 사용하여 Gemini Live API에 연결하여 Python 백엔드로 실시간 멀티모달 애플리케이션을 빌드합니다.

원시 프로토콜 제어

WebSocket을 사용하여 Gemini Live API에 연결하여 JavaScript 프런트엔드와 Python 백엔드로 실시간 멀티모달 애플리케이션을 빌드합니다.

에이전트 개발 키트

에이전트를 만들고 에이전트 개발 키트(ADK) 스트리밍을 사용하여 음성 및 영상 커뮤니케이션을 사용 설정합니다.

파트너 연동

Google 파트너와 통합하려는 경우 이러한 플랫폼은 이미 WebRTC 프로토콜을 통해 Gemini Live API를 통합하여 실시간 오디오 및 동영상 애플리케이션 개발을 간소화했습니다.

LiveKit 및 ADK 참조 아키텍처

정교한 세션 오케스트레이션, 라우팅, 멀티 에이전트 위임이 필요한 고급 프로덕션 등급 음성 어시스턴트의 경우 에이전트 개발 키트 (ADK)를 통해 Gemini Live API와 함께 LiveKit (WebRTC)를 사용하여 지연 시간이 짧은 양방향 통합을 빌드할 수 있습니다.

이 아키텍처를 사용하면 초기 고객 상호작용을 처리하고 전문 하위 에이전트로 요청을 동적으로 라우팅하는 오케스트레이터 에이전트를 배포할 수 있습니다 (예: transferAgent 오케스트레이션을 사용하여 항공편 예약 또는 호텔 예약 에이전트에 컨텍스트 위임).

이 참조 설계를 살펴보고 배포하려면 공식 GitHub의 참조 코드베이스 구현을 참고하세요.