GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Все руководства

· reAPI Team

Хранение данных API: сохраняй результаты до истечения срока действия ссылок

Планируй хранение данных API для созданных файлов, загруженных входных данных и резервных копий. Сохраняй результаты до истечения срока действия ссылок, проверяй копии и выясняй, что удаляется при удалении.

Хранение данных API: сохраняй результаты до истечения срока действия ссылок

Создание видео завершилось успешно. В базе данных есть ID задачи и URL для скачивания. Этого достаточно, чтобы понять, где находился результат, но это не архив видео.

Документированное значение по умолчанию в Replicate делает это различие важным: входные данные, значения результатов, файлы результатов и журналы прогнозов API удаляются через час. Для прогнозов, созданных на сайте, действует другое правило: они остаются, пока их не удалят вручную.[1] То, что файл ещё виден в веб-сеансе, не говорит о том, как долго результат API останется доступным для скачивания.

Если результат понадобится позже, процесс завершения должен скопировать фактические байты в хранилище под твоим контролем и проверить эту копию. При удалении нужно учитывать и версию у поставщика, и созданные тобой копии. Проследи путь одного файла через эти шаги — так вопросы хранения станут конкретными.

Назначь скачиванию отдельный статус завершения

Представь созданное видео. Генерация завершена, и архивный обработчик начинает копировать результат. Разделяй состояния «генерация завершена» и «копия проверена». Если скачивание не удалось, первое состояние может быть истинным, а второе — оставаться ложным.

Прочитай документированные поля результатов завершённой задачи и определи каждый файл, который хочешь сохранить. Если у задачи несколько результатов, сохраняй индекс результата или эквивалентный идентификатор вместе с ID задачи. Один флаг успешного выполнения не показывает, какой именно из нескольких файлов был скопирован.

Скачивай файл через разрешённый путь доступа приложения, записывай целевой объект и проверяй его, прежде чем показывать как надёжно сохранённый. Убедись, что нужный объект существует, передача завершена, а его размер и тип носителя выглядят правдоподобно. По возможности открой или декодируй собственную копию. Контрольная сумма может подтвердить соответствие скачанным байтам, но не доказывает, что созданная сцена верна или видео соответствует запросу клиента.

Храни вместе исходный URL, ID задачи, идентификатор результата, ключ целевого объекта и время копирования. Для последующего доступа приложения используй собственный идентификатор объекта. Если сохранить временный URL поставщика в другом столбце базы данных, независимая копия от этого не появится.

Если то же уведомление о завершении придёт снова, определи уже проверенную копию по идентификаторам задачи и результата. При необходимости повтори незавершённую передачу, но не создавай необъяснимые дубликаты только потому, что уведомление повторилось. Это предлагаемая схема работы приложения, а не утверждение, что каждый поставщик сам архивирует файлы за тебя.

Обработчик может отказать после успешной работы модели

В примере с видео предположим, что в момент завершения генерации архивный обработчик недоступен. Копия должна остаться в состоянии ожидания. Когда обработчик снова заработает, он сможет попытаться получить файл, пока источник доступен. Если срок действия источника истёк, зафиксируй сбой сохранения, а не помечай задачу архивированной без уведомления.

Не создавай видео заново и не называй это восстановлением исходного файла. Повторная генерация — другая операция: она может дать иное содержимое или привести к дополнительной оплате. Сначала проверь, есть ли уже проверенная копия или другой способ получения, описанный поставщиком. Например, fal указывает, что просроченные файлы CDN удаляются окончательно и восстановить их нельзя.[2]

Поэтому срок хранения нужно учитывать при проектировании задания на копирование. Если приложение не может надёжно архивировать файл в пределах применимого срока, измени этот процесс или организуй документированное хранилище до того, как обещать последующий доступ. То, что в одном случае ссылка проработала дольше, не гарантирует хранения.

