محدودیت‌ها و مشخصات رابط برنامه‌نویسی کاربردی زنده


این صفحه محدودیت‌ها و مشخصات مختلف استفاده از Live API و مدل‌های آن را شرح می‌دهد.

مشخصات عمومی و محدودیت‌ها

  • ورودی و خروجی پشتیبانی شده : (برای جزئیات، به فرمت‌های رسانه‌ای زیر مراجعه کنید)

    • ورودی: متن، تصاویر (نه PDF)، صدا، ویدیو
    • خروجی: متن (رونویسی) و صدا (پخش زنده)

  • ابزارهای پشتیبانی‌شده : فراخوانی تابع، اتصال به زمین با Google Search ، اتصال به زمین با Google Maps

  • تاریخ پایان مهلت دریافت دانش : ژانویه ۲۰۲۵

Live API از تولید خروجی ساختاریافته (مانند JSON) یا API شمارش توکن‌ها پشتیبانی نمی‌کند .

محدودیت‌های مربوط به جلسه

برای Live API ، یک جلسه به یک اتصال پایدار اشاره دارد که در آن ورودی و خروجی به طور مداوم از طریق یک اتصال پخش می‌شوند.

اگر جلسه از هر یک از محدودیت‌های زیر فراتر رود، اتصال قطع می‌شود. البته توجه داشته باشید که Live API گزینه‌هایی (به زیر مراجعه کنید) برای مدیریت این محدودیت‌های مربوط به جلسه ارائه می‌دهد.

  • پنجره‌ی زمینه‌ی جلسه به ۱۲۸ هزار توکن محدود شده است.

    با توجه به این محدودیت پنجره زمینه، در اینجا حداکثر طول تقریبی جلسات بر اساس روش‌های ورودی آمده است:

    • جلسات ورودی فقط صوتی به ۱۵ دقیقه محدود می‌شوند.
    • ورودی ویدیو + صدا به ۲ دقیقه محدود می‌شود.

  • مدت زمان اتصال به حدود 10 دقیقه محدود شده است.

    حدود ۶۰ ثانیه قبل از پایان اتصال ، اعلانی مبنی بر قطع شدن اتصال دریافت خواهید کرد.

در اینجا چند گزینه برای مدیریت محدودیت‌های مربوط به جلسه وجود دارد:

درباره مدیریت جلسات بیشتر بدانید.

محدودیت‌های نرخ

Live API برای هر دو جلسه همزمان در هر پروژه Firebase و همچنین توکن در هر دقیقه (TPM) محدودیت‌های سرعت دارد.

  • رابط برنامه‌نویسی کاربردی توسعه‌دهندگان جمینی :

  • API مربوط به Vertex AI Gemini :

    • ۱۰۰۰ جلسه همزمان در هر پروژه Firebase
    • ۴ میلیون توکن در دقیقه

قالب‌های رسانه‌ای

Live API از انواع رسانه‌های زیر پشتیبانی می‌کند:

  • ورودی : تصویر، صدا، ویدئو
  • خروجی : صوتی

قالب‌های تصویر

Live API از موارد زیر برای ورودی تصویر پشتیبانی می‌کند:

  • حداکثر تصاویر در هر اعلان : ۳۰۰۰

  • حداکثر اندازه هر فایل (داده درون‌خطی) : ۷ مگابایت

  • انواع MIME پشتیبانی شده : image/png ، image/jpeg ، image/webp ، image/heic ، image/heif

فرمت‌های صوتی

Live API از فرمت‌های صوتی زیر پشتیبانی می‌کند:

  • فرمت صدای ورودی: صدای خام PCM با نرخ ۱۶ بیت و فرکانس ۱۶ کیلوهرتز (little-endian)

  • فرمت صدای خروجی: صدای خام PCM با نرخ 16 بیت و فرکانس 24 کیلوهرتز (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) پشتیبانی می‌کند.

  • ورودی پیشنهادی : وضوح تصویر اصلی ۷۶۸x۷۶۸ با سرعت ۱ فریم در ثانیه.

  • انواع 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 voices مراجعه کنید.

اگر صدای پاسخ را مشخص نکنید، صدای پیش‌فرض 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
انگلیسی (آمریکایی) انگلیسی-آمریکایی اسپانیایی (آمریکایی) es-US
فرانسوی (فرانسه) fr-FR هندی (هند) سلام-ورودی
اندونزیایی (اندونزیایی) شناسه-شناسه ایتالیایی (ایتالیا) فناوری اطلاعات
ژاپنی (ژاپن) جا-جی پی کره‌ای (کره) کو-کی‌آر
پرتغالی (برزیل) پی تی-بی آر روسی (روسیه) ru-RU
هلندی (هلند) nl-NL لهستانی (لهستان) پی ال-پی ال
تایلندی (تایلند) ام-ام ترکی (ترکیه) تر-تی‌آر
ویتنامی (ویتنام) vi-VN رومانیایی (رومانیایی) ro-RO
اوکراینی (اوکراین) انگلستان-آمریکا بنگالی (بنگلادش) بی ان-بی دی
انگلیسی (هند) بسته en-IN و hi-IN مراتی (هند) آقای-IN
تامیل (هند) تا-این تلوگو (هند) te-IN