Compétence de génération vidéo Sora
Crée ou gère de courts clips vidéo pour le projet en cours (démos produits, spots marketing, plans cinématographiques, maquettes UI). Utilise par défaut sora-2 et un workflow structuré d'augmentation de prompts, et privilégie l'interface en ligne de commande fournie pour des exécutions déterministes. Remarque : $sora est une balise de compétence dans les prompts, pas une commande shell.
Quand l'utiliser
- Générer un nouveau clip vidéo à partir d'un prompt
- Remixer une vidéo existante par son ID
- Interroger le statut, lister les tâches ou télécharger des assets (vidéo/vignette/spritesheet)
- Exécutions par lots (plusieurs prompts ou variantes)
Arbre de décision (création vs remix vs statut/téléchargement vs lot)
- Si l'utilisateur a un identifiant vidéo et souhaite une modification → remix
- Si l'utilisateur a un identifiant vidéo et souhaite le statut ou les assets → statut/interrogation/téléchargement
- Si l'utilisateur a besoin de nombreux prompts/assets → création-par-lot
- Si l'utilisateur demande deux versions avec un petit changement (même plan, sujet/détail différent) → créer la base, puis remixer pour la variante
- Sinon → créer (ou créer-et-interroger s'il a besoin d'un asset prêt en une seule étape)
Workflow
- Déterminer l'intention : création vs remix vs statut/téléchargement vs lot.
- Recueillir les entrées : prompt, modèle, taille, secondes, et éventuellement une image de référence.
- Si par lot : écrire un fichier JSONL temporaire sous
tmp/(une tâche par ligne), exécuter une fois, puis supprimer le JSONL. - Privilégier les drapeaux d'augmentation de l'interface en ligne de commande (
--use-case,--scene,--camera, etc.) plutôt que d'écrire un prompt structuré au préalable. Si vous avez déjà produit un fichier de prompt structuré, passer--no-augmentpour éviter un double encapsulage. - Exécuter l'interface en ligne de commande fournie (
scripts/sora.py) avec les valeurs par défaut sensées (voirreferences/cli.md). Pour les longs prompts, préférer--prompt-filepour éviter les problèmes d'échappement shell ; associer avec--no-augmentsi le prompt est déjà structuré. - Pour les tâches asynchrones, interroger jusqu'à la fin (ou utiliser
créer-et-interroger). - Télécharger les assets (vidéo/vignette/spritesheet) et les sauvegarder localement.
- Supprimer les fichiers intermédiaires créés lors de l'appel (par exemple
prompt.txt,remix_job.json, JSONL temporaire). Si le bac à sable bloquerm, ignorer le nettoyage ou tronquer les fichiers sans signaler d'erreur. - Itérer avec un seul changement ciblé par prompt.
Authentification
OPENAI_API_KEYdoit être définie pour les appels API réels.
Si la clé est manquante, donnez ces étapes à l'utilisateur :
- Créer une clé API dans l'interface OpenAI Platform : https://platform.openai.com/api-keys
- Définir
OPENAI_API_KEYcomme variable d'environnement dans son système. - Proposer de guider l'utilisateur dans la configuration de la variable d'environnement pour son système d'exploitation/shell si nécessaire.
- Ne jamais demander à l'utilisateur de coller la clé complète dans le chat. Demandez-lui de la définir localement et de confirmer quand c'est prêt.
Valeurs par défaut et règles
- Modèle par défaut :
sora-2(utilisersora-2-propour une fidélité plus élevée). - Taille par défaut :
1280x720. - Durée par défaut :
4(valeurs autorisées : "4", "8", "12" sous forme de chaînes). - Toujours définir la taille et la durée via les paramètres de l'API ; le texte seul ne les modifiera pas.
- Utiliser le SDK Python OpenAI (paquet
openai) ; ne pas utiliser HTTP brut. - Exiger
OPENAI_API_KEYavant tout appel API réel. - Si les permissions du cache
uvéchouent, définirUV_CACHE_DIR=/tmp/uv-cache. - Les images de référence en entrée doivent être aux formats jpg/png/webp et correspondre à la taille cible.
- Les URL de téléchargement expirent après environ 1 heure ; copier les assets dans votre propre stockage.
- Privilégier l'interface en ligne de commande fournie et ne jamais modifier
scripts/sora.pysauf si l'utilisateur le demande. - Sora peut générer de l'audio ; si un utilisateur demande une voix off/audio, le spécifier explicitement dans les lignes
Audio:etDialogue:et rester concis.
Limitations de l'API
- Les modèles sont limités à
sora-2etsora-2-pro. - L'accès API aux modèles Sora nécessite un compte vérifié par l'organisation.
- La durée est limitée à 4/8/12 secondes et doit être définie via le paramètre
seconds. - L'API attend
secondssous forme d'énumération de chaînes ("4", "8", "12"). - Les tailles de sortie sont limitées par modèle (voir
references/video-api.mdpour les tailles prises en charge). - La création vidéo est asynchrone ; vous devez interroger jusqu'à la fin avant de télécharger.
- Des limites de taux s'appliquent selon le niveau d'utilisation (ne pas lister de limites spécifiques).
- Des restrictions de contenu sont appliquées par l'API (voir les Garde-fous ci-dessous).
Garde-fous (à appliquer impérativement)
- Contenu adapté uniquement à un public de moins de 18 ans.
- Pas de personnages protégés par le droit d'auteur ni de musique protégée par le droit d'auteur.
- Pas de vraies personnes (y compris les personnalités publiques).
- Les images d'entrée avec des visages humains sont rejetées.
Augmentation de prompt
Reformater les prompts en un cahier des charges structuré et orienté production. Ne rendre explicites que les détails implicites ; n'inventez pas de nouvelles exigences créatives.
Modèle (inclure uniquement les lignes pertinentes) :
Cas d'utilisation : <où le clip sera utilisé>
Demande principale : <prompt principal de l'utilisateur>
Scène/arrière-plan : <lieu, moment de la journée, atmosphère>
Sujet : <sujet principal>
Action : <une seule action claire>
Caméra : <type de plan, angle, mouvement>
Éclairage/ambiance : <éclairage + ambiance>
Palette de couleurs : <3 à 5 couleurs de référence>
Style/format : <indices de film/animation/format>
Rythme/temps : <comptes ou temps>
Audio : <indice ambiant / musique / voix off si demandé>
Texte (textuel) : "<texte exact>"
Dialogue :
<dialogue>
- Intervenant : "Courte ligne."
</dialogue>
Contraintes : <à conserver/à éviter>
À éviter : <contraintes négatives>
Règles d'augmentation :
- Rester concis ; n'ajouter que les détails que l'utilisateur a déjà sous-entendus ou fournis ailleurs.
- Pour les remix, lister explicitement les invariants ("même plan, changer uniquement X").
- Si un détail critique manque et bloque la réussite, poser une question ; sinon, continuer.
- Si vous passez un fichier de prompt structuré à l'interface en ligne de commande, ajouter
--no-augmentpour éviter que l'outil ne le réencapsule.
Exemples
Exemple de génération (plan unique)
Cas d'utilisation : teaser produit
Demande principale : gros plan d'un appareil photo noir mat sur un piédestal
Action : orbite lente de 30 degrés sur 4 secondes
Caméra : 85 mm, faible profondeur de champ, léger flou de mouvement
Éclairage/ambiance : lumière clé douce, léger contre-jour, ambiance studio premium
Contraintes : pas de logos, pas de texte
Exemple de remix (invariants)
Demande principale : même plan et cadrage, passer à une palette teal/sable/rouille avec un rétroéclairage plus chaud
Contraintes : conserver le sujet et le mouvement de la caméra inchangés
Bonnes pratiques de prompting (liste courte)
- Une action principale + un mouvement de caméra par plan.
- Utiliser des comptes ou des temps pour le rythme ("deux pas, pause, tourner").
- Garder le texte court et la caméra verrouillée pour les interfaces utilisateur ou le texte à l'écran.
- Ajouter une brève ligne "à éviter" en cas d'artefacts (scintillement, tremblement, mouvement rapide).
- Les prompts plus courts sont plus créatifs ; les prompts plus longs sont plus contrôlés.
- Mettre le dialogue dans un bloc dédié ; garder les lignes courtes pour des clips de 4 à 8 secondes.
- Énoncer explicitement les invariants pour les remix (même plan, même mouvement de caméra).
- Itérer avec des suivis à changement unique pour préserver la continuité.
Conseils par type d'asset
Utilisez ces modules lorsque la demande concerne un artefact spécifique. Ils fournissent des modèles et des valeurs par défaut ciblés.
- Plans cinématographiques :
references/cinematic-shots.md - Annonces sociales :
references/social-ads.md
Notes sur l'interface en ligne de commande et l'environnement
- Commandes et exemples de l'interface en ligne de commande :
references/cli.md - Référence rapide des paramètres API :
references/video-api.md - Conseils de prompting :
references/prompting.md - Exemples de prompts :
references/sample-prompts.md - Dépannage :
references/troubleshooting.md - Conseils réseau/bac à sable :
references/codex-network.md
Carte de référence
references/cli.md: comment exécuter création/interrogation/remix/téléchargement/lot viascripts/sora.py.references/video-api.md: paramètres de l'API (modèles, tailles, durée, variantes, statut).references/prompting.md: structure du prompt et conseils d'itération.references/sample-prompts.md: recettes de prompts prêtes à l'emploi (exemples uniquement ; pas de théorie supplémentaire).references/cinematic-shots.md: modèles pour des plans filmiques.references/social-ads.md: modèles pour de courtes séquences publicitaires sociales.references/troubleshooting.md: erreurs courantes et correctifs.references/codex-network.md: dépannage réseau/approbation.