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

# Que deviennent les fichiers d'entrée et les URL de sortie lors de la migration d'une application Sora ?

> Les références de fichiers et les liens vidéo d'un fournisseur ne sont pas des actifs portables. Conservez les octets d'origine sous vos propres ID, rechargez-les au format cible, mappez les deux tâches et copiez chaque vidéo terminée avant l'expiration des ressources.

Lors de la migration d'une application Sora, les références d'entrée doivent généralement être rechargées ou reformattées pour la cible, tandis que les URL vidéo doivent être traitées comme des emplacements temporaires. Placez les deux côtés derrière une couche d'actifs qui gère fichiers durables, sommes de contrôle, accès et correspondances.

Une forme de requête compatible ne rend ni les ID de fichier ni les liens portables. Ces ressources appartiennent au fournisseur qui les a émises.

## Séparer les actifs des références fournisseur

Utilisez un ID d'actif applicatif comme clé stable :

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

L'ID de fichier source, l'ID de tâche vidéo et l'URL signée sont des attributs de cet enregistrement, pas des identifiants permanents du produit.

## Recréer les références d'entrée

L'endpoint vidéo OpenAI reçoit un prompt et peut accepter une image `input_reference`. La cible peut exiger un upload multipart, un ID préchargé, une URL publique ou des données base64.

Lisez chaque original depuis votre stockage, validez son type et ses dimensions, puis créez la référence cible. Ne supposez pas qu'un identifiant OpenAI fonctionne auprès d'un autre fournisseur.

Si seule la référence externe a été conservée, vérifiez qu'elle reste téléchargeable. Si elle a expiré ou a été supprimée, l'utilisateur devra recharger l'original; convertir l'identifiant ne restaure pas les octets.

## Mapper explicitement les objets de tâche

La génération vidéo Sora est asynchrone. La tâche contient ID, état, progression, modèle, durée, taille, dates et éventuellement expiration. Stockez la tâche cible à côté de la source :

| Champ applicatif | Correspondance source | Correspondance cible |
|---|---|---|
| ID de tâche interne | Votre base | Même valeur |
| ID de tâche fournisseur | ID vidéo OpenAI | ID cible |
| État | État source | État cible normalisé |
| Actif d'entrée | Référence source | Nouvelle référence cible |
| Actif de sortie | Octets téléchargés | Octets téléchargés de la cible |

N'écrasez pas la correspondance source pendant la migration progressive. Conserver les deux facilite le retour arrière et le support.

## Télécharger le contenu, pas seulement l'URL

L'API OpenAI expose un endpoint de contenu pour une vidéo terminée et indique `expires_at` lorsque les actifs expirent. Une URL copiée peut cesser de fonctionner, exiger une authentification ou ne pas convenir aux clients.

À la fin, le worker doit :

1. récupérer le contenu depuis l'endpoint authentifié ;
2. le transmettre vers votre stockage d'objets ;
3. vérifier type, taille et somme de contrôle ;
4. enregistrer provenance, modèle, politique de prompt et paramètres ;
5. le servir par une URL applicative autorisée.

Appliquez le même processus aux miniatures, aperçus et autres variantes utiles.

## Planifier la rétention et la confidentialité

Copier des fichiers modifie le périmètre de gouvernance. Définissez une rétention distincte pour uploads, intermédiaires, vidéos finales, miniatures et tâches échouées. Chiffrez les actifs, limitez les rôles et ne journalisez pas les URL signées ni les prompts bruts.

Lors d'une demande de suppression, effacez la copie applicative et appelez le fournisseur quand un endpoint existe. Gardez un marqueur non sensible pour rendre les reprises idempotentes.

## Tester le comportement des médias

Créez des cas pour chaque format, orientation, résolution, durée et taille maximale. Vérifiez canaux alpha et profils colorimétriques si nécessaire. Testez aussi liens expirés, téléchargements partiels, type incorrect, requêtes de plage, annulation et reprise après panne du worker.

Comparez également les règles de contenu et de modération. Deux fournisseurs qui acceptent la forme ne produisent pas forcément le même résultat.

## En résumé

Les références Sora et leurs URL sont des ressources fournisseur, pas des actifs portables. Conservez les originaux, créez de nouvelles références, téléchargez rapidement les vidéos et exposez vos propres ID d'actif afin qu'un lien expiré ne provoque pas une perte de données.

## FAQ

### Peut-on envoyer un input_reference OpenAI à un autre fournisseur vidéo ?

Généralement non. Lisez l'original dans votre stockage et créez l'upload multipart, l'ID de fichier, l'URL ou la référence base64 exigée par la cible.

### Les URL de sortie Sora sont-elles permanentes ?

Traitez-les comme des emplacements temporaires ou authentifiés. La tâche peut indiquer une expiration, donc téléchargez rapidement le contenu vers votre stockage.

### Que faire si seul l'ID de fichier du fournisseur a été conservé ?

Essayez de récupérer les octets tant que la ressource existe. Si elle a expiré ou a été supprimée, l'utilisateur devra peut-être recharger l'original.

### Quel ID l'application doit-elle exposer ?

Exposez vos propres ID stables d'actif et de tâche. Conservez les ID source et cible comme correspondances pour la récupération, le support et le retour arrière.

### Faut-il écraser la correspondance source après le basculement ?

Non. Conservez les deux correspondances pendant la migration progressive afin de comparer le comportement et de revenir en arrière.

### Que faut-il tester pour les actifs vidéo ?

Testez chaque format, taille, durée, orientation et variante pris en charge, ainsi que l'expiration, les téléchargements partiels, l'annulation et les reprises de stockage.
