Automatisierung

Erstellen Sie Videos und integrieren Sie fertige Ergebnisse über Abschlussabonnements von Reela CLI in Ihren Workflow.

Reela stellt Befehle für die Videoproduktion und Abschlussabonnements für fertige Videos bereit. Ein Agent oder ein anderes Tool kann ein Briefing übermitteln und die Ausgabe über den CLI-Daemon empfangen, ohne die Reela-Website geöffnet zu lassen.

Vom Briefing zum VideoAnkerlink kopieren

create wandelt ein Text-Briefing und optionale Medien in eine Videoaufgabe um. Sie können einen Prompt direkt eingeben oder aus einer Datei lesen, Dauer und Layout auswählen, Avatare einbeziehen und Referenzbilder, Videomaterial oder Hintergrundmusik anhängen.

reela create --prompt-file brief.txt \
  --visual ai-video --layout portrait --duration 30 \
  --session "Product campaign" --output json

Die Videogenerierung ist eine lang laufende Aufgabe. Starten Sie den Daemon und konfigurieren Sie vor dem Absenden ein Abschlussabonnement. Reela führt die Generierung im Hintergrund aus und übermittelt das fertige Ergebnis an Ihr Skript. Wenn Sie einen Sitzungstitel wiederverwenden, werden zusammengehörige Videos zu einem Projekt gruppiert. Eine Anleitung zur Einrichtung finden Sie weiter unten unter Automatische Zustellung.

Fügen Sie vor dem Absenden --dry-run hinzu, um die Anfrage zu validieren und eine Vorschau der geschätzten Guthaben anzuzeigen, ohne Dateien hochzuladen oder eine Aufgabe zu erstellen. Beim Absenden einer Aufgabe können Guthaben verbraucht werden.

Unter Optionen zur Videoerstellung finden Sie Informationen zu unterstützten visuellen Elementen und Medieneingaben.

Qualität und Kosten mit Stufen auswählenAnkerlink kopieren

Mit Stufen können Sie für jede Anfrage die Generierungsoption auswählen. Reela stellt Beschreibungen bereit, die Ihnen oder einem Agenten dabei helfen, eine Option für das gewünschte Ergebnis auszuwählen, und schätzt dann vor dem Absenden die Guthaben für diese Anfrage.

reela tiers list
reela tiers list --output json

Die Liste zeigt die Bezeichnung und Beschreibung jeder Stufe und kennzeichnet die Standardeinstellung. Die JSON-Ausgabe enthält in tiers Einträge mit label, content und is_default; default_tier benennt die Standardeinstellung. Lesen Sie content, um die einzelnen Optionen zu verstehen, statt anhand ihrer Position in der Liste auszuwählen. Die Auflistung der Stufen garantiert nicht, dass Ihr Konto jede Option nutzen kann; Reela prüft den Zugriff bei der Validierung oder beim Absenden einer Anfrage.

Übergeben Sie die genaue Bezeichnung an --tier. Ersetzen Sie <tier-label> unten durch eine Bezeichnung aus Ihrer Liste. Wenn sie Leerzeichen enthält, lassen Sie die Anführungszeichen stehen:

reela create --prompt-file brief.txt --visual ai-video \
  --tier "<tier-label>" --duration 30 --layout portrait \
  --dry-run --output json

Die Vorschau gibt credits_cost und quota_after zurück. Entfernen Sie zum Absenden --dry-run und behalten Sie die ausgewählte Stufe und die übrigen Optionen bei. Eine Stufe beschreibt eine Generierungsoption; verwenden Sie die Vorschau, um die Kosten Ihrer konkreten Anfrage zu schätzen.

Wenn Sie --tier weglassen, verwendet Reela die aktuell für die CLI verfügbare Standardeinstellung. Ist keine Standardeinstellung verfügbar, führen Sie reela tiers list aus, um die Optionen zu aktualisieren, oder geben Sie ausdrücklich eine Stufe an. Wenn Sie eine Stufe ausdrücklich auswählen, bleibt die Auswahl Ihres Workflows von Änderungen an der Standardeinstellung unabhängig; Verfügbarkeit und Preise können sich dennoch ändern. Verwenden Sie für das Auflisten, die Vorschau und das Absenden dasselbe Profil.

Weitere Informationen zu Ausgabe und Auswahlverhalten finden Sie in der Referenz zum Stufenbefehl.

Strukturierte Ergebnisse für Agenten und ToolsAnkerlink kopieren

--output json stellt Befehlsergebnisse – darunter Stufenauswahlen, Guthabenschätzungen und Bestätigungen zum Absenden – als strukturierte Daten bereit. Der Exit-Code 0 bedeutet, dass der Befehl erfolgreich war. Bei Fehlern werden Exit-Codes ungleich null und Klartext auf stderr verwendet, auch im JSON-Modus.

