Gemini 3.1 Flash 실시간 미리보기

Gemini 3.1 Flash Live 프리뷰는 실시간 대화 및 음성 우선 AI 애플리케이션을 위한 기존 프리뷰 모델입니다.

문서

기능에 대한 자세한 내용은 Live API 가이드를 참고하세요.

gemini-3.1-flash-live-preview

속성	설명
모델 코드	`gemini-3.1-flash-live-preview`
지원되는 데이터 유형	입력 텍스트, 이미지, 오디오 출력 텍스트 및 오디오
토큰 한도^[*]	입력 토큰 한도 131,072 출력 토큰 한도 65,536
기능	오디오 생성 지원됨 캐싱 지원되지 않음 코드 실행 지원되지 않음 파일 검색 지원되지 않음 함수 호출 지원됨 Google 지도 기반 그라운딩 지원되지 않음 이미지 생성 지원되지 않음 Live API 지원됨 검색 그라운딩 지원됨 구조화된 출력 지원되지 않음 사고 지원됨 URL 컨텍스트 지원되지 않음
소비 옵션	Batch API 지원되지 않음
버전	자세한 내용은 모델 버전 패턴을 참고하세요. 미리보기: `gemini-3.1-flash-live-preview`
최신 업데이트	2026년 3월
모델 카드	모델 카드

Gemini 2.5 Flash Live에서 마이그레이션

Gemini 3.1 Flash Live 프리뷰는 지연 시간이 짧은 실시간 대화에 최적화되어 있습니다. gemini-2.5-flash-native-audio-preview-12-2025에서 마이그레이션할 때는 다음 사항을 고려하세요.

모델 문자열: 모델 문자열을 gemini-2.5-flash-native-audio-preview-12-2025에서 gemini-3.1-flash-live-preview로 업데이트합니다.
사고 구성: Gemini 3.1은 thinkingBudget 대신 thinkingLevel (minimal, low, medium, high와 같은 설정 포함)를 사용합니다. 기본값은 minimal이며, 가장 짧은 지연 시간에 최적화됩니다. 사고 수준 및 예산을 참조하세요.
서버 이벤트: 이제 단일 BidiGenerateContentServerContent 이벤트에 여러 콘텐츠 부분 (예: 오디오 청크 및 스크립트)이 동시에 포함될 수 있습니다. 콘텐츠가 누락되지 않도록 각 이벤트의 모든 부분을 처리하도록 코드를 업데이트합니다.
클라이언트 콘텐츠: send_client_content는 명시적 역할 (user 또는 model)을 사용하여 전체 세션 수명 주기 동안 지원됩니다. turn_complete=true를 설정하면 활성 모델 생성이 무조건 중단됩니다. 증분 콘텐츠 업데이트를 참조하세요.
회전 범위: 기본값은 TURN_INCLUDES_ONLY_ACTIVITY 대신 TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO입니다. 이제 모델의 차례에 감지된 오디오 활동과 모든 동영상 프레임이 포함됩니다. 애플리케이션이 현재 동영상 프레임의 지속적인 스트림을 전송하는 경우 추가 비용이 발생하지 않도록 오디오 활동이 있을 때만 동영상 프레임을 전송하도록 애플리케이션을 업데이트하는 것이 좋습니다.
비동기 함수 호출: 아직 지원되지 않습니다. 함수 호출은 동기식으로만 가능합니다. 도구 응답을 전송할 때까지 모델이 응답을 시작하지 않습니다. 비동기 함수 호출을 참조하세요.
능동적 오디오 및 감정 대화: 이러한 기능은 아직 Gemini 3.1 Flash Live에서 지원되지 않습니다. 코드에서 이러한 기능의 구성을 삭제합니다. 능동적 오디오 및 공감형 대화를 참고하세요.

자세한 기능 비교는 기능 가이드의 모델 비교 표를 참조하세요.