Befehlsreferenz

Syntax, Argumente und Optionen für Reela-Befehle. Führen Sie reela <command> -h aus, um Hilfe zu Ihrer installierten Version anzuzeigen.

login / logout / whoami / statusAnkerlink kopieren

reela login
reela logout
reela whoami
reela status

• login meldet Sie über eine Browserautorisierung an. Öffnen Sie die angezeigte URL, geben Sie bei Aufforderung den Code ein und warten Sie, bis der Befehl abgeschlossen ist.
• logout meldet Sie vom ausgewählten Profil ab.
• whoami zeigt das angemeldete Konto an.
• status prüft den Konto- und Zustellstatus.

reela --profile work login
reela --profile work whoami

createAnkerlink kopieren

Erstellen Sie ein Video anhand einer Eingabeaufforderung und optionaler Mediendateien.

reela create [PROMPT] --visual <TYPE> [OPTIONS]

Geben Sie eine positionale Eingabeaufforderung oder --prompt-file an. Mindestens ein --visual ist erforderlich.

Visuelle Typen und DateirollenAnkerlink kopieren

• ai-video: Erstellt Aufnahmen; optional reference-image:<path> für den Stil anhängen.
• avatar: Bezieht eine mit --avatar <id> ausgewählte präsentierende Person ein.
• original-clip: Bearbeitet Filmmaterial ohne dessen Ton; video-source:<path> anhängen.
• original-sync: Behält den Ton des Filmmaterials bei; video-audio:<path> anhängen.
• image-video: Animiert ein Bild; original-image:<path> anhängen.

Verwenden Sie background-music:<path> für eigene Musik. Wiederholen Sie die Optionen, anstatt Werte durch Kommas zu verbinden.

BeispieleAnkerlink kopieren

reela create "A product demo" --visual ai-video --layout portrait --dry-run
reela create --prompt-file brief.txt --visual image-video --file original-image:photo.png --dry-run

Prüfen Sie zuerst das geschätzte Guthaben. Starten Sie den Daemon und richten Sie Ihr Zustellabo ein, bevor Sie --dry-run entfernen, um den Auftrag abzusenden. Das Absenden kann Guthaben verbrauchen; Reela erstellt das Video im Hintergrund und liefert das fertige Ergebnis über Ihr Abo. Siehe den Abschnitt zu Daemon / Abonnieren weiter unten.

tasksAnkerlink kopieren

Listen Sie Aufgaben auf und prüfen Sie Details einzelner Aufgaben oder Ausgabeversionen. Für lang andauernde Videogenerierung können Sie Benachrichtigungen über den Abschluss per Daemon-Abo erhalten, um fertige Ergebnisse automatisch zu empfangen.

reela tasks list [--status <STATUS>] [--limit <N>] [--offset <N>] [--sort <ORDER>]
reela tasks get <TASK_ID>
reela tasks versions <TASK_ID> --origin brand [--limit <N>] [--offset <N>]
reela tasks download <TASK_ID> [--video <ID>] [--out-dir <DIR>]

• list: Standardmäßig werden 20 Ergebnisse angezeigt, mit Offset 0, sortiert nach created_at:desc. Statusfilter: cancelled, pending, processing, failed, partial, completed.
• get: Zeigt den Aufgabenstatus, den Fortschritt und, sofern verfügbar, die Erstellungseingabeaufforderung an.
• versions: Listet Brand-Ausgabeversionen auf, einschließlich nicht abgeschlossener Ausgaben. Erfordert --origin brand. Limit: 1–100 (Standard: 20); der Offset ist standardmäßig 0.
• download: Lädt das fertige Video in das konfigurierte Verzeichnis oder nach --out-dir herunter (Kurzform: -o). Verwenden Sie --video, um eine abgeschlossene Brand-Ausgabe auszuwählen.

reela tasks list --status completed --output json

collectionAnkerlink kopieren

Listet Videos in einer bestehenden Sammlung auf, einschließlich Titeln und Beschreibungen.

reela collection list [--session <TITLE>]
reela collection list --session "Product launch" --output json

REELA_COLLECTION_ID hat Vorrang, wenn es festgelegt ist. Andernfalls sucht der Befehl die Sitzung im ausgewählten Profil. Die Standardsitzung ist reela-YYYY-MM-DD und verwendet das lokale Datum, nicht die zuletzt verwendete Sitzung. Dieser Befehl erstellt keine Sammlung; verwenden Sie create, um eine zu starten.

