Communitygithub.com

Génération de vidéos 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 le modèle `sora-2` et un workflow structuré d'augmentation de prompts. 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.

Qu'est-ce que Génération de vidéos Sora ?

Cette compétence permet de générer et de gérer des clips vidéo courts à l'aide de l'API Sora d'OpenAI, directement depuis votre terminal ou agent IA. Elle est conçue pour les développeurs et les créateurs de contenu qui ont besoin de produire rapidement des démos produits, des spots marketing, des plans cinématographiques ou des maquettes UI. Le workflow est structuré autour de plusieurs modes : création à partir d'un prompt, remix d'une vidéo existante par son ID, suivi de l'état des tâches, téléchargement des assets (vidéo, vignette, spritesheet), et exécution par lots. La compétence impose des garde-fous stricts (contenu approprié pour les mineurs, pas de personnages ou musiques protégés par le droit d'auteur, pas de vraies personnes), et fournit un modèle d'augmentation de prompt pour structurer les demandes. Elle nécessite une variable d'environnement `OPENAI_API_KEY` et utilise le SDK Python OpenAI. Pour les environnements sans accès réseau direct, des astuces de dépannage sont également incluses.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/openai/skills/sora

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Déterminer l'intention : création vs remix vs statut/téléchargement vs lot.
  2. Recueillir les entrées : prompt, modèle, taille, secondes, et éventuellement une image de référence.
  3. Si par lot : écrire un fichier JSONL temporaire sous tmp/ (une tâche par ligne), exécuter une fois, puis supprimer le JSONL.
  4. 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-augment pour éviter un double encapsulage.
  5. Exécuter l'interface en ligne de commande fournie (scripts/sora.py) avec les valeurs par défaut sensées (voir references/cli.md). Pour les longs prompts, préférer --prompt-file pour éviter les problèmes d'échappement shell ; associer avec --no-augment si le prompt est déjà structuré.
  6. Pour les tâches asynchrones, interroger jusqu'à la fin (ou utiliser créer-et-interroger).
  7. Télécharger les assets (vidéo/vignette/spritesheet) et les sauvegarder localement.
  8. Supprimer les fichiers intermédiaires créés lors de l'appel (par exemple prompt.txt, remix_job.json, JSONL temporaire). Si le bac à sable bloque rm, ignorer le nettoyage ou tronquer les fichiers sans signaler d'erreur.
  9. Itérer avec un seul changement ciblé par prompt.

Authentification

  • OPENAI_API_KEY doit être définie pour les appels API réels.

Si la clé est manquante, donnez ces étapes à l'utilisateur :

  1. Créer une clé API dans l'interface OpenAI Platform : https://platform.openai.com/api-keys
  2. Définir OPENAI_API_KEY comme variable d'environnement dans son système.
  3. 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 (utiliser sora-2-pro pour 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_KEY avant tout appel API réel.
  • Si les permissions du cache uv échouent, définir UV_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.py sauf 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: et Dialogue: et rester concis.

Limitations de l'API

  • Les modèles sont limités à sora-2 et sora-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 seconds sous forme d'énumération de chaînes ("4", "8", "12").
  • Les tailles de sortie sont limitées par modèle (voir references/video-api.md pour 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-augment pour é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 via scripts/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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés