מגבלות ומפרטים של Live API


בדף הזה מתוארות המגבלות והמפרטים השונים לשימוש ב-Live API ובמודלים שלו.

מפרטים כלליים ומגבלות

  • קלט ופלט נתמכים: (לפרטים, ראו פורמטים של מדיה בהמשך)

    • קלט: טקסט, תמונות (לא קובצי PDF), אודיו, וידאו
    • פלט: טקסט (תמלול) ואודיו (סטרימינג)

  • כלים נתמכים: קריאה להפעלת פונקציות, ביסוס בעזרת Google Search, ביסוס בעזרת Google Maps

  • תאריך סף הידע: ינואר 2025

‫Live API לא תומך ביצירת פלט מובנה (כמו JSON) או ב-Count Tokens API.

מגבלות שקשורות לסשנים

ב-Live API, סשן הוא חיבור קבוע שבו הקלט והפלט מועברים בסטרימינג באופן רציף דרך החיבור.

אם הסשן חורג מאחת מהמגבלות הבאות, החיבור מסתיים. עם זאת, שימו לב שLive API מספק כמה אפשרויות (ראו בהמשך) לטיפול במגבלות האלה שקשורות לסשנים.

  • חלון ההקשר של הסשן מוגבל ל-128,000 טוקנים.

    בגלל המגבלה הזו של חלון ההקשר, אלה אורכי הסשנים המקסימליים המשוערים, בהתאם לאופני הקלט:

    • סשנים של קלט אודיו בלבד מוגבלים ל-15 דקות.
    • קלט של וידאו ואודיו מוגבל ל-2 דקות.

  • משך החיבור מוגבל לכ-10 דקות.

    כ-60 שניות לפני שהחיבור יסתיים, תקבלו התראה על כך שהחיבור עומד להסתיים.

הנה כמה אפשרויות לטיפול במגבלות שקשורות לסשנים:

מידע נוסף על ניהול סשנים

מגבלות קצב

ב-Live API יש מגבלות קצב גם על סשנים בו-זמניים לכל פרויקט ב-Firebase וגם על טוקנים לדקה (TPM).

  • Gemini Developer API:

  • Agent Platform Gemini API (formerly Vertex AI):

    • ‫1,000 סשנים בו-זמניים לכל פרויקט ב-Firebase
    • ‫4 מיליון טוקנים בדקה

פורמטים של מדיה

‫Live API תומך בסוגי המדיה הבאים:

  • קלט: תמונות, אודיו, וידאו
  • פלט: אודיו

פורמטים של תמונות

המודל Live API תומך באפשרויות הבאות להזנת תמונות:

  • מספר התמונות המקסימלי בכל הנחיה: 3,000

  • גודל הקובץ המקסימלי לכל קובץ (נתונים מוטבעים): 7MB

  • סוגי MIME נתמכים: image/png, image/jpeg, image/webp, image/heic, image/heif

פורמטים של אודיו

‫Live API תומך בפורמטים הבאים של קובצי אודיו:

  • פורמט קלט האודיו: אודיו PCM גולמי של 16 ביט ב-16kHz Little-endian

  • פורמט פלט האודיו: אודיו PCM גולמי של 16 ביט ב-24kHz Little-endian

  • סוגי MIME נתמכים: audio/x-aac, ‏ audio/flac, ‏ audio/mp3,‏ audio/m4a, ‏ audio/mpeg, ‏ audio/mpga, ‏ audio/mp4, ‏ audio/ogg,‏ audio/pcm, ‏ audio/wav, ‏ audio/webm

כדי להעביר את תדירות הדגימה של קלט האודיו, מגדירים את סוג ה-MIME של כל Blob שמכיל אודיו לערך כמו audio/pcm;rate=16000.

פורמטים של סרטונים

‫Live API מצפה לרצף של פריימים נפרדים של תמונות, ותומך בקלט של פריימים של וידאו בקצב של פריים אחד לשנייה (FPS).

  • קלט מומלץ: רזולוציה מקורית של 768x768 בקצב של 1 FPS.

  • סוגי MIME נתמכים: video/x-flv,‏ video/quicktime,‏ video/mpeg,‏ video/mpegs,‏ video/mpg,‏ video/mp4,‏ video/webm,‏ video/wmv,‏ video/3gpp

שימו לב שהמפרט הזה הופך את Live API ללא מתאים לתרחישי שימוש שדורשים ניתוח של סרטונים שמשתנים במהירות, כמו תיאור מהלך המשחק בספורט מהיר.

קולות לתשובות

ה-Live API תומך ב-30 קולות HD מסונתזים שונים, שלכל אחד מהם מאפיינים ייחודיים. כדי לראות רשימה של אפשרויות קוליות לתשובות ולשמוע הדגמות של כל קול, אתם יכולים להרחיב את הקטע שבהמשך.

אם לא מציינים קול לתשובה, ברירת המחדל היא Puck.

איך מציינים את הקול של התשובה

שפות

השפות הבאות נתמכות ב-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
שפות נוספות שנתמכות במודלים ליצירת אודיו בגרסה 3.x
שפה קוד BCP-47 שפה קוד BCP-47
אפריקאנס af פיליפינית פיליפינית
אלבנית sq פינית fi
אמהרית am גליציאנית gl
ארמנית hy גאורגית ka
אזרית az יוונית el
בסקית eu גוג'ארטי gu
בלארוסית be קריאולית האיטית ht
בולגרית bg עברית הוא
בורמזית my הונגרית hu
קטלאנית ca איסלנדית is
סבואנו ceb ג'אוונית jv
סינית, מנדרינית cmn קנאדה kn
קרואטית שעה קונקאני kok
צ'כית cs לאו lo
דנית da לטינית la
אסטונית et לטבית lv
ליטאית lt לוקסמבורגית lb
מקדונית mk מאיתילי mai
מלגשית מ"ג מלאית ms
מליאלאם ml מונגולית mn
נפאלית ne נורווגית (ספרותית) nb
נורווגית (נינורסק) nn אודיה או
פשטו ps פרסית fa
פנג'אבי pa סרבית sr
סינדהית sd סינהאלה si
סלובקית sk סלובנית sl
סווהילי sw שוודית sv
אורדו ur