# Как сохранить AI-видео до истечения временных ссылок скачивания? > Считайте URL провайдера краткосрочными учетными данными передачи, а не адресом ресурса. Ставьте скачивание в очередь сразу после завершения, потоково записывайте в постоянное объектное хранилище, проверяйте размер, тип и контрольную сумму и сохраняйте постоянный URI до завершения производственного задания. # Как сохранить AI-видео до истечения временных ссылок скачивания? Завершенная генерация не является постоянным ресурсом, пока байты не находятся в подконтрольном вам хранилище. Многие видео-API возвращают подписанный или временный URL для передачи, а не длительного воспроизведения. Если сохранить только ссылку, утвержденное видео исчезнет из приложения через часы или дни. Создайте отдельный этап приема после завершения генерации. Он забирает задачу скачивания, получает текущий URL, потоково пишет во временный объект, проверяет его и перемещает к детерминированному постоянному ключу. Только тогда производственное задание завершено. ## Считайте URL учетными данными Подписанный URL часто дает временный доступ без дополнительного заголовка авторизации, поэтому он чувствителен. Не показывайте его в аналитике, клиентских логах, тикетах или постоянных полях без строгого контроля. Вместо него храните: * ID задания провайдера; * ID результата, если доступен; * время выпуска и наблюдаемого истечения URL; * записи попыток скачивания; * финальный ключ хранилища; * проверочные метаданные и контрольную сумму. Если провайдер сообщает срок, планируйте скачивание заранее. Если срок не опубликован, считайте ссылку краткосрочной и сразу ставьте передачу в очередь. ## Разделите генерацию и прием ресурса Завершение генерации и постоянное сохранение — разные состояния. Удаленное задание может быть успешным, а локальное скачивание — нет. | Состояние | Значение | Следующее действие | |---|---|---| | `generating` | Провайдер создает видео | Опросить или ждать webhook | | `output_ready` | Результат готов | Поставить скачивание в очередь | | `downloading` | Воркер владеет передачей | Потоково писать во временное хранилище | | `verifying` | Байты получены | Проверить и вычислить сумму | | `stored` | Постоянный объект подтвержден | Сохранить URI | | `complete` | Метаданные и ресурс зафиксированы | Доставить потребителю | | `download_retry` | Временный сбой передачи | Обновить URL и повторить | | `needs_attention` | Автовосстановление невозможно | Эскалировать с доказательствами | Не завершайте задание в `output_ready`. Именно поэтому системы позже обнаруживают ссылки с истекшим сроком. ## Подтверждайте webhooks до скачивания Webhook должен проверить событие, сохранить его, поставить результат в очередь и быстро ответить. Скачивание большого видео внутри запроса рискует тайм-аутом и повторной доставкой. Дедуплицируйте по ID события либо паре ID задания и результата. Сделайте постановку идемпотентной: ```text download_key = provider + provider_job_id + output_id ``` Повторные webhooks сходятся в одной задаче. Опрос и webhook могут вызывать одну `ensure_download_task`. ## Потоково записывайте во временный объект Не читайте ответ полностью в память. Передавайте блоки во временный файл или многочастную загрузку и вычисляйте криптографическую сумму. Безопасная последовательность: 1. Забрать задачу с истекающей арендой. 2. Получить свежий URL, если API позволяет. 3. Отправить запрос с ограниченными тайм-аутами соединения и чтения. 4. Отклонить перенаправления на неожиданные хосты. 5. Потоково писать блоки, считать байты и SHA-256. 6. Закрыть временный объект. 7. Проверить медиа. 8. Переместить или скопировать к финальному ключу. 9. Зафиксировать URI и метаданные. Используйте обратное давление, чтобы воркер не буферизовал быстрее хранилища. Ограничивайте параллельность по пропускной способности, размеру и возможностям хранилища, а не только числу заданий. ## Проверяйте байты, а не только заголовки HTTP `200` может содержать HTML, JSON или обрезанный файл. `Content-Type: video/mp4` — полезный сигнал, но не доказательство. | Проверка | Выявляемая проблема | |---|---| | Ненулевой размер | Пустой ответ | | Ожидаемая длина | Обрезанная передача | | Сигнатура файла | HTML или JSON вместо видео | | Разбор контейнера | Поврежденная структура | | Длительность больше нуля | Неверное или неполное видео | | Размер и кодек | Нарушение контракта доставки | | SHA-256 | Измененные или повторные байты | | Пробное декодирование | Файл разбирается, но не воспроизводится | Храните наблюдаемые метаданные рядом. Сравнивайте их с запросом с подходящими допусками. Не отклоняйте корректное видео из-за нескольких кадров, если контракт не требует точности. ## Используйте детерминированные постоянные ключи Предсказуемый ключ делает повторы идемпотентными и ресурсы прослеживаемыми. Включите стабильную бизнес-идентичность, вариант и версию или сумму. ```text videos/{account}/{operation_id}/{attempt_id}/{output_id}-{sha256_prefix}.mp4 ``` Сначала пишите во временное пространство. После проверки перемещайте объект или фиксируйте указатель на ключ по сумме. Если другой воркер уже сохранил ту же сумму для той же задачи, переиспользуйте ее. Не помещайте пользовательские имена в путь без очистки. Оригинальное отображаемое имя храните в метаданных. ## Восстанавливайтесь после истечения и обрыва Классифицируйте ошибки: * разрыв соединения и временная ошибка хранения обычно повторяются с задержкой; * отказ авторизации или истечение требуют свежего URL; * not found может означать удаление ресурса; * повторная ошибка суммы или медиа должна остановить автоматические повторы; * локальная квота или права требуют операционного действия, а не вызова провайдера. Сохраняйте ID задания: многие API способны выдать новый URL готового задания после истечения первого. Проверяйте это для текущего эндпоинта. Продолжайте частичное скачивание только при проверенной поддержке диапазонов обеими сторонами и неизменной идентичности объекта. Иначе начните в новом временном объекте: смешивание байтов версий дает поврежденный файл. ## Учитывайте срок в графике повторов Обычная экспоненциальная задержка может превысить срок URL. ```text следующая задержка = min(экспоненциальная задержка, время до истечения - запас) ``` Если срок близок, обновите URL до повтора. Добавляйте случайность, чтобы все воркеры не подключились одновременно. Ограничивайте отдельно попытки передачи и обновления URL. ## Защитите путь хранения Постоянный объект должен следовать вашей политике доступа. По умолчанию используйте закрытые бакеты, серверное шифрование, узкие права воркера и краткосрочные ссылки просмотра. Не копируйте query-параметры исходного URL в метаданные: там могут быть подписи. Редактируйте URL в логах или храните только хост, хеш пути, время выпуска и истечения. При необходимости применяйте антивирус и модерацию. Соблюдайте границы арендаторов в ключах и авторизации, но не полагайтесь только на путь. ## Задайте политики хранения и производных Постоянное не значит вечное. | Класс ресурса | Соображение политики | |---|---| | Утвержденный мастер | Договор и цена регенерации | | Производная доставки | Воссоздается из мастера | | Отклоненная генерация | Короткое окно аудита или спора | | Временная загрузка | Автоудаление после проверки | | Прокси проверки | Хранить до утверждения | Записывайте состояние и причину удаления. Для воспроизводимости храните промпт, хеши источников, модель, параметры и права, но помните, что недетерминированная генерация не гарантирует те же байты. ## Отслеживайте время до надежного хранения Измеряйте интервал от завершения у провайдера до проверенного объекта. Это окно риска, когда временная ссылка — единственная копия. Следите за ожидающими результатами, возрастом старейшего, процентилями времени, истекшими URL, повторами, обновлениями ссылок, ошибками проверки, объемом байтов и заданиями, завершенными без постоянного URI. Последний показатель должен быть нулевым. Сигнализируйте до приближения очереди к кратчайшему сроку URL. ## Разделяйте доступ к модели и ответственность за хранение [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=save-ai-videos-before-download-links-expire) может предоставить одну OpenAI-совместимую платформу для текста, изображений и видео. Она упрощает метаданные и оплату, но приложение отвечает за копирование результатов в хранилище, соответствующее требованиям. Проверяйте поведение результата и обновления URL конкретной модели. Не выдумывайте срок и не предполагайте единый механизм. Пусть адаптер выражает различия конфигурацией и проверками возможностей. ## Итог Считайте временные URL истекающими учетными данными передачи. Ставьте скачивание в очередь сразу после генерации, потоково записывайте во временный объект, проверяйте медиа и перемещайте к детерминированному постоянному ключу. Записывайте URI и сумму до завершения задания и проектируйте обновление ссылок, повторы, хранение и мониторинг так, чтобы истечение URL не уничтожало единственную копию. ## FAQ ### Можно ли хранить URL провайдера как окончательный адрес видео? Нет. Подписанные и временные URL истекают, отзываются и меняются. Храните постоянный ключ объекта и ID задания провайдера, а свежий URL получайте лишь при необходимости. ### Следует ли воркеру загружать все видео в память? Обычно нет. Потоково записывайте ответ во временный файл или многочастную загрузку, одновременно вычисляя контрольную сумму, чтобы большой файл не исчерпал память. ### Что проверить перед отметкой видео как сохраненного? Проверьте HTTP-ответ, длину при наличии, сигнатуру, ожидаемый контейнер, ненулевую длительность, требования к размеру или кодеку, контрольную сумму и успешную постоянную запись. ### Что делать, если временный URL истек при скачивании? Сохраните производственное задание и удаленный ID, удалите или изолируйте неполный объект, запросите свежий URL, если возможно, и продолжите или перезапустите с учетом проверенной поддержки диапазонов. ### Как долго хранить исходные сгенерированные видео? Определяйте срок по потребностям клиента, закону, конфиденциальности, цене регенерации и бюджету хранения. Используйте политики жизненного цикла, а не случайную зависимость от URL провайдера. ### Может ли webhook сразу скачать видео? Обработчик должен быстро подтвердить событие и поставить скачивание в очередь. Отдельный воркер безопасно повторит передачу, проверит ресурс и не потеряет событие из-за долгой сети.