Abgeschlossene Videos können Download-URLs enthalten. Behandeln Sie diese Links als vertraulich und veröffentlichen Sie sie nicht; gehen Sie nicht davon aus, dass für jeden Link eine Authentifizierung erforderlich ist oder dass alle Links dieselbe Ablaufzeit haben.

avatarAnkerlink kopieren

reela avatar list
reela avatar get <ID>

avatar list listet verfügbare Avatare auf; avatar get zeigt die Details eines Avatars an. Verwenden Sie seine ID mit create --avatar.

tiersAnkerlink kopieren

Listet Generierungsoptionen und den Standardtarif für das ausgewählte Profil auf.

reela tiers list
reela tiers list --output json
reela --profile work tiers list

Die einfache Ausgabe zeigt für jeden Tarif das in Anführungszeichen gesetzte Label, die Beschreibung und die Kennzeichnung als Standard an. Die JSON-Ausgabe enthält:

• default_tier: das Label des Standardtarifs, sofern verfügbar.
• tiers: die Liste der Auswahlmöglichkeiten mit label, content (Beschreibung) und is_default für jeden Eintrag.

Verwenden Sie das exakte Label als create --tier, behalten Sie die Groß- und Kleinschreibung bei und setzen Sie Labels mit Leerzeichen in Anführungszeichen. Die Tarifbeschreibungen erläutern die verfügbaren Generierungsoptionen. Der Kontozugriff wird geprüft, wenn Sie eine Anfrage validieren oder absenden.

reela create "A product demo" --visual ai-video \
  --tier "<tier-label>" --dry-run --output json

Ersetzen Sie <tier-label> durch ein von tiers list zurückgegebenes Label. Die Vorschau gibt credits_cost und quota_after zurück, ohne eine Aufgabe zu erstellen. Entfernen Sie --dry-run, um mit denselben Optionen abzusenden.

Ohne --tier verwendet create den für die CLI verfügbaren Standardtarif. Ist kein Standardtarif verfügbar, aktualisieren Sie mit tiers list oder geben Sie --tier an. Wählen Sie beim Auflisten der Tarife und beim Erstellen des Videos dasselbe Profil aus.

brandAnkerlink kopieren

Listet vorhandene Markenpakete auf und wendet sie an.

reela brand list [--limit <N>] [--offset <N>]
reela brand apply <BRAND_ID> --task <TASK_ID> [--inputs '<JSON>']

list zeigt standardmäßig 20 Ergebnisse mit Offset 0 an; das Limit muss zwischen 1 und 100 liegen. apply wendet ein Markenpaket an und wartet bis zu 10 Minuten auf das fertige Video.

Verwenden Sie --inputs, um die von Ihrem Markenpaket benötigten Werte anzugeben. Es akzeptiert ein JSON-Objekt mit Zeichenfolgen-, Zahlen- oder booleschen Werten; Arrays, verschachtelte Objekte und null werden nicht unterstützt. Die Parameternamen werden vom Paket festgelegt. Beispiel:

reela brand apply <BRAND_ID> --task <TASK_ID> \
  --inputs '{"AUTHOR_PROFILE_IMAGE_URL":"https://example.com/avatar.jpg","AUTHOR_NAME":"Alex"}'

Fehlende erforderliche Vorlagenwerte werden vor dem Rendering zurückgewiesen. Geben Sie die fehlenden Werte an, bevor Sie den Vorgang erneut ausführen. Fügen Sie diesen Parametern keine Zugangsdaten oder Geheimnisse hinzu.

Wird der Wartevorgang unterbrochen, kann der Vorgang weiterlaufen. Prüfen Sie die Ausgabeversionen, bevor Sie den Vorgang erneut ausführen:

reela tasks versions <task-id> --origin brand
reela tasks download <task-id> --video <video-id>

editAnkerlink kopieren

Exportieren Sie Bearbeitungs-JSON, um die Bearbeitung in Reela fortzusetzen, oder exportieren Sie ein eigenständiges Remotion-Projekt zur uneingeschränkten lokalen Bearbeitung.

reela edit versions <TASK_ID>
reela edit export-json <TASK_ID> --file <PATH> [--version <N>]
reela edit export-remotion <TASK_ID> [--video <VIDEO_ID>] [--out-dir <DIR>]
reela edit validate <FILE>
reela edit save <FILE>
reela edit render <FILE>