Nach erfolgreichem Absenden übernimmt der Daemon das Warten auf den Abschluss und ruft Ihr abonniertes Skript mit dem Ergebnis auf. Die Antwort auf das Absenden und das Abschlussereignis enthalten eine task_id, damit Ihr Workflow das fertige Video dem ursprünglichen Briefing zuordnen kann.

Automatische ZustellungAnkerlink kopieren

Reela CLI kann eine ausführbare Datei Ihrer Wahl aufrufen, sobald eine Videoaufgabe abgeschlossen ist. Dieses Abschlussabonnement verbindet die Ausgabe von Reela mit Ihrem nächsten Schritt: ein Video an ein Veröffentlichungstool übergeben, einen Datensatz aktualisieren oder ein anderes System benachrichtigen. Reela überwacht den Abschluss und übergibt Ihrem Skript die Aufgabendetails.

Skript registrierenAnkerlink kopieren

Geben Sie einen absoluten Pfad zu einer ausführbaren Datei auf dem Rechner an, auf dem Reela CLI ausgeführt wird. Sie kann in einer beliebigen Sprache geschrieben sein, sofern sie das Ereignis von stdin liest und den Erfolg über ihren Exit-Code meldet.

reela subscribe add script --path /absolute/path/on-video \
  --timeout-seconds 300 --max-retries 3

Für jedes Profil gibt es ein Skriptabonnement. Verwenden Sie reela config set delivery.script.path /absolute/path/on-video, um die ausführbare Datei eines vorhandenen Abonnements zu ändern. Starten Sie einen bereits laufenden Daemon nach Änderungen am Abonnement oder an dessen Einstellungen neu, wie unten beschrieben.

Abschlussereignis empfangenAnkerlink kopieren

Reela startet die ausführbare Datei und schreibt ein JSON-Objekt nach stdin:

{
  "event": "task.completed",
  "task_id": "12345",
  "status": "completed",
  "status_label": "completed",
  "title": "Product demo",
  "description": "A short product introduction",
  "download": {
    "filename": "product-demo.mp4",
    "download_url": "https://example.com/video.mp4"
  }
}

Verwenden Sie task_id, um das Ereignis Ihrer ursprünglichen Übermittlung zuzuordnen. title, description und download können null sein. Wenn vorhanden, stellt download den vorgeschlagenen Dateinamen und die Download-URL des fertigen Videos bereit, damit Ihr Skript sie direkt verwenden kann. Behandeln Sie einen fehlenden Wert für download, bevor Sie eine Aktion ausführen, die das Video benötigt.

Signierte download_url-Links laufen 6 Stunden nach ihrer Erstellung ab. Laden Sie das Video herunter oder kopieren Sie es kurz nach Empfang des Abschlussereignisses in Ihren eigenen Speicher. Halten Sie Download-URLs vertraulich und behandeln Sie sie als temporäre Zugriffslinks statt als dauerhafte Videoadressen.

Das Abonnement empfängt abgeschlossene Aufgaben für das ausgewählte Konto, einschließlich Videos, die außerhalb der CLI erstellt wurden. Wenn Ihre Aktion zu einem bestimmten Workflow gehört, gleichen Sie die Aufgaben-ID des Ereignisses mit Ihren übermittelten Aufgaben ab. Abschlussabonnements verarbeiten derzeit erfolgreiche Abschlüsse; fehlgeschlagene, abgebrochene oder teilweise abgeschlossene Aufgaben lösen dieses Ereignis nicht aus.

Ausführung und WiederholungsversucheAnkerlink kopieren

• Erfolg: Beenden Sie den Vorgang mit 0, nachdem Ihre Aktion erfolgreich war. Reela verwirft die Standardausgabe des Skripts; ausgegebene Inhalte werden nicht als Ergebnis verwendet.
• Zeitüberschreitung: --timeout-seconds 300 gewährt jedem Aufruf bis zu 300 Sekunden. Eine Zeitüberschreitung oder ein Exit-Code ungleich null führt dazu, dass die Zustellung fehlschlägt.
• Wiederholungsversuche: Reela wiederholt fehlgeschlagene Zustellungen. Wenn nur die Skriptmethode fehlschlägt, erlaubt --max-retries 3 insgesamt drei Versuche, einschließlich des ersten. Bei Fehlern, an denen andere aktivierte Methoden beteiligt sind, gilt delivery.max_retries.
• Erneute Zustellung: Gestalten Sie Aktionen so, dass sie für dieselbe task_id gefahrlos wiederholt werden können. Ein weiterer Aufruf soll also nicht dasselbe Video veröffentlichen oder denselben Datensatz ein zweites Mal anhängen.

