Zapis plików AI: od adresu wyniku PiAPI do trwałego magazynu
Zakończone generowanie daje wynik, ale adres u dostawcy nie jest trwałą biblioteką multimediów. Jeśli użytkownicy mają później otwierać, edytować lub pobierać wynik, skopiuj plik do kontrolowanego magazynu i śledź kopię niezależnie od generowania.
1. Odczytaj wynik użytego modelu
Pobierz zapisane ID i wymagaj data.status równego completed przed wyodrębnieniem plików. Struktura data.output zależy od modelu i rodzaju zadania. Korzystaj z właściwego przykładu odczytu; nie zakładaj jednego wspólnego adresu obrazu lub filmu na najwyższym poziomie każdej odpowiedzi.
Na przykład udokumentowana odpowiedź Kling zawiera tablicę works z zasobami wideo. Inne modele stosują inne pola. Zapisz ID, model, typ zadania, czas zakończenia i indeks wybranego zasobu razem ze zleceniem, by ponowna próba odnalazła ten sam wynik.
2. Kopiuj szybko i sprawdzaj retencję dla usługi
Dokumentacja przechowywania PiAPI opisuje różne zasady zależnie od usługi i miejsca hostingu. Część wpisów podaje krótkie okresy; inne odsyłają do zasad CDN dostawcy. Strona obejmuje też dawne usługi. Nie stosuj jednego okresu do wszystkich obecnych modeli ani nie odczytuj braku informacji jako przechowywania bez ograniczeń.
Po zakończeniu uruchom kopiowanie w tle przez webhook lub polling. Trwale zapisz zlecenie przed potwierdzeniem callbacka. Sekwencja poniżej przedstawia stany magazynu twojej aplikacji, a nie stany API zadań PiAPI.
generation completed → copy queued → downloading → verified → saved
↘ copy failed → retry copy3. Sprawdź bajty przed oznaczeniem pliku jako zapisanego
Pobieraj wynik bez przekazywania klucza API PiAPI. Ogranicz dozwolone cele, weryfikuj przekierowania oraz limity rozmiaru i czasu. Sprawdź kod HTTP, faktyczną liczbę bajtów, oczekiwany typ mediów i podstawową czytelność. Strona błędu HTML ze statusem 200 nie jest zapisanym filmem.
Zapisz obiekt tymczasowy, policz sumę kontrolną i opublikuj obiekt końcowy dopiero po walidacji. Użyj stabilnego klucza opartego na ID zadania i indeksie zasobu. Zapisz klucz, bajty, sumę kontrolną i czas, a potem udostępniaj własny kontrolowany URL zgodnie z polityką dostępu.
4. Ponawiaj zapis niezależnie od generowania
Gdy kopiowanie zawiedzie, pozostaw generowanie jako zakończone i ponów kopię, dopóki źródło jest dostępne. Trwały unikalny rekord zapobiega duplikatom multimediów. Jeśli URL jest nieczytelny, pobierz zadanie ponownie i sprawdź aktualny wynik; nie gwarantuje to odzyskania wygasłego pliku. Przed wdrożeniem przetestuj duplikaty, częściowe pobrania i niedostępne adresy.
Źródła: przechowywanie wyników, odczyt zadania Kling i webhooki. To wzorzec magazynu aplikacji, nie obietnica archiwizacji przez PiAPI.