• versions: Listet bearbeitbare Versionen auf, einschließlich Entwürfen und fehlgeschlagener Renderings.
• export-json: Exportiert die neueste oder ausgewählte Bearbeitungsversion als JSON zur Bearbeitung in Reela. Bearbeiten Sie die Datei, validieren Sie sie und verwenden Sie anschließend save oder render.
• export-remotion: Exportiert ein eigenständiges Remotion-Projekt zur uneingeschränkten lokalen Bearbeitung. Ohne --video wird die aktuelle Bearbeitung exportiert; verwenden Sie --video, um eine Videoversion auszuwählen. --out-dir (Kurzform: -o) ist das Projektverzeichnis selbst, nicht dessen übergeordnetes Verzeichnis. Ohne diese Option wird ein Projektordner im konfigurierten Downloadverzeichnis erstellt. Vorhandene Zielpfade bleiben erhalten; stattdessen wird ein numerisches Suffix hinzugefügt. Die JSON-Ausgabe enthält das endgültige Verzeichnis path.
• validate: Prüft das Bearbeitungs-JSON auf Fehler, ohne dessen Inhalt hochzuladen. Anmeldung und Internetverbindung sind erforderlich.
• save: Speichert den Entwurf, ohne ihn zu rendern. Öffnen Sie die zurückgegebene Vorschau-URL, um ihn zu prüfen.
• render: Speichert den Entwurf und wartet, bis das Rendering abgeschlossen ist. Bei Erfolg werden die Aufgaben-ID und die Vorschau-URL erst zurückgegeben, nachdem die gerenderte Ausgabe gespeichert wurde. Der Dienst wartet bis zu zehn Minuten; die CLI räumt für die Antwort zehn Minuten und dreißig Sekunden ein. Bei einem bestätigten Rendering-Fehler wird der Prozess mit Code 10 beendet; bei einer Zeitüberschreitung mit Code 6. Übermittlungen werden nicht automatisch erneut versucht. Eine Unterbrechung oder Zeitüberschreitung bricht das Rendering nicht ab; prüfen Sie reela edit versions <task-id>, bevor Sie erneut rendern.

reela edit export-json <task-id> --file edit.json
reela edit validate edit.json
reela edit save edit.json

Der Remotion-Export wartet auf die Paketierung, lädt das Projekt herunter und entpackt es; die ZIP-Datei wird nicht aufbewahrt. Die Paketierung kann bis zu zehn Minuten dauern. Übermittlungen werden nicht automatisch erneut versucht; eine Unterbrechung oder Zeitüberschreitung während des Wartens bricht die Paketierung im Hintergrund nicht ab. Das exportierte Projekt kann nicht zurück in Reela importiert werden und verwendet die Befehle validate, save oder render nicht.

showAnkerlink kopieren

