Live API의 한도 및 사양


이 페이지에서는 Live API 및 해당 모델 사용에 관한 다양한 제한사항과 사양을 설명합니다.

일반 사양 및 제한사항

  • 지원되는 입력 및 출력: (자세한 내용은 아래의 미디어 형식을 참고하세요.)

    • 입력: 텍스트, 이미지 (PDF 제외), 오디오, 동영상
    • 출력: 텍스트 (스크립트 작성) 및 오디오 (스트리밍)

  • 지원되는 도구: 함수 호출, Google Search을 통한 접지, Google Maps을 통한 접지

  • 지식 차단일: 2025년 1월

Live API는 JSON과 같은 구조화된 출력 생성 또는 Count Tokens API를 지원하지 않습니다.

세션 관련 제한사항

Live API에서 세션은 입력 과 출력이 연결을 통해 지속적으로 스트리밍되는 영구 연결을 의미합니다.

세션이 다음 제한사항 중 하나라도 초과하면 연결이 종료됩니다. 하지만 Live API는 이러한 세션 관련 제한사항을 처리하기 위한 몇 가지 옵션 (아래 참고)을 제공합니다.

  • 세션 컨텍스트 윈도우 는 128,000개의 토큰으로 제한됩니다.

    이 컨텍스트 윈도우 제한으로 인해 입력 모드를 기반으로 하는 대략적인 최대 세션 길이는 다음과 같습니다.

    • 오디오 전용 입력 세션은 15분으로 제한됩니다.
    • 동영상 + 오디오 입력은 2분으로 제한됩니다.

  • 연결 길이 는 약 10분으로 제한됩니다.

    연결이 종료되기 약 60초 전에 going away 알림이 표시됩니다.

세션 관련 제한사항을 처리하기 위한 몇 가지 옵션은 다음과 같습니다.

세션 관리에 대해 자세히 알아보세요.

비율 제한

Live API에는 Firebase 프로젝트당 동시 세션 수와 분당 토큰 수 (TPM) 모두에 비율 제한이 있습니다.

  • Gemini Developer API:

    • 제한사항은 프로젝트의 Gemini Developer API '사용량 등급'에 따라 다릅니다( 비율 제한 문서 참고).

  • Vertex AI Gemini API:

    • Firebase 프로젝트당 동시 세션 수 1,000개
    • 분당 토큰 수 4백만 개

미디어 형식

Live API는 다음과 같은 유형의 미디어를 지원합니다.

  • 입력: 이미지, 오디오, 동영상
  • 출력: 오디오

이미지 형식

Live API는 이미지 입력에 다음을 지원합니다.

  • 프롬프트당 최대 이미지 수: 3,000개

  • 파일당 최대 파일 크기 (인라인 데이터): 7MB

  • 지원되는 MIME 유형: image/png, image/jpeg, image/webp, image/heic, image/heif

오디오 형식

Live API는 다음과 같은 오디오 형식을 지원합니다.

  • 입력 오디오 형식: 16kHz little-endian의 원시 16비트 PCM 오디오

  • 출력 오디오 형식: 24kHz little-endian의 원시 16비트 PCM 오디오

  • 지원되는 MIME 유형: audio/x-aac, audio/flac, audio/mp3, audio/m4a, audio/mpeg, audio/mpga, audio/mp4, audio/ogg, audio/pcm, audio/wav, audio/webm

입력 오디오의 샘플링 레이트를 전달하려면 오디오가 포함된 각 Blob의 MIME 유형을 audio/pcm;rate=16000과 같은 값으로 설정하세요.

동영상 형식

Live API는 개별 이미지 프레임 시퀀스를 예상하며 동영상 프레임 입력을 초당 1프레임 (FPS)으로 지원합니다.

  • 권장 입력: 1FPS에서 기본 768x768 해상도

  • 지원되는 MIME 유형: video/x-flv, video/quicktime, video/mpeg, video/mpegs, video/mpg, video/mp4, video/webm, video/wmv, video/3gpp

이 사양으로 인해 Live API는 고속 스포츠의 플레이별 분석과 같이 빠르게 변경되는 동영상을 분석해야 하는 사용 사례 에는 적합하지 않습니다.

응답 음성

Live API는 다음과 같은 응답 음성 옵션을 지원합니다. 각 음성의 데모는 다음에서 확인하세요. Chirp 3: HD 음성

응답 음성을 지정하지 않는 경우 기본값은 Puck입니다.

응답 음성을 지정하는 방법을 알아보세요.

Zephyr — 밝음
Kore — 단호함
Orus — 단호함
Autonoe — 밝음
Umbriel — 느긋함
Erinome — 선명함
Laomedeia — 명랑함
Schedar — 고름
Achird — 친근함
Sadachbia — 활기참 		Puck — 명랑함
Fenrir — 흥분하기 쉬움
Aoede — 산뜻함
Enceladus — 숨소리가 섞임
Algieba — 매끄러움
Algenib — 걸걸함
Achernar — 부드러움
Gacrux — 성숙함
Zubenelgenubi — 태평함
Sadaltager — 지식이 풍부함 		Charon — 정보 전달형
Leda — 젊음
Callirrhoe — 편안함
Iapetus — 명료함
Despina — 매끄러움
Rasalgethi — 정보 전달형
Alnilam — 단호함
Pulcherrima — 선도적임
Vindemiatrix — 온화함
Sulafat — 따뜻함

언어

Live API는 다음과 같은 언어를 지원합니다. 응답 언어에 영향을 미치는 방법을 알아보세요.

언어 BCP-47 코드 언어 BCP-47 코드
아랍어(이집트) ar-EG 독일어(독일) de-DE
영어(미국) en-US 스페인어(미국) es-US
프랑스어(프랑스) fr-FR 힌디어(인도) hi-IN
인도네시아어(인도네시아) id-ID 이탈리아어(이탈리아) it-IT
일본어(일본) ja-JP 한국어(대한민국) ko-KR
포르투갈어(브라질) pt-BR 러시아어(러시아) ru-RU
네덜란드어(네덜란드) nl-NL 폴란드어(폴란드) pl-PL
태국어(태국) th-TH 터키어(터키) tr-TR
베트남어(베트남) vi-VN 루마니아어(루마니아) ro-RO
우크라이나어(우크라이나) uk-UA 벵골어(방글라데시) bn-BD
영어(인도) en-IN 및 hi-IN 번들 마라티어(인도) mr-IN
타밀어(인도) ta-IN 텔루구어(인도) te-IN