Communitygithub.com

lfs-video-face-swap

Estimer les crédits, préparer et lancer un échange de visage approuvé pour une vidéo MP4 téléchargée, ou vérifier et télécharger un échange de visage vidéo existant via l'assistant Live Face Swap MCP. À utiliser lorsque l'utilisateur souhaite que Live Face Swap traite une vidéo préenregistrée ou s'interroge sur une tâche Live Face Swap.

Qu'est-ce que lfs-video-face-swap ?

Cette compétence permet aux agents IA d'interagir avec le serveur Live Face Swap MCP pour effectuer des échanges de visage sur des vidéos préenregistrées au format MP4 (durée 1 à 30 secondes). Elle couvre trois étapes clés : l'estimation des crédits, la préparation et le lancement d'un travail approuvé, ainsi que la vérification et le téléchargement du résultat final. L'agent peut d'abord appeler `quote_video_face_swap` pour obtenir une estimation du coût en crédits, puis `prepare_video_face_swap` pour générer un lien de préparation que l'utilisateur doit ouvrir dans son navigateur (avec le même compte Live Face Swap) pour sélectionner une vidéo, un portrait et approuver le devis exact. Une fois approuvé, l'appel à `create_video_face_swap` démarre le traitement et retourne un `taskId` pour le suivi. Enfin, `get_video_face_swap_result` permet de vérifier l'état (avec `retryAfterSeconds` pour les limites de débit) et, en cas de succès, fournit une URL privée de résultat où l'utilisateur peut voir et télécharger la vidéo finale. La compétence gère également les erreurs telles que les liens expirés ou les modifications de devis en proposant un nouveau lien de préparation. Cette compétence est conçue pour les agents compatibles MCP (comme Claude Code, Cursor, Codex) et nécessite que l'utilisateur ait installé et connecté le serveur Live Face Swap MCP.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Échange de visage en direct pour vidéo téléchargée

Utilisez les outils MCP Live Face Swap connectés. S'ils ne sont pas disponibles, orientez l'utilisateur vers les instructions d'installation ou le guide Live Face Swap MCP. Utilisez la connexion sélectionnée par l'utilisateur. Pour les tests locaux, gardez chaque appel sur la connexion locale.

Estimation et préparation

  • Pour une estimation de prix, appelez quote_video_face_swap avec durationSeconds entre 1 et 30. Demandez la durée si elle est inconnue. Rapportez estimatedCredits comme estimation. Une demande de devis uniquement s'arrête ici.
  • Lorsque l'utilisateur souhaite préparer un travail, appelez prepare_video_face_swap sans arguments. Conservez le draftId retourné et partagez preparationUrl de manière privée. Le lien expire après 30 minutes. Demandez à l'utilisateur de l'ouvrir avec le même compte Live Face Swap, de sélectionner une vidéo MP4 de 1 à 30 secondes avec un visage clairement visible et un portrait dont il a l'autorisation d'utiliser, et d'approuver le devis exact affiché sur le site. Gardez les fichiers sources dans ce flux de travail du navigateur.

Démarrer un travail approuvé

  • Une fois que l'utilisateur confirme avoir approuvé le devis exact sur le site et demande explicitement de démarrer, appelez create_video_face_swap avec le même draftId. Le démarrage réserve des crédits. Enregistrez le taskId retourné pour les vérifications d'état.
  • Si le serveur signale VIDEO_MCP_APPROVAL_REQUIRED, renvoyez l'utilisateur vers le lien de préparation. Si le projet a expiré ou si le devis a changé, proposez un nouveau lien de préparation et répétez l'étape d'approbation. Si la demande de démarrage expire ou si le résultat n'est pas clair, réessayez avec le même draftId pour éviter un travail en double.

Vérifier et télécharger

  • Appelez get_video_face_swap_result avec le taskId existant. Pour une demande de statut uniquement, rapportez l'état actuel. En attendant la fin, respectez retryAfterSeconds avant de vérifier à nouveau. Si un appel atteint une limite de débit, utilisez le délai de réessai du serveur.
  • Lorsque completed est signalé, rapportez billedCredits lorsqu'il est renvoyé et partagez le resultUrl privé avec l'utilisateur. La page de résultat finalise la vidéo dans le navigateur et propose un aperçu MP4 et un téléchargement. En cas d'échec (failed), signalez l'échec et les crédits facturés éventuellement renvoyés. Une nouvelle tentative nécessite une nouvelle approbation.

Skills associés