AI dosyalarını saklayın: PiAPI çıktı URL’sinden kalıcı depolamaya
Tamamlanan üretim sonuç verir, ancak sağlayıcının barındırdığı URL kalıcı medya arşiviniz değildir. Kullanıcıların sonucu daha sonra açması, düzenlemesi veya indirmesi gerekiyorsa dosyayı kontrol ettiğiniz depoya kopyalayın ve kopyayı üretimden ayrı izleyin.
1. Kullandığınız modelin çıktısını okuyun
Kaydedilen görev kimliğini sorgulayın ve dosyaları çıkarmadan önce data.status değerinin completed olmasını şart koşun. data.output yapısı model ve görev türüne göre değişir. İlgili sorgu örneğini kullanın; her yanıtta aynı üst düzey görüntü veya video URL’si olduğunu varsaymayın.
Örneğin belgelenen Kling yanıtında video kaynakları içeren bir works dizisi vardır. Başka modeller farklı alanlar kullanır. Yeniden denemede aynı sonucu bulmak için görev kimliği, model, görev türü, bitiş zamanı ve seçili kaynak indeksini işinizle birlikte saklayın.
2. Hemen kopyalayın ve saklama süresini hizmete göre kontrol edin
PiAPI’nin çıktı depolama belgeleri, hizmet ve barındırma konumuna göre farklı kurallar açıklar. Bazı kayıtlar kısa süreler belirtir, diğerleri sağlayıcının CDN politikasına dayanır. Sayfada eski hizmetler de vardır. Bir sürenin tüm güncel modellere uyduğunu veya belirtilmeyen sürenin sınırsız olduğunu varsaymayın.
Tamamlanınca webhook veya sorgulama akışı ile arka plan kopyasını başlatın. Geri çağrıyı onaylamadan işi kalıcı kaydedin. Aşağıdaki sıra uygulamanızın depolama durumlarını gösterir; bunlar PiAPI görev API’sinin durumları değildir.
generation completed → copy queued → downloading → verified → saved
↘ copy failed → retry copy3. Kaydedildi demeden baytları doğrulayın
Sonuç URL’sinden indirirken PiAPI API anahtarını iletmeyin. İzin verilen hedefleri sınırlayın, yönlendirmeleri doğrulayın, boyut ve zaman sınırı koyun. HTTP durumunu, gerçek bayt sayısını, beklenen medya türünü ve temel okunabilirliği kontrol edin. 200 döndüren HTML hata sayfası kaydedilmiş video değildir.
Geçici nesneye yazın, sağlama toplamı hesaplayın ve doğrulama başarılıysa son nesneyi yayımlayın. Görev kimliği ve kaynak indeksinden türetilen sabit anahtar kullanın. Nesne anahtarı, bayt sayısı, sağlama toplamı ve kayıt zamanını tutun; erişim politikanıza göre kendi kontrollü URL’nizi sunun.
4. Depolamayı üretimden ayrı yeniden deneyin
Kopyalama başarısızsa üretimi tamamlanmış bırakın ve kaynak mevcutken kopyayı yeniden deneyin. Kalıcı benzersiz kayıt, yinelenen olayların çift medya girdisi oluşturmasını engeller. URL okunamıyorsa görevi yeniden sorgulayıp güncel çıktıyı inceleyin; bu, süresi dolan dosyanın kurtarılacağını garanti etmez. Yayımlamadan önce çift olayları, kısmi indirmeleri ve erişilemeyen URL’leri sınayın.
Kaynaklar: çıktı depolama, Kling görev sorgusu ve webhook. Bu bir uygulama depolama düzenidir; PiAPI’nin arşiv saklama taahhüdü değildir.
