Communitygithub.com

lfs-video-face-swap

Estimar créditos, preparar e iniciar un intercambio facial aprobado para un MP4 subido, o verificar y descargar un intercambio facial de video existente usando el MCP de Live Face Swap. Úselo cuando el usuario desee que Live Face Swap procese un video pregrabado o pregunte sobre una tarea de Live Face Swap.

¿Qué es lfs-video-face-swap?

Esta habilidad permite a un agente de IA interactuar con el MCP de Live Face Swap para gestionar el intercambio facial en videos pregrabados. El agente puede estimar créditos necesarios, preparar un trabajo, iniciarlo tras la aprobación del usuario en el sitio web de Live Face Swap, y verificar el estado o descargar el resultado final. Es útil para desarrolladores que integran capacidades de intercambio facial en sus flujos de trabajo automatizados, soportando conexiones locales o remotas según la configuración del usuario. El proceso implica tres fases: estimación y preparación (generando un enlace temporal), inicio del trabajo aprobado (consumiendo créditos), y verificación y descarga del video procesado.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Intercambio facial en vivo para video subido

Use las herramientas MCP de Live Face Swap conectadas. Si no están disponibles, dirija al usuario a las instrucciones de instalación o a la guía MCP de Live Face Swap. Use la conexión que el usuario seleccionó. Para pruebas locales, mantenga todas las llamadas en la conexión local.

Estimar y preparar

  • Para un estimado de precios, llame quote_video_face_swap con durationSeconds entre 1 y 30. Pregunte por la duración si se desconoce. Reporte estimatedCredits como un estimado. Una solicitud solo de cotización termina aquí.
  • Cuando el usuario desee preparar un trabajo, llame prepare_video_face_swap sin argumentos. Conserve el draftId devuelto y comparta preparationUrl de forma privada. El enlace caduca después de 30 minutos. Pida al usuario que lo abra con la misma cuenta de Live Face Swap, seleccione un MP4 de 1 a 30 segundos con una cara claramente visible y un retrato que tenga permiso para usar, y apruebe la cotización exacta mostrada en el sitio. Mantenga los archivos fuente en ese flujo de trabajo del navegador.

Iniciar un trabajo aprobado

  • Después de que el usuario confirme que aprobó la cotización exacta en el sitio y solicite explícitamente iniciar, llame create_video_face_swap con el mismo draftId. Iniciar reserva créditos. Guarde el taskId devuelto para verificar el estado.
  • Si el servidor informa VIDEO_MCP_APPROVAL_REQUIRED, envíe al usuario de vuelta al enlace de preparación. Si el borrador caducó o la cotización cambió, ofrezca un nuevo enlace de preparación y repita el paso de aprobación. Si la solicitud de inicio se agota o el resultado no está claro, reintente con el mismo draftId para evitar un trabajo duplicado.

Verificar y descargar

  • Llame get_video_face_swap_result con el taskId existente. Para una solicitud solo de estado, reporte el estado actual. Mientras espera la finalización, respete retryAfterSeconds antes de verificar nuevamente. Si una llamada alcanza un límite de velocidad, use el retraso de reintento del servidor.
  • En completed, reporte billedCredits cuando se devuelva y comparta el resultUrl privado con el usuario. La página de resultados finaliza el video en el navegador y ofrece vista previa y descarga en MP4. En failed, reporte el fallo y cualquier crédito facturado devuelto. Un nuevo intento requiere una nueva aprobación.

Skills relacionados