# Jak zapisać filmy AI przed wygaśnięciem tymczasowych linków pobierania? > Traktuj URL dostawcy jako krótkotrwałe dane dostępu do transferu, nie lokalizację zasobu. Kolejkuj pobieranie po ukończeniu, przesyłaj strumieniowo do trwałego storage, weryfikuj rozmiar, typ i checksum oraz zapisz stały URI przed ukończeniem zadania. # Jak zapisać filmy AI przed wygaśnięciem tymczasowych linków pobierania? Ukończona generacja nie jest trwałym zasobem, dopóki bajty nie znajdą się w storage pod twoją kontrolą. Wiele API zwraca podpisany lub tymczasowy URL przeznaczony do transferu, nie długiego odtwarzania. Zapisanie tylko linku może sprawić, że zatwierdzony film zniknie po godzinach lub dniach. Zbuduj osobny etap ingestii uruchamiany po zakończeniu. Przejmuje zadanie pobierania, uzyskuje aktualny URL, przesyła media do obiektu tymczasowego, weryfikuje je i promuje pod deterministyczny klucz stały. Dopiero wtedy zadanie produkcyjne jest ukończone. ## Traktuj URL jako dane uwierzytelniające Podpisany URL często daje tymczasowy dostęp bez dodatkowego nagłówka autoryzacji, więc jest wrażliwy. Nie ujawniaj go w analityce, logach klientów, ticketach ani trwałych polach bez ścisłej kontroli. Zamiast tego przechowuj: * ID zadania dostawcy; * ID wyniku, jeśli dostępne; * czas wydania i obserwowanego wygaśnięcia; * rekordy prób pobierania; * końcowy klucz storage; * metadane weryfikacji i checksum. Jeśli dostawca podaje czas wygaśnięcia, planuj pobranie odpowiednio wcześnie. Jeśli czas nie jest znany, zakładaj krótki okres i kolejkuj natychmiast. ## Oddziel generowanie od ingestii zasobu Zakończenie generowania i trwały zapis to różne stany. Zdalne zadanie może się udać, a lokalne pobieranie nie. | Stan | Znaczenie | Następne działanie | |---|---|---| | `generating` | Dostawca tworzy film | Polling lub webhook | | `output_ready` | Wynik gotowy | Zakolejkuj pobieranie | | `downloading` | Worker posiada transfer | Przesyłaj do storage tymczasowego | | `verifying` | Bajty dotarły | Sprawdź i oblicz checksum | | `stored` | Trwały obiekt potwierdzony | Zapisz stały URI | | `complete` | Metadane i zasób zatwierdzone | Dostarcz | | `download_retry` | Błąd tymczasowy | Odśwież URL i ponów | | `needs_attention` | Automatyczne odzyskanie niemożliwe | Eskaluj z dowodami | Nie oznaczaj zadania jako ukończone w `output_ready`. Ten skrót jest główną przyczyną linków, które później wygasają. ## Potwierdź webhook przed pobieraniem Handler powinien zweryfikować zdarzenie, zapisać je, zakolejkować wynik i szybko odpowiedzieć. Pobieranie dużego filmu wewnątrz żądania grozi timeoutem i powtórnym dostarczeniem. Dedupikuj po ID zdarzenia lub kombinacji ID zadania i wyniku. Uczyń kolejkowanie idempotentnym: ```text download_key = provider + provider_job_id + output_id ``` Powtórne webhooks zbiegną się w jednym zadaniu. Polling i webhook mogą wołać tę samą `ensure_download_task`. ## Przesyłaj do obiektu tymczasowego Nie wczytuj całej odpowiedzi do pamięci. Przesyłaj bloki do pliku lub uploadu wieloczęściowego i obliczaj kryptograficzny checksum. Bezpieczna sekwencja: 1. Przejmij zadanie wygasającą dzierżawą. 2. Uzyskaj świeży URL, jeśli API na to pozwala. 3. Wyślij z ograniczonym timeoutem połączenia i odczytu. 4. Odrzuć przekierowania do nieoczekiwanych hostów. 5. Przesyłaj bloki, licz bajty i SHA-256. 6. Zamknij obiekt tymczasowy. 7. Zweryfikuj media. 8. Promuj lub kopiuj do klucza końcowego. 9. Zatwierdź URI i metadane. Używaj backpressure, aby worker nie buforował szybciej niż storage. Ograniczaj równoległość według pasma, rozmiaru i pojemności, nie tylko liczby zadań. ## Weryfikuj bajty, nie tylko nagłówki HTTP `200` może zawierać HTML, JSON lub ucięty plik. `Content-Type: video/mp4` jest wskazówką, nie dowodem. | Weryfikacja | Wykrywany problem | |---|---| | Niezerowa liczba bajtów | Pusta odpowiedź | | Oczekiwana długość | Ucięty transfer | | Sygnatura pliku | HTML lub JSON jako film | | Analiza kontenera | Uszkodzona struktura | | Czas większy niż zero | Nieprawidłowy film | | Wymiary i kodek | Wynik poza kontraktem | | SHA-256 | Zmienione lub powtórzone bajty | | Próbne dekodowanie | Plik analizuje się, lecz nie odtwarza | Zapisuj obserwowane metadane obok obiektu. Porównuj czas i rozdzielczość z odpowiednimi tolerancjami. Nie odrzucaj poprawnego filmu przez kilka klatek różnicy, jeśli kontrakt nie wymaga dokładności. ## Używaj deterministycznych kluczy trwałych Przewidywalny klucz czyni retry idempotentnym i zasób śledzalnym. Uwzględnij tożsamość biznesową, wariant i wersję lub checksum. ```text videos/{account}/{operation_id}/{attempt_id}/{output_id}-{sha256_prefix}.mp4 ``` Najpierw zapisuj tymczasowo. Po weryfikacji promuj obiekt lub zatwierdź wskaźnik do klucza adresowanego checksumem. Jeśli inny worker zapisał już ten sam checksum dla zadania, użyj go ponownie. Nie umieszczaj nazw użytkownika w ścieżkach bez oczyszczenia. Oryginalną nazwę zachowaj jako metadane. ## Odzyskuj po wygaśnięciu i przerwaniu Klasyfikuj błędy: * zerwanie połączenia i tymczasowy błąd storage można ponowić z backoffem; * autoryzacja lub wygaśnięcie wymagają świeżego URL; * not found może oznaczać usunięcie zasobu; * powtarzający się błąd checksum lub mediów powinien zatrzymać retry; * lokalna quota lub prawa wymagają działania operacyjnego, nie nowej call. Zachowaj ID zadania. Wiele API może wydać nowy URL dla ukończonego zadania. Sprawdź zachowanie aktualnego endpointu. Wznawiaj częściowy transfer tylko przy zweryfikowanych zakresach po obu stronach i niezmiennej tożsamości obiektu. Inaczej zacznij w nowym obiekcie; mieszanie wersji może uszkodzić plik. ## Wybierz retry uwzględniający wygaśnięcie Zwykły backoff może czekać dłużej niż życie linku. Ogranicz opóźnienie: ```text następne opóźnienie = min(backoff, czas do wygaśnięcia - margines) ``` Jeśli URL zaraz wygaśnie, odśwież go przed retry. Dodaj jitter, aby wszyscy workerzy nie łączyli się jednocześnie. Ustal osobne limity transferów i odświeżeń. ## Zabezpiecz ścieżkę storage Stały obiekt powinien przestrzegać polityki dostępu. Używaj prywatnych bucketów, odpowiedniego szyfrowania, wąskich uprawnień i krótkich URL dostawy. Nie kopiuj query string do metadanych, bo może zawierać podpisy. Redaguj URL w logach lub zachowuj tylko host, hash ścieżki, wydanie i wygaśnięcie. Stosuj skanowanie lub moderację, gdy wymagane. Utrzymuj granice tenantów w kluczach i autoryzacji, ale nie polegaj tylko na nazwie ścieżki. ## Utwórz polityki retencji i pochodnych Trwały nie znaczy wieczny. | Klasa zasobu | Rozważanie | |---|---| | Zatwierdzony master | Umowa i koszt regeneracji | | Pochodna dostawy | Może być odtworzona z mastera | | Odrzucona generacja | Krótkie okno audytu lub sporu | | Upload tymczasowy | Automatyczne usunięcie po weryfikacji | | Proxy review | Przechowuj do zatwierdzenia | Rejestruj stan i powód usunięcia. Dla odtwarzalności zachowaj prompt, hashe źródeł, model, parametry i prawa, wiedząc, że generowanie niedeterministyczne może nie odtworzyć identycznych bajtów. ## Monitoruj czas do trwałości Mierz czas od zakończenia u dostawcy do zweryfikowanego storage. To okno ryzyka, gdy tymczasowy link jest jedyną kopią. Śledź oczekujące wyniki, wiek najstarszego, percentyle, odpowiedzi wygasłych URL, retry, odświeżone linki, błędy weryfikacji, bajty i zadania kompletne bez trwałego URI. Ostatni wskaźnik powinien wynosić zero. Alarmuj zanim zaległość zbliży się do najkrótszego czasu życia. ## Wyjaśnij odpowiedzialność za modele i storage [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=save-ai-videos-before-download-links-expire) może zapewnić jedną platformę zgodną z OpenAI dla tekstu, obrazu i wideo. Ujednolicenie upraszcza metadane i rozliczenia, ale aplikacja odpowiada za kopiowanie wyników do storage spełniającego wymagania. Sprawdź dokładne zachowanie wyniku i odświeżania dla bieżącego endpointu. Nie wymyślaj czasu wygaśnięcia i nie zakładaj jednego mechanizmu dla wszystkich modeli. Różnice ujmuj jako konfigurację i kontrolę możliwości. ## Podsumowanie Zapisuj filmy, traktując tymczasowe URL jako wygasające dane transferu. Kolejkuj pobieranie natychmiast, przesyłaj do obiektu tymczasowego, weryfikuj media i promuj do deterministycznego klucza. Zapisz URI i checksum przed ukończeniem oraz zaprojektuj odświeżanie, retry, retencję i monitoring tak, by wygaśnięcie nie zabrało jedynej kopii. ## FAQ ### Czy mogę przechowywać URL pobierania jako ostateczną lokalizację filmu? Nie. Podpisane lub tymczasowe URL mogą wygasnąć, zostać cofnięte lub się zmienić. Przechowuj trwały klucz obiektu i ID zadania, a świeży URL pobieraj tylko w razie potrzeby. ### Czy worker powinien ładować cały film do pamięci? Zwykle nie. Przesyłaj odpowiedź strumieniowo do pliku tymczasowego lub uploadu wieloczęściowego, obliczając checksum, aby duży plik nie wyczerpał pamięci. ### Co zweryfikować przed oznaczeniem filmu jako zapisanego? Sprawdź odpowiedź HTTP, długość, sygnaturę pliku, oczekiwany kontener, niezerowy czas, wymagania wymiarów lub kodeka, checksum i udany zapis trwały. ### Co zrobić, gdy URL wygasa podczas pobierania? Zachowaj zadanie i zdalny ID, usuń lub odizoluj niepełny obiekt, poproś o świeży URL, jeśli to możliwe, i wznów lub rozpocznij od nowa zgodnie ze zweryfikowaną obsługą zakresów. ### Jak długo przechowywać oryginalne filmy? Ustal retencję według potrzeb klienta, prawa i prywatności, kosztu regeneracji i budżetu storage. Używaj polityk cyklu życia zamiast zależności od URL dostawcy. ### Czy webhook może bezpośrednio pobrać film? Powinien szybko potwierdzić i zakolejkować pobieranie. Osobny worker bezpiecznie ponowi transfer, zweryfikuje zasób i uniknie utraty zdarzeń przez długie połączenie.