Communitygithub.com

lfs-video-face-swap

Schätzt Credits, bereitet einen genehmigten Gesichtstausch für ein hochgeladenes MP4 vor und startet ihn oder überprüft und lädt einen vorhandenen Video-Gesichtstausch herunter. Verwende dies, wenn der Benutzer wünscht, dass Live Face Swap ein vorab aufgezeichnetes Video verarbeitet oder nach einem Live Face Swap-Auftrag fragt.

Was ist lfs-video-face-swap?

Dieses Skill ermöglicht die nahtlose Integration des Live Face Swap MCP in KI-Agenten wie Claude Code, Cursor oder Codex. Es führt den Agenten Schritt für Schritt durch den gesamten Workflow: von der Kostenschätzung über die Vorbereitung und Genehmigung eines Auftrags bis hin zur Statusüberprüfung und dem Herunterladen des fertigen Videos. Der Agent verwendet die MCP-Tools `quote_video_face_swap`, `prepare_video_face_swap`, `create_video_face_swap` und `get_video_face_swap_result`, um die Interaktion mit dem Live Face Swap-Dienst zu ermöglichen. Zu den wichtigsten Funktionen gehören das Abrufen einer Credit-Schätzung basierend auf der Videodauer, das Erstellen eines vorbereitenden Links, der vom Benutzer im Browser geöffnet werden muss, um Videodatei und Quellportrait auszuwählen und den genauen Kostenvoranschlag zu genehmigen, das Starten des Auftrags unter Verwendung einer bestätigten draftId, das Handhaben von Fehlern wie abgelaufenen Entwürfen oder geänderten Kostenvoranschlägen sowie das Abrufen des Ergebnisses mit dem endgültigen Video-Download-Link. Der Skill behandelt Edge Cases wie Timeouts, Ratenbegrenzungen und den erneuten Versuch von Aufträgen, um eine zuverlässige Ausführung zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aloow/lfs-video-face-swap/tree/main

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Live Face Swap für hochgeladene Videos

Verwende die verbundenen Live Face Swap MCP-Tools. Falls sie nicht verfügbar sind, verweise den Benutzer auf die Installationsanleitung oder den Live Face Swap MCP-Guide. Verwende die vom Benutzer ausgewählte Verbindung. Führe bei lokalen Tests jeden Aufruf über die lokale Verbindung durch.

Kostenschätzung und Vorbereitung

  • Für eine Preis-Schätzung rufe quote_video_face_swap mit durationSeconds zwischen 1 und 30 auf. Frage nach der Dauer, falls sie unbekannt ist. Melde estimatedCredits als Schätzung. Eine reine Schätzungsanfrage endet hier.
  • Wenn der Benutzer einen Auftrag vorbereiten möchte, rufe prepare_video_face_swap ohne Argumente auf. Behalte die zurückgegebene draftId und teile preparationUrl privat mit. Der Link läuft nach 30 Minuten ab. Bitte den Benutzer, ihn mit demselben Live Face Swap-Konto zu öffnen, ein 1–30 Sekunden langes MP4 mit einem klar sichtbaren Gesicht und ein Portrait auszuwählen, für das er die Berechtigung hat, und den genauen auf der Website angezeigten Kostenvoranschlag zu genehmigen. Behalte die Quelldateien in diesem Browser-Workflow.

Starten eines genehmigten Auftrags

  • Nachdem der Benutzer bestätigt hat, dass er den genauen Kostenvoranschlag auf der Website genehmigt hat, und explizit um den Start bittet, rufe create_video_face_swap mit derselben draftId auf. Das Starten reserviert Credits. Speichere die zurückgegebene taskId für Statusabfragen.
  • Wenn der Server VIDEO_MCP_APPROVAL_REQUIRED meldet, sende den Benutzer zurück zum Vorbereitungslink. Wenn der Entwurf abgelaufen ist oder sich der Kostenvoranschlag geändert hat, biete einen neuen Vorbereitungslink an und wiederhole den Genehmigungsschritt. Wenn die Startanfrage ausläuft oder das Ergebnis unklar ist, wiederhole den Vorgang mit derselben draftId, um einen doppelten Auftrag zu vermeiden.

Überprüfen und Herunterladen

  • Rufe get_video_face_swap_result mit der vorhandenen taskId auf. Bei einer reinen Statusabfrage melde den aktuellen Zustand. Während du auf die Fertigstellung wartest, beachte retryAfterSeconds, bevor du erneut prüfst. Wenn ein Aufruf auf eine Ratenbegrenzung stößt, verwende die Verzögerung des Servers für erneute Versuche.
  • Bei completed melde billedCredits, falls zurückgegeben, und teile die private resultUrl mit dem Benutzer. Die Ergebnisseite schließt das Video im Browser ab und bietet MP4-Vorschau und Download an. Bei failed melde den Fehler und etwaige zurückgegebene abgerechnete Credits. Ein neuer Versuch erfordert eine neue Genehmigung.

Verwandte Skills