# Hoe sla je AI-video's op voordat tijdelijke downloadlinks verlopen? > Behandel provider-URL's als kortlevende overdrachtsgegevens, niet als assetlocaties. Zet download direct na voltooiing in de wachtrij, stream naar duurzame objectopslag, controleer grootte, type en checksum en registreer de permanente URI voordat de productietaak compleet wordt. # Hoe sla je AI-video's op voordat tijdelijke downloadlinks verlopen? Een voltooide generatie is geen duurzaam asset totdat de bytes in opslag onder jouw beheer staan. Veel video-API's geven een ondertekende of tijdelijke download-URL voor overdracht, niet langdurige weergave. Alleen de URL bewaren kan een goedgekeurde video uren of dagen later laten verdwijnen. Bouw een aparte ingeststap die start bij voltooiing. Die claimt een downloadtaak, haalt een actuele URL, streamt media naar een tijdelijk object, valideert het en promoveert naar een deterministische permanente sleutel. Pas dan wordt de productietaak compleet. ## Behandel de URL als credential Een ondertekende URL geeft vaak tijdelijke toegang zonder extra autorisatieheader en is dus gevoelig. Stel hem niet bloot in analytics, klantlogs, tickets of permanente databasevelden zonder strikte controle. Bewaar in plaats daarvan: * provider-taak-ID; * provider-uitvoer-ID indien beschikbaar; * uitgifte- en waargenomen vervaltijd; * downloadpogingen; * definitieve objectsleutel; * verificatiemetadata en checksum. Geeft de provider een vervaltijd, plan dan ruim daarvoor. Is geen levensduur gepubliceerd, neem dan aan dat de link kort leeft en zet de overdracht direct in de wachtrij. ## Scheid generatie van asset-ingestie Generatievoltooiing en duurzame opslag zijn verschillende statussen. Een remote taak kan slagen terwijl de lokale download mislukt. | Status | Betekenis | Volgende actie | |---|---|---| | `generating` | Provider maakt video | Poll of wacht op webhook | | `output_ready` | Voltooide uitvoer gemeld | Zet download in wachtrij | | `downloading` | Worker bezit overdracht | Stream naar tijdelijke opslag | | `verifying` | Bytes ontvangen | Inspecteer en bereken checksum | | `stored` | Duurzaam object bevestigd | Bewaar permanente URI | | `complete` | Metadata en asset vastgelegd | Lever aan gebruiker | | `download_retry` | Tijdelijke overdrachtsfout | Vernieuw URL en herhaal | | `needs_attention` | Automatisch herstel onmogelijk | Escaleer met bewijs | Markeer niet compleet bij `output_ready`. Die snelkoppeling veroorzaakt databases die later naar verlopen links wijzen. ## Bevestig webhooks vóór downloaden Een webhookhandler moet het event valideren, opslaan, de uitvoer in de wachtrij zetten en snel reageren. Een grote video binnen het webhookverzoek downloaden riskeert time-outs en herhaalde levering. Dedupliceer op event-ID of combinatie van taak- en uitvoer-ID. Maak enqueue idempotent: ```text download_key = provider + provider_job_id + output_id ``` Herhaalde webhooks komen op één taak uit. Polling en webhooks kunnen dezelfde `ensure_download_task` aanroepen. ## Stream naar een tijdelijk object Lees het volledige antwoord niet in geheugen. Stream blokken naar een tijdelijk bestand of multipart upload terwijl een cryptografische checksum wordt berekend. Veilige volgorde: 1. Claim de taak met een aflopende lease. 2. Haal een verse URL indien ondersteund. 3. Verstuur met begrensde verbindings- en leestime-outs. 4. Weiger redirects naar onverwachte hosts. 5. Stream blokken, tel bytes en bereken SHA-256. 6. Sluit het tijdelijke object. 7. Valideer media. 8. Promoveer of kopieer naar de definitieve sleutel. 9. Leg URI en metadata vast. Gebruik backpressure zodat de worker niet sneller buffert dan opslag accepteert. Beperk gelijktijdigheid op bandbreedte, bestandsgrootte en opslagcapaciteit, niet alleen taaknummer. ## Valideer bytes, niet alleen headers HTTP `200` kan HTML, JSON of een afgekapt bestand bevatten. `Content-Type: video/mp4` is bewijs maar geen garantie. | Validatie | Gevangen fout | |---|---| | Niet-nul bytes | Leeg antwoord | | Verwachte lengte | Afgekapt transport | | Bestandssignatuur | HTML of JSON als video | | Containeranalyse | Beschadigde structuur | | Duur groter dan nul | Ongeldige of onvolledige video | | Dimensies en codec | Uitvoer buiten contract | | SHA-256 | Gewijzigde of dubbele bytes | | Decodeersample | Bestand analyseert maar speelt niet | Bewaar waargenomen metadata naast het object. Vergelijk duur en resolutie met geschikte toleranties. Weiger geen geldige video om enkele frames verschil tenzij het contract exactheid vereist. ## Gebruik deterministische duurzame sleutels Een voorspelbare sleutel maakt retries idempotent en assets traceerbaar. Neem zakelijke identiteit, variant en versie of checksum op. ```text videos/{account}/{operation_id}/{attempt_id}/{output_id}-{sha256_prefix}.mp4 ``` Schrijf eerst tijdelijk. Promoveer na validatie of leg een databasepointer naar de checksum-sleutel vast. Heeft een andere worker dezelfde checksum voor dezelfde taak opgeslagen, hergebruik die dan. Plaats gebruikersbestandsnamen niet ongezuiverd in paden. Bewaar de originele weergavenaam als metadata. ## Herstel van verlopen en onderbroken overdracht Classificeer fouten: * verbindingsresets en tijdelijke opslagfouten kunnen met backoff opnieuw; * autorisatie of verval kan een nieuwe URL vereisen; * not found kan betekenen dat de provider het asset verwijderde; * herhaalde checksum- of mediafouten moeten automatische retries stoppen; * lokale quota of rechten vereisen operationele actie, geen providercall. Bewaar de provider-taak-ID. Veel API's kunnen een nieuwe ondertekende URL voor een bestaande voltooide taak geven. Controleer dat voor het actuele endpoint. Hervat gedeeltelijk alleen als oorsprong en bestemming geverifieerde byteranges ondersteunen en het object niet is veranderd. Start anders opnieuw in een nieuw tijdelijk object; bytes van versies combineren kan een corrupt bestand opleveren. ## Kies retrytiming die verval respecteert Gewone exponentiële backoff kan voorbij de resterende levensduur wachten. Begrens de vertraging: ```text volgende vertraging = min(exponentiële backoff, tijd tot verval - veiligheidsmarge) ``` Vernieuw de URL vóór retry als verval nabij is. Voeg jitter toe zodat niet alle workers tegelijk verbinden. Stel aparte limieten voor overdracht en URL-vernieuwing. ## Beveilig het opslagpad Het permanente object volgt je toegangsbeleid. Gebruik standaard privébuckets, passende server-side encryptie, beperkt workerrecht en kortlevende leverings-URL's. Kopieer querystrings niet naar metadata; die kunnen handtekeningen bevatten. Redigeer URL's in logs of bewaar alleen host, padhash, uitgifte en verval. Pas malwarecontrole of moderatie toe indien vereist. Handhaaf tenantgrenzen in sleutels en autorisatie, maar vertrouw niet alleen op padnamen. ## Maak retentie- en afgeleide beleidsregels Duurzaam betekent niet eeuwig. | Assetklasse | Beleidsoverweging | |---|---| | Goedgekeurde master | Contract en regeneratiekosten | | Leveringsafgeleide | Kan uit master worden herbouwd | | Afgekeurde generatie | Kort audit- of geschilvenster | | Tijdelijke upload | Automatisch verwijderen na verificatie | | Reviewproxy | Bewaren tot goedkeuring | Registreer verwijderstatus en reden. Voor reproduceerbaarheid bewaar prompt, bronhashes, model, parameters en rechten, maar niet-deterministische generatie maakt mogelijk niet dezelfde bytes. ## Monitor tijd tot duurzaamheid Meet het interval van providerafronding tot geverifieerde opslag. Dat is het risicovenster waarin de tijdelijke link de enige kopie is. Volg wachtende uitvoer, oudste leeftijd, percentielen, verlopen URL-responsen, retries, vernieuwde links, verificatiefouten, bytes en compleet gemarkeerde taken zonder duurzame URI. De laatste metric moet nul zijn. Waarschuw voordat de achterstand de kortste linklevensduur nadert. ## Houd verantwoordelijkheden duidelijk [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=save-ai-videos-before-download-links-expire) kan één OpenAI-compatibel platform bieden voor tekst-, beeld- en videomodellen. Een uniform platform vereenvoudigt metadata en facturering, maar de app blijft verantwoordelijk voor kopiëren naar opslag die aan retentie- en leveringseisen voldoet. Controleer exact uitvoer- en vernieuwingsgedrag van het huidige endpoint. Verzin geen vervalduur en neem niet aan dat ieder model hetzelfde downloadmechanisme gebruikt. Maak verschillen configuratie en capaciteitschecks. ## Conclusie Bewaar AI-video's door tijdelijke URL's als aflopende overdrachtscredentials te behandelen. Zet download direct in de wachtrij, stream naar een tijdelijk object, valideer de media en promoveer naar een deterministische sleutel. Registreer URI en checksum vóór voltooiing en ontwerp vernieuwing, retries, retentie en monitoring zodat verval niet de enige kopie wegneemt. ## FAQ ### Kan ik de download-URL als definitieve videolocatie bewaren? Nee. Ondertekende of tijdelijke URL's kunnen verlopen, worden ingetrokken of veranderen. Bewaar de duurzame objectsleutel en provider-taak-ID en vraag alleen indien nodig een verse URL. ### Moet de downloadworker de hele video in geheugen laden? Gewoonlijk niet. Stream naar een tijdelijk bestand of multipart upload terwijl een checksum wordt berekend, zodat grote bestanden het geheugen niet uitputten. ### Wat moet worden gecontroleerd vóór een video als opgeslagen geldt? Controleer HTTP-respons, inhoudslengte indien beschikbaar, bestandssignatuur, container, niet-nulduur, dimensie- of codecvereisten, checksum en succesvolle duurzame opslag. ### Wat gebeurt er als de tijdelijke URL tijdens download verloopt? Bewaar productietaak en remote-ID, verwijder of isoleer het onvolledige object, vraag een verse URL indien ondersteund en hervat of herstart volgens geverifieerde rangeondersteuning. ### Hoe lang moeten originele gegenereerde video's worden bewaard? Bepaal retentie op basis van klantbehoefte, wet en privacy, regeneratiekosten en opslagbudget. Gebruik lifecyclebeleid in plaats van afhankelijkheid van provider-URL's. ### Kan een webhook de video direct downloaden? De webhook moet snel bevestigen en een downloadtaak in de wachtrij zetten. Een aparte worker kan veilig herhalen, het asset verifiëren en eventverlies door lange overdracht vermijden.