<!-- Canonical URL: https://ask.atlascloud.ai/nl/migrate-sora-app-input-files-output-urls -->

# Wat gebeurt er met invoerbestanden en uitvoer-URL's bij de migratie van een Sora-app?

> Bestandsreferenties en videolinks van een provider zijn geen overdraagbare assets. Bewaar de oorspronkelijke bytes onder eigen asset-ID's, upload ze in het doelformaat, map bron- en doeltaak afzonderlijk en kopieer voltooide video's voordat resources verlopen.

Bij een Sora-migratie moeten invoerreferenties meestal opnieuw worden geüpload of geformatteerd voor het doel, terwijl video-URL's tijdelijke downloadlocaties zijn. Plaats beide achter een assetlaag die duurzame bestanden, checksums, toegang en mappings beheert.

Een compatibele aanvraagvorm maakt bestands-ID's en links niet overdraagbaar. Ze behoren tot de provider die ze uitgeeft.

## Scheid assets van providerreferenties

Gebruik een applicatie-asset-ID als stabiele sleutel:

```json
{
  "asset_id": "asset_01J...",
  "kind": "input_image",
  "sha256": "...",
  "storage_key": "inputs/asset_01J...png",
  "provider_refs": {
    "openai": "provider-specific-reference"
  }
}
```

Bronbestand-ID, videotaak-ID en ondertekende URL zijn attributen van deze record, geen permanente product-ID's.

## Maak invoerreferenties opnieuw

Het OpenAI-video-endpoint accepteert een prompt en optionele `input_reference`-afbeelding. Het doel kan multipart, een vooraf geüploade ID, openbare URL of base64 vereisen.

Lees elk origineel uit eigen opslag, valideer type en afmetingen en maak de doelreferentie. Veronderstel niet dat een OpenAI-ID bij een andere provider werkt.

Als alleen de externe referentie is opgeslagen, controleer dan of downloaden nog kan. Na verloop of verwijdering moet de gebruiker mogelijk opnieuw uploaden; ID-conversie herstelt geen bytes.

## Map taakobjecten expliciet

Sora-videogeneratie is asynchroon. Een taak bevat ID, status, voortgang, model, duur, grootte, tijden en mogelijk verloop. Bewaar de doeltaak naast de bron:

| Applicatieveld | Bronmapping | Doelmapping |
|---|---|---|
| Interne taak-ID | Eigen database | Dezelfde waarde |
| Provider-taak-ID | OpenAI-video-ID | Doeltaak-ID |
| Status | Bronstatus | Genormaliseerde doelstatus |
| Invoer-asset | Bronreferentie | Nieuwe doelreferentie |
| Uitvoer-asset | Gedownloade bytes | Bytes van het doel |

Overschrijf de bronmapping niet tijdens gefaseerde migratie. Beide mappings maken rollback en support mogelijk.

## Download inhoud, niet alleen de URL

OpenAI biedt een content-endpoint voor voltooide video's en meldt `expires_at` wanneer assets verlopen. Een gekopieerde URL kan stoppen, authenticatie vereisen of ongeschikt zijn voor clients.

Na voltooiing moet de worker:

1. inhoud ophalen bij het geauthenticeerde endpoint;
2. deze naar eigen objectopslag streamen;
3. type, grootte en checksum controleren;
4. herkomst, model, promptbeleid en parameters vastleggen;
5. deze via een geautoriseerde applicatie-URL leveren.

Pas hetzelfde toe op thumbnails, previews en andere benodigde varianten.

## Plan bewaring en privacy

Bestanden kopiëren verandert governance. Definieer aparte bewaring voor uploads, tussenproducten, video's, thumbnails en fouten. Versleutel assets, beperk rollen en log geen ondertekende URL's of ruwe prompts.

Verwijder bij een verzoek de applicatiekopie en roep indien mogelijk de provider aan. Bewaar een niet-gevoelige verwijdermarkering voor idempotente pogingen.

## Test mediagedrag vóór omschakeling

Maak cases voor formaat, oriëntatie, resolutie, duur en maximale grootte. Controleer zo nodig alfa en kleurprofiel. Test verlopen links, gedeeltelijke downloads, verkeerd type, range-requests, annulering en herstel na worker-falen.

Vergelijk ook inhouds- en moderatieregels. Dezelfde vorm accepteren garandeert niet hetzelfde resultaat.

## Samenvatting

Sora-referenties en uitvoer-URL's zijn providerresources, geen overdraagbare assets. Bewaar originelen, maak nieuwe referenties, download video's snel en toon eigen asset-ID's, zodat een verlopen link geen gegevensverlies wordt.

## FAQ

### Kan een OpenAI input_reference naar een andere videoprovider worden gestuurd?

Meestal niet. Lees het origineel uit je opslag en maak de multipart-upload, bestands-ID, URL of base64-referentie die het doel vereist.

### Zijn Sora-uitvoer-URL's permanent?

Behandel ze als tijdelijke of geauthenticeerde afleverlocaties. De taak kan een verloopdatum melden, dus download de inhoud snel naar eigen opslag.

### Wat als alleen een bestands-ID van de provider is opgeslagen?

Probeer de bytes op te halen zolang de resource bestaat. Na verlopen of verwijderen moet de gebruiker het origineel mogelijk opnieuw uploaden.

### Welke ID moet de applicatie tonen?

Toon je eigen stabiele asset- en taak-ID's. Bewaar bron- en doel-ID's als koppelingen voor ophalen, support en rollback.

### Moet de bronkoppeling na omschakeling worden overschreven?

Nee. Bewaar beide koppelingen tijdens de gefaseerde migratie om gedrag te vergelijken en veilig terug te draaien.

### Wat moet voor video-assets worden getest?

Test ondersteunde formaten, groottes, lengtes, oriëntaties en varianten, plus verlopen, gedeeltelijke downloads, annulering en opslagpogingen.