Lädt einen Show-Arbeitsbereich mit show.yaml, subjects.yaml und episodes/*.md herunter und bearbeitet ihn.

reela show list [--limit <N>] [--offset <N>]
reela show download <SHOW_ID> [--out-dir <DIR>] [--force]
reela show validate
reela show update [--dry-run] [--yes]

list zeigt standardmäßig 20 Ergebnisse mit Offset 0 an. Führen Sie validate und update im Verzeichnis des heruntergeladenen Arbeitsbereichs aus. update --dry-run zeigt eine Vorschau an, ohne lokal oder remote zu schreiben; --yes sendet den Auftrag ohne interaktive Bestätigung ab.

Destruktive Optionen: download --force löscht alle vorhandenen Dateien im Zielverzeichnis, auch nicht zugehörige Dateien. update übermittelt den vollständigen lokalen Arbeitsbereich: Wird eine Episode-Datei entfernt, wird sie remote gelöscht, und lokal bearbeitbare Inhalte überschreiben remote Inhalte ohne Versionsprüfung oder Zusammenführung. Shows, die gerade generiert oder pausiert werden, können nicht aktualisiert werden.

reela show download <show-id> --out-dir ./my-show
cd my-show
reela show validate
reela show update --dry-run
reela show update

show subjectAnkerlink kopieren

reela show subject download (--all | --subject-id <ID>) [--history] [--force]
reela show subject replace-image <SUBJECT_ID> --file <PATH>
reela show subject regenerate <SUBJECT_ID> --prompt-file <PATH> --model <MODEL> [--reference-image-id <ID>] [--yes]

• download: Lädt Bilder für alle Subjects oder ein einzelnes Subject im aktuellen Arbeitsbereich herunter. --history schließt historische Bilder ein; --force überschreibt vorhandene Bilddateien.
• replace-image: Lädt ein statisches JPEG-, PNG- oder WebP-Bild hoch (höchstens 20 MiB und 40 Megapixel) und bewahrt den Bildverlauf sowie vorhandene Videos.
• regenerate: Erstellt ein Bild und wartet bis zu 10 Minuten. Die Eingabeaufforderungsdatei muss UTF-8-kodiert sein. --reference-image-id wählt ein Bild aus dem aktuellen Arbeitsbereich aus; --yes erlaubt die Generierung ohne interaktive Bestätigung.

Show-Downloads enthalten strukturierte Dateien, keine Bilder; laden Sie Subject-Bilder separat herunter. Um ein historisches Bild auszuwählen, bearbeiten Sie current_image_id in subjects.yaml und aktualisieren Sie anschließend.

Eine Unterbrechung der Bildgenerierung beendet nur das Warten, nicht die Generierung im Hintergrund. Bei einer erneuten Ausführung kann ein weiteres Bild erstellt und berechnet werden.

configAnkerlink kopieren

Verwaltet Einstellungen und Kontoprofile.

reela config list
reela config get <KEY>
reela config set <KEY> <VALUE>
reela config profiles list
reela config profiles create <NAME>
reela config profiles show [NAME]
reela config profiles use <NAME>
reela config profiles delete <NAME>

Einstellungen gelten für das ausgewählte Profil. Verwenden Sie config list, um verfügbare Schlüssel und aktuelle Werte zu ermitteln. profiles use ändert das Standardprofil; --profile wählt ein Profil für einen einzelnen Befehl aus.

reela config set delivery.download ~/Videos/reela
reela config profiles create work
reela --profile work login
reela config profiles use work

daemon / subscribeAnkerlink kopieren

Verwaltet die lokale automatische Zustellung unter Linux und macOS. Diese Befehle sind unter Windows nicht verfügbar.

reela daemon start [--foreground] [--keep-backlog]
reela daemon stop
reela daemon status
reela daemon install
reela daemon uninstall
reela daemon logs [--tail <N>]

• start startet die automatische Zustellung. --foreground lässt sie an das Terminal gebunden. Wenn für dieses Profil kein Zustellfortschritt gespeichert ist, stellt --keep-backlog auch frühere abgeschlossene Videos zu, die noch für die automatische Zustellung verfügbar sind. Andernfalls wird die Zustellung ab dem gespeicherten Fortschritt fortgesetzt.
• stop beendet die Zustellung; status zeigt den aktuellen Status an.
• install aktiviert den Start bei der Anmeldung; uninstall deaktiviert den automatischen Start.
• logs zeigt aktuelle Protokolle an; standardmäßig werden mit --tail 20 Zeilen angezeigt.

subscribeAnkerlink kopieren

reela subscribe list
reela subscribe status
reela subscribe add download [--dir <DIR>]
reela subscribe add email [--address <EMAIL>]
reela subscribe add script --path <PATH> [--timeout-seconds <N>] [--max-retries <N>]
reela subscribe remove <METHOD>

Mögliche Methoden sind download, email oder script. Standardmäßig wird die E-Mail-Adresse des Kontos verwendet. Ein Skript muss eine vertrauenswürdige ausführbare Datei sein, die ein JSON-Objekt über stdin einliest und bei Erfolg mit Code 0 beendet wird. --max-retries ist die maximale Gesamtzahl der Zustellversuche; verwenden Sie reela subscribe add -h für die Skriptnutzlast.

Beim Hinzufügen einer Methode wird versucht, einen angehaltenen Daemon zu starten. Starten Sie einen bereits laufenden Daemon nach Änderungen an den Zustelleinstellungen neu, damit diese geladen werden: Bei einem manuell gestarteten Daemon verwenden Sie reela daemon stop gefolgt von reela daemon start; bei einem vom Dienst verwalteten Start starten Sie den Daemon über Ihren Dienstmanager neu.

reela subscribe add download --dir ~/Videos/reela
reela subscribe status

updateAnkerlink kopieren

Aktualisiert die installierte CLI und prüft ihre Version.

reela update
reela --version