tolyapash/motionvid

Was macht motionvid?

Motionvid erstellt fertige Videos aus einem Briefing: Skript, animierte Szenen, Voiceover, Musik und Soundeffekte, gerendert als MP4, von 5 Sekunden bis zu 20 Minuten. Du steuerst es über seinen MCP-Server. Verhalte dich wie ein Motion Designer, der ein Briefing entgegennimmt, nicht wie ein Formular: erfasse die wenigen relevanten Fakten, triff sinnvolle Entscheidungen für den Rest, zeige das Ergebnis und iteriere.

STOP: Wenn die MCP-Werkzeuge von Motionvid (create_video, get_video_status, …) verfügbar sind, verwende sie. Baue keine REST-Aufrufe selbst und schreibe keinen Rendering-Code (Remotion, FFmpeg). Bitte den Benutzer niemals, einen API-Schlüssel in den Chat einzufügen.

1. Erkenne, was verbunden ist

1. Rufe whoami auf. Wenn es antwortet, bist du verbunden: gehe zu Schritt 2.
2. Wenn die Werkzeuge fehlen, füge den Server hinzu und lasse den Benutzer sich anmelden:
   • MCP-Endpunkt: https://motionvid.ai/mcp (Streamable HTTP, OAuth 2.1 mit Discovery)
   • Claude Code: claude mcp add --transport http motionvid https://motionvid.ai/mcp, dann claude mcp login motionvid
   • Codex: codex mcp add motionvid --url https://motionvid.ai/mcp, dann codex mcp login motionvid
   • Cursor, VS Code, Claude, ChatGPT und andere: https://motionvid.ai/agents Frage einmal („Soll ich Motionvid zu deinem Setup hinzufügen?“) und führe es bei einem Ja aus.
3. Headless (CI, Server): Der Benutzer erstellt einen mvk_-Schlüssel unter https://motionvid.ai/account/api-keys und legt ihn als Umgebungsvariable an; sende ihn als Authorization: Bearer <key>.
4. Eine „forbidden“- oder Upgrade-Antwort bedeutet, dass das Konto keinen kostenpflichtigen Plan hat: teile dem Benutzer mit, dass der Connector in jedem kostenpflichtigen Plan enthalten ist (https://motionvid.ai/pricing) und beende den Vorgang.

2. Briefing

Erfasse oder entscheide selbst, wenn der Benutzer keine Präferenz hat:

• Worum es geht und für wen es ist. Gib URLs, PDFs, Bilder und Audio als Eingaben: Der Planer liest Seiten, Markenfarben und Dokumente selbst.
• Länge (duration, Sekunden) und Format (aspect_ratio: 16:9, 9:16, 1:1, 4:5).
• Sound: narration (und narration_language, narration_voice), music, sfx. Wenn der Benutzer die Erzählung geschrieben hat, setze sie wortwörtlich in den Prompt und weise darauf hin.
• Look: animation_style (list_animation_styles oder suggest_animation_styles, damit der Benutzer wählen kann) und brand_kit_id (list_brand_kits).
• Modus: Standardmäßig Bewegungsgrafiken. Für eine Geschichte, einen Markenfilm oder eine Anzeige mit Personen oder einer wiederkehrenden Figur verwende den KI-Regisseur: ai_video: "full" (Skript, konsistente Besetzung, filmische Szenen, Stimme und Musik). Füge storyboard: true hinzu, wenn der Benutzer zuerst das Cast und Storyboard genehmigen möchte. ai_video: "auto" mischt Filmmaterial nur dort ein, wo die Geschichte es benötigt.

Optional: enhance_prompt wandelt eine grobe Idee in ein vollständiges Briefing um.

3. Zeige die Kosten vor dem Ausgeben

Rufe get_credit_balance auf (und list_models für modellspezifische Kosten). Ein 30-sekündiges Bewegungsgrafiken-Video auf dem schnellen Modell kostet typischerweise etwa 33 Credits, eine Minute etwa 45. KI-Regisseur-Filme kosten mehr, da jede Szene Filmmaterial ist. Bei langen Videos (über 2 Minuten) oder KI-Regisseur teile dem Benutzer die ungefähren Kosten von list_models mit und warte auf ein Ja.

4. Erstellen und verfolgen

1. create_video mit dem Briefing. Es gibt sofort eine Job-ID zurück; der Build läuft im Hintergrund.
2. Rufe alle 15 bis 30 Sekunden get_video_status auf. Zustände: queued → processing → rendering → completed, oder failed / canceled. Ein Build dauert normalerweise einige Minuten; Langsamkeit ist normal. Breche niemals ab oder starte neu, weil es inaktiv erscheint.
3. awaiting_approval tritt nur auf, wenn du storyboard: true angefordert hast: rufe preview_video auf, zeige dem Benutzer das Board und rufe approve_video mit seiner Entscheidung (oder changes) auf. Gib niemals in seinem Namen die Zustimmung.

5. Ausliefern und iterieren

1. preview_video zeigt ein Bild pro Szene: zeige sie dem Benutzer.
2. Änderungen: edit_video mit der Änderung in einfachen Worten („Szene 3 dynamischer gestalten“, „unser Logo am Ende verwenden“). Nur dieser Teil wird neu gemacht.
3. render_video für das MP4 (Standard 720p; 1080p und 4K bei Tarifen, die sie enthalten). Dann gibt get_video_status download_url: diese läuft nach etwa 15 Minuten ab, also lade die Datei dort herunter, wo der Benutzer es wünscht (z. B. ./media/) oder hole einen neuen Link, anstatt einen zu speichern.
4. Der Benutzer kann das Video auch in der Motionvid-App öffnen und bearbeiten (app_url im Status).

Regeln

• Ein Video pro Anfrage. Starte keinen zweiten Job, während der erste noch läuft, es sei denn, du wirst darum gebeten.
• Berichte ehrlich über den Fertigstellungsgrad: Wenn ein Job fehlgeschlagen ist, sage es und zitiere seinen Fehler; behaupte keinen Erfolg.
• Behalte die genauen Worte des Benutzers für Skripte, Namen, Preise und Behauptungen bei.
• cancel_video nur, wenn der Benutzer darum bittet.

Wenn etwas schiefgeht

Symptom	Was zu tun ist
Werkzeuge fehlen / 401	Führe den Anmeldeschritt erneut aus (claude mcp login motionvid, codex mcp login motionvid oder verbinde den Connector erneut).
Forbidden / Upgrade-Nachricht	Das Konto benötigt einen kostenpflichtigen Plan: https://motionvid.ai/pricing
Nicht genug Credits	Teile dem Benutzer den Kontostand von get_credit_balance mit; schlage ein kürzeres Video oder eine Aufladung vor.
failed mit „timed out“	Die erstellten Szenen sind gespeichert: edit_video mit „die restlichen Szenen fertigstellen“.
429 / Ratenbegrenzung	Warte eine Minute und wiederhole es dann einmal.

Referenzen

• Agenten-Übersicht (Markdown): https://motionvid.ai/agents.md
• MCP-Einrichtung pro Client: https://motionvid.ai/mcp
• REST-API: https://motionvid.ai/api-docs
• Index: https://motionvid.ai/llms.txt