Успешная загрузка в Gemini Files API ещё не означает, что файл можно передать модели. Проверяйте состояние ресурса после загрузки (upload), а не только наличие uri, адреса загруженного файла.
Иначе следующий шаг автоматизации стартует раньше обработки или продолжает работать со ссылкой на уже удалённый файл.
Если код ждёт, пока закончится PROCESSING, одного выхода из цикла недостаточно. Обработка могла завершиться не только состоянием ACTIVE: проверяйте конечный статус явно.
Какие состояния разрешают работу с файлом
Справочник Files API разделяет:
- PROCESSING: обработка продолжается, передавать файл модели ещё нельзя.
- ACTIVE: файл обработан и доступен для запроса модели.
- FAILED: обработка завершилась неудачей; нужно разобрать поле error.
Неизвестное или отсутствующее состояние тоже не стоит превращать в зелёный сигнал.
Как дождаться обработки
- Сохраните name, имя загруженного ресурса. Запрашивайте его метаданные через files.get.
- При PROCESSING подождите и запросите состояние снова. Задайте паузу между проверками и общий срок ожидания, чтобы цикл не продолжался бесконечно.
- Продолжайте только при ACTIVE. При FAILED остановите цепочку и сохраните обезличенные поля ошибки: code, message и details.
Почему вчерашний uri перестал работать
Обычные загруженные файлы автоматически удаляются через 48 часов. У ресурса предусмотрено expirationTime, время истечения срока хранения; при планировании отложенных задач учитывайте его, а не дату последнего успешного ответа.
Храните исходник у себя и предусмотрите повторную загрузку с обновлением ссылки. Files API не является вашим постоянным архивом: руководство Google также предупреждает, что пользовательские загруженные файлы нельзя скачать обратно через этот API.
Если ресурс уже ACTIVE, но модель всё равно отказывает, переходите к отдельной проверке доступа и параметров запроса. Не лечите любую ошибку повторной загрузкой: это может лишь создать несколько копий и скрыть исходную проблему.
Отдельно различайте Files API, File Search и контекстный кэш. Похожие названия не делают их одним хранилищем и не позволяют переносить между ними сроки жизни.
Проверено 10 ноября 2026 года. Это алгоритм диагностики по документации, без заявления о проведённом тесте.
Последнее редактирование: