AI-bestanden bewaren: van PiAPI-uitvoer-URL naar duurzame opslag
Een voltooide generatie levert een resultaat op, maar een URL bij de aanbieder is geen permanente mediabibliotheek. Moeten gebruikers het resultaat later openen, bewerken of downloaden, kopieer het dan naar opslag onder uw beheer en volg die kopie los van de generatie.
1. Lees de uitvoer van het gebruikte model
Vraag het opgeslagen taak-ID op en eis data.status gelijk aan completed voordat u bestanden uitleest. De structuur van data.output verschilt per model en taaktype. Gebruik het bijbehorende opvraagvoorbeeld; verwacht niet overal dezelfde afbeelding- of video-URL op het hoogste niveau.
De gedocumenteerde Kling-respons bevat bijvoorbeeld een works-array met videobronnen. Andere modellen gebruiken andere velden. Bewaar taak-ID, model, taaktype, afrondingstijd en gekozen bronindex naast uw job, zodat een nieuwe poging hetzelfde resultaat terugvindt.
2. Kopieer snel en controleer bewaartermijnen per dienst
De PiAPI-documentatie over uitvoeropslag beschrijft verschillende regels per dienst en hostinglocatie. Sommige vermeldingen noemen korte termijnen; andere verwijzen naar het CDN-beleid van de aanbieder. De pagina bevat ook oudere diensten. Pas één termijn niet op alle huidige modellen toe en lees een ontbrekende termijn niet als onbeperkte opslag.
Start na afronding een achtergrondkopie via webhook of polling. Sla de job duurzaam op vóór bevestiging van de callback. De reeks hieronder toont opslagstatussen van uw toepassing, niet van de PiAPI-taak-API.
generation completed → copy queued → downloading → verified → saved
↘ copy failed → retry copy3. Controleer bytes voordat u het bestand als opgeslagen markeert
Download vanaf de resultaat-URL zonder uw PiAPI-API-sleutel door te sturen. Beperk toegestane bestemmingen, valideer omleidingen en stel grootte- en tijdslimieten in. Controleer HTTP-status, werkelijk aantal bytes, verwacht mediatype en basale leesbaarheid. Een HTML-foutpagina met status 200 is geen opgeslagen video.
Schrijf een tijdelijk object, bereken een controlesom en publiceer het definitieve object pas na validatie. Gebruik een stabiele sleutel op basis van taak-ID en bronindex. Registreer objectsleutel, bytes, controlesom en opslagtijd; bied uw eigen beheerde URL aan volgens uw toegangsbeleid.
4. Herhaal opslag los van generatie
Laat bij een kopieerfout de generatie op voltooid staan en herhaal de kopie zolang de bron beschikbaar is. Een blijvend uniek record voorkomt dubbele media-items. Is de URL niet meer leesbaar, vraag de taak opnieuw op en controleer de actuele uitvoer; dit garandeert geen herstel van verlopen bestanden. Test dubbele events, gedeeltelijke downloads en onbeschikbare URL’s vóór uitrol.
Bronnen: uitvoeropslag, Kling-taakopvraag en webhooks. Dit is een opslagpatroon voor uw toepassing, geen archiveringsbelofte van PiAPI.