Abonnement aktiv haltenAnkerlink kopieren

Der CLI-Daemon verarbeitet Abschlussereignisse und führt Ihre aktivierten Zustellungsmethoden aus. Nachdem Sie Ihre Methoden ausgewählt haben, starten Sie den Daemon und prüfen Sie den Zustellungsstatus:

reela daemon start
reela subscribe status

Beim Hinzufügen einer Methode wird außerdem versucht, einen angehaltenen Daemon zu starten. Wenn er bereits läuft, starten Sie ihn nach Änderungen an den Zustellungseinstellungen neu, damit diese wirksam werden. Für einen manuell gestarteten Daemon verwenden Sie reela daemon stop gefolgt von reela daemon start.

Reela speichert den Zustellungsfortschritt und setzt die Verarbeitung nach einem Neustart des Daemons dort fort. Wenn kein Fortschritt gespeichert ist, verarbeitet der Daemon standardmäßig neue Ereignisse. reela daemon start --keep-backlog verarbeitet außerdem frühere Ereignisse abgeschlossener Aufgaben, die noch verfügbar sind, wenn kein gespeicherter Fortschritt vorhanden ist.

Verwenden Sie reela daemon install, um den Start bei der Anmeldung zu aktivieren. Wenn der Daemon als Dienst installiert ist, starten Sie ihn nach Konfigurationsänderungen über die Dienstverwaltung Ihres Betriebssystems neu. Prüfen Sie reela daemon status oder reela daemon logs --tail 50, um die Zustellung zu kontrollieren.

Für die automatische Zustellung muss der Rechner, auf dem der Daemon läuft, eingeschaltet und mit dem Netzwerk verbunden bleiben. Starten Sie ihn, bevor Sie Videos absenden, deren Abschluss Ihr Skript auslösen soll.

daemon und subscribe sind unter Linux und macOS verfügbar. Windows x64 unterstützt Videobefehle, Statusabfragen und manuelle Downloads.

Optionale Zustellung per Download und E-MailAnkerlink kopieren

Zusätzlich zu Ihrem Skript können Sie automatische Downloads oder E-Mails mit fertigen Videos aktivieren. Downloads sind in den Standard-Zustellungseinstellungen aktiviert; legen Sie das Ziel mit reela config set delivery.download ~/Videos/reela fest. Wenn sie deaktiviert sind, aktivieren Sie sie mit reela subscribe add download --dir ~/Videos/reela. Aktivieren Sie E-Mails mit reela subscribe add email und fügen Sie optional --address me@example.com hinzu, um eine andere Adresse als die E-Mail-Adresse Ihres Kontos zu verwenden.

Mehrere Methoden können gleichzeitig aktiv sein, und ein Fehler bei einer Methode verhindert nicht die Ausführung der anderen. Jeder Skriptaufruf erhält eine eigene Abschlussnutzlast, einschließlich Downloadinformationen, sofern verfügbar. Alle Methoden finden Sie in der Referenz zu Zustellungsbefehlen.

Produktionskonfiguration wiederverwendenAnkerlink kopieren

Reela stellt zusätzliche Funktionen bereit, die zu Schritten in Ihrem Workflow werden können:

• Einheitliches Branding: Listen Sie vorhandene Markenpakete mit brand list auf und wenden Sie eines davon mit brand apply auf eine Aufgabe an. Der Befehl wartet auf die Ausgabe mit Branding. Siehe Markenbefehle.
• Programmatische Bearbeitung: Laden Sie JSON zur Bearbeitung herunter, validieren Sie Änderungen, speichern Sie einen Entwurf als Vorschau und übermitteln Sie mit edit einen Renderauftrag. Siehe Bearbeitungsbefehle.
• Separate Konten und Einstellungen: Wählen Sie mit --profile oder REELA_PROFILE ein Profil aus. Zustellungsmethoden und Einstellungen gelten für das ausgewählte Profil. Siehe Profile und Konfiguration.

Ein Workflow für Produktvideos kann beispielsweise ein Briefing mit Referenzbildern übermitteln und mithilfe eines Abschlussabonnements des Daemons das fertige Video an Ihr Veröffentlichungstool übergeben. Reela übernimmt die Generierung im Hintergrund und die Zustellung nach Abschluss; Ihr Tool entscheidet, wann es eine Aufgabe übermittelt und welche Aktion beim Eintreffen des Ergebnisses ausgeführt wird.

Alle Abonnement- und Daemonoptionen finden Sie in der Referenz zu Zustellungsbefehlen. Informationen zur Installation und Kontoautorisierung finden Sie unter Erste Schritte.