Sora Video-Generierungs-Skill
Erstellt oder verwaltet kurze Videoclips für das aktuelle Projekt (Produkt-Demos, Marketing-Spots, filmische Aufnahmen, UI-Mockups). Standardmäßig wird sora-2 und ein strukturierter Prompt-Erweiterungs-Workflow verwendet, bevorzugt wird das gebündelte CLI für deterministische Ausführungen. Hinweis: $sora ist ein Skill-Tag in Prompts, kein Shell-Befehl.
Verwendungszwecke
- Erstellen eines neuen Videoclips aus einem Prompt
- Remixen eines bestehenden Videos anhand seiner ID
- Statusabfrage, Auflisten von Jobs oder Herunterladen von Assets (Video/Thumbnail/Spritesheet)
- Stapelverarbeitung (mehrere Prompts oder Varianten)
Entscheidungsbaum (Erstellen vs. Remixen vs. Status/Download vs. Stapel)
- Wenn der Benutzer eine Video-ID hat und eine Änderung wünscht → remixen
- Wenn der Benutzer eine Video-ID hat und den Status oder Assets möchte → Status/Abrufen/Herunterladen
- Wenn der Benutzer viele Prompts/Assets benötigt → Stapel erstellen
- Wenn der Benutzer nach zwei Versionen mit einer kleinen Änderung fragt (gleiche Einstellung, anderes Motiv/Detail) → Erstellen des Basismaterials, dann Remixen für die Variation
- Andernfalls → Erstellen (oder Erstellen und Abfragen, wenn sie ein fertiges Asset in einem Schritt benötigen)
Arbeitsablauf
- Absicht bestimmen: Erstellen vs. Remixen vs. Status/Download vs. Stapel.
- Eingaben sammeln: Prompt, Modell, Größe, Sekunden und ggf. ein Referenzbild.
- Bei Stapel: eine temporäre JSONL-Datei unter
tmp/schreiben (ein Job pro Zeile), einmal ausführen, dann die JSONL-Datei löschen. - CLI-Erweiterungsflags (
--use-case,--scene,--camerausw.) bevorzugen, anstatt einen strukturierten Prompt vorzuschreiben. Wenn Sie bereits eine strukturierte Prompt-Datei erstellt haben, übergeben Sie--no-augment, um eine doppelte Umhüllung zu vermeiden. - Das gebündelte CLI (
scripts/sora.py) mit sinnvollen Standardwerten ausführen (siehereferences/cli.md). Bei langen Prompts--prompt-filebevorzugen, um Probleme mit Shell-Escaping zu vermeiden; mit--no-augmentkombinieren, wenn der Prompt bereits strukturiert ist. - Bei asynchronen Jobs den Status abfragen, bis sie abgeschlossen sind (oder
create-and-pollverwenden). - Assets (Video/Thumbnail/Spritesheet) herunterladen und lokal speichern.
- Zwischendateien, die während des Aufrufs erstellt wurden (z. B.
prompt.txt,remix_job.json, temporäre JSONL), entfernen. Falls die Sandboxrmblockiert, Bereinigung überspringen oder Dateien ohne Fehlermeldung kürzen. - Mit einer einzelnen gezielten Änderung pro Prompt iterieren.
Authentifizierung
OPENAI_API_KEYmuss für Live-API-Aufrufe gesetzt sein.
Wenn der Schlüssel fehlt, geben Sie dem Benutzer diese Schritte:
- Erstellen Sie einen API-Schlüssel in der OpenAI-Plattform-UI: https://platform.openai.com/api-keys
- Setzen Sie
OPENAI_API_KEYals Umgebungsvariable in seinem System. - Bieten Sie an, ihn bei der Einrichtung der Umgebungsvariable für sein Betriebssystem/Shell zu unterstützen.
- Bitten Sie den Benutzer niemals, den vollständigen Schlüssel im Chat einzufügen. Bitten Sie ihn, ihn lokal zu setzen und zu bestätigen, wenn er bereit ist.
Standardwerte & Regeln
- Standardmodell:
sora-2(verwenden Siesora-2-profür höhere Wiedergabetreue). - Standardgröße:
1280x720. - Standardsekunden:
4(erlaubt: "4", "8", "12" als Zeichenketten). - Größe und Sekunden stets über API-Parameter setzen; Textangaben ändern sie nicht.
- Verwenden Sie das OpenAI Python SDK (
openai-Paket); kein rohes HTTP. OPENAI_API_KEYvor jedem Live-API-Aufruf erforderlich.- Wenn uv-Cache-Berechtigungen fehlschlagen, setzen Sie
UV_CACHE_DIR=/tmp/uv-cache. - Eingangsreferenzbilder müssen jpg/png/webp sein und sollten der Zielgröße entsprechen.
- Download-URLs laufen nach etwa 1 Stunde ab; kopieren Sie Assets in Ihren eigenen Speicher.
- Bevorzugen Sie das gebündelte CLI und ändern Sie niemals
scripts/sora.py, es sei denn, der Benutzer verlangt es. - Sora kann Audio generieren; wenn ein Benutzer Voiceover/Audio wünscht, geben Sie es explizit in den Zeilen
Audio:undDialogue:an und halten Sie es kurz.
API-Einschränkungen
- Modelle sind auf
sora-2undsora-2-probeschränkt. - Der API-Zugriff auf Sora-Modelle erfordert ein organisations-verifiziertes Konto.
- Die Dauer ist auf 4/8/12 Sekunden begrenzt und muss über den Parameter
secondsgesetzt werden. - Die API erwartet
secondsals String-Enumeration ("4", "8", "12"). - Ausgabegrößen sind modellabhängig (siehe
references/video-api.mdfür unterstützte Größen). - Die Videoerstellung ist asynchron; Sie müssen den Abschluss abfragen, bevor Sie herunterladen.
- Rate-Limits gelten nach Nutzungsstufe (keine spezifischen Grenzen auflisten).
- Inhaltseinschränkungen werden von der API durchgesetzt (siehe Schutzmaßnahmen unten).
Schutzmaßnahmen (müssen durchgesetzt werden)
- Nur Inhalte, die für Minderjährige unter 18 Jahren geeignet sind.
- Keine urheberrechtlich geschützten Charaktere oder urheberrechtlich geschützte Musik.
- Keine echten Personen (einschließlich öffentlicher Persönlichkeiten).
- Eingabebilder mit menschlichen Gesichtern werden abgelehnt.
Prompt-Erweiterung
Formatieren Sie Prompts in eine strukturierte, produktionsorientierte Spezifikation um. Machen Sie nur implizite Details explizit; erfinden Sie keine neuen kreativen Anforderungen.
Vorlage (nur relevante Zeilen einfügen):
Use case: <wo der Clip verwendet wird>
Primary request: <Hauptprompt des Benutzers>
Scene/background: <Ort, Tageszeit, Atmosphäre>
Subject: <Hauptmotiv>
Action: <einzelne klare Aktion>
Camera: <Einstellungsart, Winkel, Bewegung>
Lighting/mood: <Beleuchtung + Stimmung>
Color palette: <3-5 Farbanker>
Style/format: <Film/Animation/Format-Hinweise>
Timing/beats: <Zählungen oder Beats>
Audio: <Atmosphäre / Musik / Voiceover, falls angefordert>
Text (verbatim): "<exakter Text>"
Dialogue:
<Dialog>
- Sprecher: "Kurze Zeile."
</Dialog>
Constraints: <muss behalten / muss vermeiden>
Avoid: <negative Einschränkungen>
Erweiterungsregeln:
- Halten Sie es kurz; fügen Sie nur Details hinzu, die der Benutzer bereits impliziert oder an anderer Stelle angegeben hat.
- Listen Sie bei Remixes explizit Invarianten auf ("gleiche Einstellung, nur X ändern").
- Wenn ein kritisches Detail fehlt und den Erfolg blockiert, stellen Sie eine Frage; andernfalls fortfahren.
- Wenn Sie eine strukturierte Prompt-Datei an das CLI übergeben, fügen Sie
--no-augmenthinzu, um ein erneutes Umhüllen durch das Tool zu vermeiden.
Beispiele
Generierungsbeispiel (Einzeleinstellung)
Use case: Produkt-Teaser
Primary request: Nahaufnahme einer mattschwarzen Kamera auf einem Sockel
Action: langsame 30-Grad-Umrundung über 4 Sekunden
Camera: 85mm, geringe Schärfentiefe, sanftes Handheld-Drifts
Lighting/mood: weiches Schlüssellicht, subtiler Rand, erstklassiges Studio-Feeling
Constraints: keine Logos, kein Text
Remix-Beispiel (Invarianten)
Primary request: gleiche Einstellung und Bildausschnitt, Palette auf Teal/Sand/Rost mit wärmerem Gegenlicht umstellen
Constraints: Motiv und Kamerabewegung unverändert lassen
Best Practices für das Prompting (kurze Liste)
- Eine Hauptaktion + eine Kamerabewegung pro Einstellung.
- Verwenden Sie Zählungen oder Beats für das Timing ("zwei Schritte, Pause, Drehung").
- Halten Sie Text kurz und die Kamera für UI- oder Bildschirmtexte fixiert.
- Fügen Sie eine kurze Vermeidungszeile hinzu, wenn Artefakte auftreten (Flackern, Wackeln, schnelle Bewegung).
- Kürzere Prompts sind kreativer; längere Prompts sind kontrollierter.
- Dialog in einen dedizierten Block setzen; Zeilen kurz halten für 4-8s-Clips.
- Invarianten bei Remixes explizit angeben (gleiche Einstellung, gleiche Kamerabewegung).
- Mit Einzeländerungen iterieren, um die Kontinuität zu wahren.
Anleitung nach Asset-Typ
Verwenden Sie diese Module, wenn die Anfrage für ein bestimmtes Artefakt gilt. Sie bieten gezielte Vorlagen und Standardwerte.
- Filmische Aufnahmen:
references/cinematic-shots.md - Social Ads:
references/social-ads.md
CLI + Umgebungsnotizen
- CLI-Befehle + Beispiele:
references/cli.md - API-Parameter-Kurzreferenz:
references/video-api.md - Prompt-Anleitung:
references/prompting.md - Beispiel-Prompts:
references/sample-prompts.md - Fehlerbehebung:
references/troubleshooting.md - Netzwerk/Sandbox-Tipps:
references/codex-network.md
Referenzkarte
references/cli.md: Ausführung von create/poll/remix/download/batch viascripts/sora.py.references/video-api.md: API-Einstellungen (Modelle, Größen, Dauer, Varianten, Status).references/prompting.md: Prompt-Struktur und Iterationsanleitung.references/sample-prompts.md: Kopier-/Einfüge-Prompt-Rezepte (nur Beispiele; keine zusätzliche Theorie).references/cinematic-shots.md: Vorlagen für filmische Aufnahmen.references/social-ads.md: Vorlagen für kurze Social-Ad-Beats.references/troubleshooting.md: Häufige Fehler und Lösungen.references/codex-network.md: Netzwerk-/Genehmigungs-Fehlerbehebung.