Ozor Dokument-zu-Video
End-to-End-Dokument-zu-Video auf Ozor.ai. Nimmt eine echte Datei (PDF, PPTX, DOCX, etc.), analysiert sie auf Ozors Seite, um einen strukturierten Plan zu erstellen, lässt den Benutzer den Plan genehmigen/bearbeiten und generiert und exportiert dann ein fertiges Video – wobei die visuellen Elemente der Folien erhalten bleiben.
Wann verwenden
Verwende diesen Skill, wenn die Eingabe ein Dokument/eine Datei ist. Anzeichen:
- Der Benutzer hat eine PDF, PPTX, DOCX, Keynote-Export, Pitchdeck, Angebot, Whitepaper, Bericht oder ein Einseiter angehängt oder referenziert
- "Mach ein Video aus diesem Deck"
- "Erstelle ein Video aus dieser PDF"
- "Video aus meinem Pitch / Angebot / Bericht"
Verwende diesen Skill NICHT, wenn:
- Die Eingabe eine kurze kreative Textvorgabe ist →
ozor-generate - Die Eingabe eine URL oder Landing Page ist →
ozor-url-to-video - Der Benutzer nur einen geschriebenen Ozor-Prompt möchte →
ozor-doc-to-video(nur Prompt-Skill) - Der Benutzer bestehende Videos verwalten möchte →
ozor-video-library
Erforderliche MCP-Tools
mcp__ozor__analyze_document— analysiert das Dokument, gibt eineplanIdplus den strukturierten Plan zurückmcp__ozor__prepare_document_upload— erhält eine per Curl hochladbare URL für lokale Dateien ohne öffentliche URL (der häufigste Weg)mcp__ozor__get_plan— ruft den aktuellen Plan-Status abmcp__ozor__update_plan— wendet Benutzerbearbeitungen am Plan vor der Generierung anmcp__ozor__generate_from_plan— startet den Videobau aus dem genehmigten Plan, gibtprojectIdzurückmcp__ozor__export_video— startet das Rendern (verwende dieprojectIdalsvideoId)mcp__ozor__wait_for_export— blockiert, bis der Render bereit istmcp__ozor__get_embed_code— gibt das<iframe>HTML zurück
Wenn das Ozor MCP nicht verbunden ist, informiere den Benutzer und stoppe. Extrahiere den Inhalt nicht selbst und greife nicht auf generate_video mit einem selbstgeschriebenen Skript zurück – das verliert die Folienvisualisierungen und überschreitet das 2000-Zeichen Prompt-Limit. Der planbasierte Ablauf ist für Dokumente zwingend erforderlich.
Workflow
Schritt 1 — Das Dokument zu Ozor bringen
Wähle die beste Quelle, in Prioritätsreihenfolge:
- Öffentliche URL → übergib
urldirekt ananalyze_document. Kein Größenlimit, keine Token-Kosten. Am besten, wann immer verfügbar. - Lokale Datei (der häufige Fall) → rufe
mcp__ozor__prepare_document_uploadauf, führe dann den zurückgegebenen Curl-Befehl aus, um die Bytes direkt in Ozors Speicher zu übertragen. Bytes durchlaufen nie einen Tool-Aufruf, daher funktionieren Dateien bis zu ~50 MB. Verwende dies für alle Multi-MB PDF/PPTX/DOCX, die der Benutzer in das Gespräch hochgeladen hat. fileBase64+fileNamebeianalyze_document→ nur für kleine Dateien (≲ ein paar hundert KB). Vermeide für große Decks – es verbraucht Tokens.
Wenn prepare_document_upload nicht in der Tool-Liste ist, sind Uploads auf diesem Server deaktiviert – falle auf eine URL oder kleines Base64 zurück.
Schritt 2 — Das Dokument analysieren
Sobald Ozor die Datei hat, rufe auf:
mcp__ozor__analyze_document({
url | uploadId | fileBase64+fileName,
...optionale Hinweise: targetDuration, format (16:9 / 9:16), audience, tone
})
Dies gibt { planId, plan } zurück. Der Plan enthält die vorgeschlagenen Szenen, Erzählung, visuelle Notizen und welche Folien/Seiten welchen Szenen zugeordnet sind.
Schritt 3 — Den Plan dem Benutzer präsentieren und STOPPEN
Dies ist der kritische Schritt. Überspringe die Generierung nicht. Zeige dem Benutzer eine prägnante Darstellung des Plans:
📋 Ozor-Plan für "<Dokumentname>"
**Format:** 16:9 (oder 9:16)
**Geschätzte Dauer:** ~X Sekunden
**Szenen:** N
(1) <Szenentitel> — <einzellige Erzählung / Visual>
(2) <Szenentitel> — <einzellige Erzählung / Visual>
...
Soll ich das so generieren, oder möchtest du etwas ändern? Du kannst:
- Eine Szene bearbeiten ("Szene 2 ändern zu ...")
- Szenen neu anordnen / löschen / hinzufügen
- Ton, Länge oder Format ändern
- Genehmigen und generieren
Dann warte auf die Genehmigung des Benutzers oder auf Bearbeitungswünsche. Rufe generate_from_plan nicht aus eigener Initiative auf – der Plan ist der Kontrollpunkt des Benutzers für Kosten und kreative Kontrolle.
Schritt 4 — Bearbeitungen anwenden (falls vorhanden)
Wenn der Benutzer Änderungen wünscht, rufe mcp__ozor__update_plan({ planId, ... }) mit den Bearbeitungen auf. Hole den Plan mit get_plan erneut ab und zeige den aktualisierten Plan erneut an. Wiederhole den Vorgang, bis der Benutzer zustimmt.
Schritt 5 — Aus dem Plan generieren
Wenn der Benutzer zustimmt:
mcp__ozor__generate_from_plan({ planId })
Dies gibt { projectId } zurück. Verwende projectId als videoId für jeden nachfolgenden Aufruf.
Wenn die Antwort eine jobId enthält, warte mit wait_for_job({ videoId: projectId, jobId }) darauf. Andernfalls fahre mit dem Export fort.
Schritt 6 — Exportieren
mcp__ozor__export_video({ videoId: projectId })
mcp__ozor__wait_for_export({ videoId: projectId })
Gibt shareUrl, editorUrl, downloadUrl zurück.
Schritt 7 — Einbetten
mcp__ozor__get_embed_code({ videoId: projectId })
Schritt 8 — Ergebnisse präsentieren
🎬 Video fertig aus "<Dokumentname>"
**Teilen:** <shareUrl>
**Editor:** <editorUrl>
**Herunterladen:** <downloadUrl>
**Einbettung:**
```html
<iframe ...></iframe>
Möchtest du einen 9:16 Social Cut aus demselben Plan? Ich kann neu generieren.
## Hinweise, die an `analyze_document` übergeben werden können
Übergib diese, wenn der Benutzer sie erwähnt hat oder sie aus dem Dokument offensichtlich sind:
- `targetDuration` — z.B. `"60s"`, `"90s"`. Standard ~60s für Angebote/Decks, ~30s für Einseiter.
- `format` — `"16:9"` (Standard) oder `"9:16"` für soziale Medien.
- `audience` — Investoren, Kunden, Entwickler, internes Team, ...
- `tone` — selbstbewusst, warm, technisch, energiegeladen, ...
- `focus` — optional, eine einzeilige Notiz wie "Konzentriere dich auf die Metriken auf Folie 4" oder "Überspringe die Teamfolie".
## Anpassung nach Dokumenttyp
| Dokument | Standarddauer | Format | Ton | Fokus |
|----------|---------------|--------|-----|-------|
| Pitchdeck | 60–90s | 16:9 | Selbstbewusst | Problem → Lösung → Traktion → CTA |
| Angebot (DOCX) | 60s | 16:9 | Professionell | Ergebnisse + Preis + nächster Schritt |
| Whitepaper / Bericht | 60–90s | 16:9 | Autoritär | 3 wichtigste Erkenntnisse, Link zum vollständigen Dokument im CTA |
| Vertriebs-Einseiter | 30–45s | 16:9 | Knackig | Haken → 3 Vorteile → CTA |
| Versionshinweise | 30–45s | 16:9 | Energiegeladen | Eine Szene pro Funktion |
| Schulung / SOP | 90s+ | 16:9 | Ruhig, klar | Nummerierte Schritte, in eine Reihe aufteilen, wenn > 7 Szenen |
Im Zweifelsfall schlage einen Standard in deinem ersten Aufruf vor und lass den Benutzer nach dem Ansehen des Plans überschreiben.
## Iterieren nach der Generierung
Wenn das gerenderte Video Änderungen benötigt:
- Kleine Anpassungen an Erzählung/Kopie → `update_plan` + neu generieren (dies wird vom Plan aus neu ausgeführt, kein erneutes Analysieren des Dokuments erforderlich)
- Neue Szenenreihenfolge oder Ton → derselbe Weg
- Neuer Fokus oder neue Zielgruppe → es kann günstiger sein, `analyze_document` mit stärkeren Hinweisen erneut aufzurufen
## Fehler und Wiederherstellung
- **`analyze_document` schlägt fehl, weil die Datei zu groß ist** → verwende `prepare_document_upload` anstelle von Base64.
- **Der Plan hat fehlende oder falsche Inhalte** → rufe `update_plan` mit Korrekturen auf, anstatt neu zu starten.
- **`generate_from_plan` schlägt fehl** → der Fehler weist normalerweise auf eine bestimmte Szene hin. Behebe den Fehler über `update_plan`, wiederhole den Vorgang.
- **Export hängt** → es ist sicher, `wait_for_export` erneut aufzurufen; er wird fortgesetzt.
## Regeln
1. **Gehe immer zuerst den Planweg.** Rufe niemals `generate_video` mit handgeschriebener Prosa auf, die aus dem Dokument extrahiert wurde. Der ganze Sinn dieses Skills ist, dass Ozor die Folien direkt sieht.
2. **Zeige dem Benutzer immer den Plan und warte auf Genehmigung**, bevor du `generate_from_plan` aufrufst. Die Generierung ist der teure Schritt; der Plan ist der Kontrollpunkt.
3. **Für lokale Dateien verwende `prepare_document_upload` + Curl.** Base64 ist nur für winzige Dateien.
4. **Verwende überall nach `generate_from_plan` `projectId` als `videoId`.** Es ist dieselbe Kennung.
5. **Gib jede URL an** — Teilen, Editor, Herunterladen, Einbettung.
6. **Fasse das Dokument nicht selbst zusammen** — Ozors `analyze_document` macht das und bewahrt die Visualisierungen. Deine Aufgabe ist es, das MCP zu orchestrieren und den Plan zu kuratieren, nicht den Inhalt neu zu schreiben.