В документации по задачам reAPI также советует своевременно копировать созданные результаты для долгосрочного архивирования. Там описаны результаты CDN, размещённые повторно, и сказано, что политики жизненного цикла настраиваются отдельно для каждого развёртывания и не гарантируются этим контрактом.[3] Это обосновывает сохранение собственной копии, но не устанавливает фиксированный срок истечения или бессрочное размещение для каждого возвращённого URL.

Для проверки восстановления используй разрешённый синтетический ресурс и прочитай целевую копию, не полагаясь на исходную ссылку поставщика. Сохрани результат проверки. Сообщение об успешной загрузке менее полезно, чем подтверждение, что приложение может получить и использовать принадлежащий тебе объект.

Запись запроса и медиафайл могут храниться разное время

В зависимости от правил сервиса задача для условного видео может оставаться видимой, когда файл уже недоступен. И наоборот, удаление содержимого запроса не обязательно удаляет каждый медиаобъект. Определи объект, прежде чем назначать ему срок хранения.

В документации fal указано, что входные и выходные данные в истории запросов по умолчанию хранятся 90 дней. Для файлов CDN предусмотрен отдельный настраиваемый срок хранения. X-Fal-Store-IO: 0 управляет хранением полезной нагрузки истории запросов; X-Fal-Object-Lifecycle-Preference управляет сроком жизни медиа, причём настройки отдельного запроса имеют приоритет над значениями по умолчанию для аккаунта.[2] Одна настройка истории не отключает всё хранение.

Загруженный входной файл добавляет ещё один объект. Исходное изображение может оставаться в твоём бакете, пока для создания видео используется копия у поставщика. Если позднее эти копии потребуется удалить, сохраняй связь между ними. Срок хранения выходного видео не определяет срок хранения исходного изображения.

Коллекции и общие представления — ещё один уровень. fal сообщает, что включение Assets, добавление файла в коллекцию или предоставление общего доступа к ней не продлевает срок жизни исходного файла.[4] Сохранённая связь в библиотеке может пережить период, когда медиафайл, на который она указывает, ещё пригоден к использованию.

То же относится к работе с документами. Многоразовые аннотации PDF могут содержать извлечённые данные, а не только ссылки на файл. Если приложение хранит их, учитывай эту копию при принятии решений о хранении наряду с исходным документом.

Удалить элемент библиотеки — не то же самое, что удалить файл

Предположим, видео уже архивировано в твоём бакете и ты хочешь удалить версию на стороне поставщика. Выбери операцию, соответствующую этой цели. Скрыть элемент в библиотеке, удалить его из коллекции и удалить файл CDN — разные действия.

В документации Assets от fal сказано, что удаление ресурса убирает его из библиотеки и результатов поиска, но само по себе не удаляет базовый файл CDN. Удаление из коллекции имеет ещё более узкую область действия: ресурс может остаться в библиотеке и других коллекциях.[4] Проверка только коллекции после удаления подтвердит состояние представления, а не удаление файла.

Для завершённой генерации fal документирует отдельную операцию удаления полезной нагрузки запроса, которая также затрагивает выходные файлы CDN. Она не удаляет входные файлы CDN, поскольку их могут повторно использовать другие запросы.[2] Если нужно удалить и исходное изображение, сначала проверь, не используется ли оно в других местах, а затем выполни подходящую файловую операцию.

Проверь результат на уровне файла. Ответ fal об удалении содержит cdn_delete_results: целевую ссылку и значение exception для каждого файла; null означает успешное удаление этого файла.[5] Общий ответ не повод игнорировать сообщение об исключении для одного из нескольких результатов.

Запиши время операции, её объекты и неразрешённые сбои. Последующая неудачная попытка скачать файл говорит об этом пути получения, но не доказывает, что исчезли все внутренние резервные копии или копии в последующих системах. Описывай удаление только в пределах документированной области операции и результатов, которые ты действительно проверил.

У действия Delete на сайте Replicate своя документированная область: оно удаляет прогноз, связанные выходные данные и файлы.[1] Используй правило для соответствующего пути создания, а не исходи из того, что кнопка удаления в любой панели работает так же, как действие библиотеки fal.

Отслеживай копии в экспортах и резервных копиях

