Live API 的限制和規格


本頁面說明使用 Live API 和其模型的各種限制和規格。

一般規格和限制

  • 支援的輸入和輸出： (詳情請參閱下方的媒體格式)

    • 輸入內容：文字、圖片 (不含 PDF)、音訊、影片
    • 輸出：文字 (轉錄稿) 和音訊 (串流)

  • 支援的工具：函式呼叫、以 Google Search 建立基準、以 Google Maps 建立基準

  • 知識截點日期：2025 年 1 月

Live API不支援產生結構化輸出內容 (例如 JSON) 或 Count Tokens API。

工作階段相關限制

如果是 Live API，工作階段是指持續連線，輸入和輸出內容會透過連線持續串流。

如果工作階段超出任何下列限制，連線就會終止。不過請注意，Live API 提供了一些選項 (如下所示)，可處理這些工作階段相關限制。

  • 工作階段脈絡窗口最多只能有 12.8 萬個權杖。

    由於有脈絡窗口限制，以下是根據輸入模式估算的對話長度上限：

    • 純語音輸入工作階段的時間上限為 15 分鐘。
    • 影片和音訊輸入內容的長度上限為 2 分鐘。

  • 連線時間上限約為 10 分鐘。

    連線結束前 60 秒，你會收到即將中斷通知。

以下是處理工作階段相關限制的幾種方式：

進一步瞭解如何管理工作階段。

頻率限制

Live API對每個 Firebase 專案的並行工作階段數，以及每分鐘權杖數 (TPM) 都有速率限制。

  • Gemini Developer API：

  • Vertex AI Gemini API：

    • 每個 Firebase 專案 1,000 個並行工作階段
    • 每分鐘 400 萬個符記

媒體格式

Live API 支援下列類型的媒體：

  • 輸入內容：圖片、音訊、影片
  • 輸出內容：音訊

圖片格式

Live API 支援下列圖片輸入內容：

  • 每個提示的圖片數量上限：3,000 張

  • 每個檔案 (內嵌資料) 大小上限：7 MB

  • 支援的 MIME 類型： image/png、image/jpeg、image/webp、image/heic、image/heif

音訊格式

Live API 支援下列音訊格式：

  • 輸入音訊格式：原始 16 位元 PCM 音訊，16 kHz 小端序

  • 輸出音訊格式：24 kHz 小端序的原始 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) 的視訊影格輸入。

  • 建議輸入：原生 768x768 解析度，每秒 1 幀。

  • 支援的 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