Gemini API: какие размеры файлов и способы ввода поддерживаются сейчас
12 января 2026 года Google опубликовала обновление для разработчиков Gemini API, которое изменяет способы передачи файлов в модель и максимально допустимый размер этих файлов. Вкратце: Gemini теперь может напрямую загружать файлы из внешних ссылок и облачных хранилищ (без обязательной загрузки), а лимит inline-файлов существенно увеличен.
Эти изменения устраняют трение в реальных приложениях, где медиа и документы уже хранятся в облаке, и делают прототипирование и продакшн-процессы быстрее и дешевле.
CometAPI предоставляет доступ к Gemini API, включая Gemini 3 Pro и Gemini 3 Flash, по привлекательной цене.
Ключевые обновления — что нового в Gemini API
Прямое чтение внешних файлов
Gemini может получать файлы из следующих источников:
- Публичные HTTPS URL и подписанные URL (S3 Presigned URL, Azure SAS и т.д.)
- Google Cloud Storage (GCS) — регистрация объекта с возможностью повторного использования
Увеличение inline-лимита
Лимит inline-передачи данных увеличен с 20 МБ до 100 МБ
(для некоторых типов файлов, например PDF, действуют иные практические ограничения)
Files API для очень больших файлов — без изменений
Для файлов, превышающих inline/URL-лимиты или предназначенных для повторного использования, по-прежнему используется Files API:
- до 2 ГБ на файл
- до 20 ГБ на проект
- хранение по умолчанию — 48 часов
Регистрация объектов GCS также поддерживает файлы до 2 ГБ.
Совместимость моделей
Некоторые старые семейства моделей или специализированные версии имеют ограничения (например, отдельные модели Gemini 2.0). Перед передачей крупных файлов необходимо проверять документацию конкретной модели.
Почему эти изменения важны?
Ранее для анализа PDF, видео, аудио или изображений требовалось сначала загрузить файлы во временное хранилище Gemini.
При этом:
- файлы удалялись через 48 часов;
- максимальный размер составлял 20 МБ;
- файлы из GCS, S3 или Azure приходилось загружать повторно.
Это увеличивало трудозатраты, расходы на трафик и задержки, а также делало невозможными многие практические сценарии.
Теперь:
- Zero-Copy эффективность — модель обращается напрямую к данным
- Статeless-архитектура — меньше управления жизненным циклом файлов
- Мультиоблачная совместимость — AWS, Azure и GCP
- Поддержка мультимодальных AI-приложений
Текущие лимиты размеров файлов
В зависимости от способа передачи
- Inline (base64 / from_bytes) — до 100 МБ
(до 50 МБ для отдельных PDF-сценариев) - Внешний HTTP / подписанный URL — до 100 МБ
- Files API — до 2 ГБ на файл, до 20 ГБ на проект
- Регистрация GCS-объектов — до 2 ГБ
Новый стандарт 100 МБ
Повышение лимита inline-данных до 100 МБ позволяет:
- обрабатывать видео и аудио в реальном времени;
- быстро тестировать большие PDF и датасеты;
- отправлять сложные мультимодальные запросы за один вызов.
Для очень больших объёмов данных по-прежнему используются Files API и внешние ссылки.