Удаление версии поставщика не удаляет видео, которое теперь хранится в твоём бакете. Если клиент скачал экспорт, это ещё одна копия. Отзыв ссылки для совместного доступа прекращает доступ по этой ссылке, но не возвращает файлы, уже скачанные получателями; в рекомендациях fal по совместному доступу эти результаты явно различаются.[4]

Для копий под твоим контролем храни вместе с объектом идентификаторы задачи и результата, владельца, место хранения и правило удаления. Тогда последующий запрос на удаление можно будет выполнить без временного URL или имени экспортного файла без метки. Учитывай созданные процессом предварительные просмотры, сохранённые версии и копии для миграции.

Для резервных копий тоже нужно принять явное решение. Храни их для предполагаемой цели восстановления и учитывай, как согласовать восстановленные данные с последующими удалениями. Иначе восстановление более старой резервной копии может вернуть содержимое, уже удалённое приложением. При миграции хранилища проверь целевую копию до переключения ссылок, а затем перенеси вместе с данными решения о владении и сроке хранения.

Исходные файлы, предварительные просмотры и резервные копии тоже занимают место в целевом хранилище. Оценивая стоимость хранения, учитывай число копий и срок хранения каждой из них: удаление версии поставщика не устраняет расходы на твой собственный архив.

В договорах о созданных результатах, рассмотренных здесь, нет универсального требования хранить данные семь лет. Для разных типов записей могут действовать разные требования; срок хранения счёта-фактуры не должен автоматически становиться сроком хранения каждого созданного видео. Определи применимую политику для объекта и цели, а не выбирай привычный срок.

Где хранятся данные? В этом примере это может быть история запросов поставщика, медиафайлы CDN, принадлежащий тебе объект, экспорты и резервные копии. Географическое размещение данных — отдельный вопрос договора. По URL медиафайла нельзя определить, где обрабатывается или хранится каждая копия.

Разделяй вопросы хранения, совместного доступа и обучения

Утверждение, что данные не используются для обучения, не означает, что они никогда не хранятся. Руководство OpenAI по данным API различает журналы мониторинга злоупотреблений и состояние приложения. Средства управления Zero Data Retention доступны подходящим требованиям и одобренным клиентам и по-прежнему имеют ограничения для конечных точек и функций.[6] Уточни область действия для конкретной организации, проекта и операции.

fal также указывает, что настройки истории запросов и CDN не задают журналирование приложения владельца развёртывания или постоянное хранилище, которым управляет приложение. Пользователям, которым нужен ZDR, предлагается подтвердить охват конечных точек.[2] Один заголовок не описывает все копии в рабочем процессе, где также используются приложение, инструменты и твоё собственное хранилище.

Итоговая запись для условного видео должна теперь отвечать на два практических вопроса: какая проверенная копия будет использоваться для будущих скачиваний и какие другие копии удалены либо остаются по указанному правилу? Не скрывай сбой передачи или исключение при удалении отдельного файла, пока проблема не решена. Так приложение сможет различать завершённую генерацию, доступный архив и завершённое удаление, не выдавая их за одно и то же событие.

Источники

  1. Replicate, «Data retention», официальная документация по predictions. Прочитано 16 ноября 2026 года; правила API по умолчанию и удаление на сайте имеют разную область действия.
  2. fal, «Data retention and storage», официальная документация Model APIs. Прочитано 16 ноября 2026 года; история запросов, CDN и обязанности владельца развёртывания различаются.
  3. reAPI, документация по задачам, формат результатов и рекомендации по архивированию. Проверено 16 ноября 2026 года.
  4. fal, «Retention and deletion», официальная документация Assets. Прочитано 16 ноября 2026 года; действия библиотеки, срок хранения файлов и скачанные копии.
  5. fal, «Delete request payloads», официальная справка Platform API. Прочитано 16 ноября 2026 года; результаты удаления отдельных файлов. Для этой статьи удаление не выполнялось.
  6. OpenAI, Твои данные. Прочитано 16 ноября 2026 года; политика обучения, средства управления хранением и ограничения конечных точек.
Все руководства