Communitygithub.com

lfs-video-face-swap

Estimar créditos, preparar e iniciar uma troca de rosto aprovada para um MP4 carregado, ou verificar e baixar uma troca de rosto em vídeo existente usando o MCP Live Face Swap. Use quando o usuário quiser que o Live Face Swap processe um vídeo pré-gravado ou perguntar sobre uma tarefa do Live Face Swap.

O que é lfs-video-face-swap?

Este skill permite que um agente de IA (como Claude Code, Cursor ou Codex) interaja com o servidor MCP Live Face Swap para gerenciar o processo completo de troca de rosto em vídeos pré-gravados. Ele fornece três funcionalidades principais: estimativa de créditos e preparação de um rascunho, início de um trabalho aprovado e monitoramento/baixa do resultado final. Para usar, o agente primeiro chama `quote_video_face_swap` para obter uma estimativa de créditos com base na duração do vídeo (1-30 segundos). Se o usuário aprovar, ele chama `prepare_video_face_swap` para gerar um link de preparação que expira em 30 minutos. O usuário deve abrir esse link no navegador, selecionar um MP4 com um rosto visível e uma foto de retrato, e aprovar o orçamento exato. Após a aprovação, o agente chama `create_video_face_swap` com o `draftId` para iniciar o processamento, reservando créditos. O agente pode então verificar o status com `get_video_face_swap_result` e, quando concluído (`completed`), compartilha o link privado do resultado com o usuário para download do MP4. O skill lida com erros comuns, como expiração do rascunho ou alteração de orçamento, redirecionando o usuário para uma nova preparação. Ele também respeita limites de taxa e atrasos de repetição do servidor. Em caso de falha (`failed`), o agente informa o usuário e uma nova tentativa exige uma nova aprovação.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Troca de rosto ao vivo para vídeo carregado

Use as ferramentas MCP Live Face Swap conectadas. Se elas não estiverem disponíveis, direcione o usuário para as instruções de instalação ou o guia do MCP Live Face Swap. Use a conexão selecionada pelo usuário. Para testes locais, mantenha todas as chamadas na conexão local.

Estimar e preparar

  • Para uma estimativa de preço, chame quote_video_face_swap com durationSeconds entre 1 e 30. Pergunte pela duração se ela for desconhecida. Informe estimatedCredits como uma estimativa. Uma solicitação apenas de cotação termina aqui.
  • Quando o usuário quiser preparar um trabalho, chame prepare_video_face_swap sem argumentos. Guarde o draftId retornado e compartilhe preparationUrl de forma privada. O link expira após 30 minutos. Peça ao usuário para abri-lo com a mesma conta do Live Face Swap, selecionar um MP4 de 1 a 30 segundos com um rosto claramente visível e um retrato para o qual tenha permissão de uso, e aprovar a cotação exata mostrada no site. Mantenha os arquivos de origem nesse fluxo de trabalho do navegador.

Iniciar um trabalho aprovado

  • Após o usuário confirmar que aprovou a cotação exata no site e solicitar explicitamente o início, chame create_video_face_swap com o mesmo draftId. Iniciar reserva créditos. Salve o taskId retornado para verificações de status.
  • Se o servidor reportar VIDEO_MCP_APPROVAL_REQUIRED, envie o usuário de volta ao link de preparação. Se o rascunho expirou ou a cotação mudou, ofereça um novo link de preparação e repita a etapa de aprovação. Se a solicitação de início expirar ou o resultado não estiver claro, tente novamente com o mesmo draftId para evitar um trabalho duplicado.

Verificar e baixar

  • Chame get_video_face_swap_result com o taskId existente. Para uma solicitação apenas de status, informe o estado atual. Enquanto aguarda a conclusão, respeite retryAfterSeconds antes de verificar novamente. Se uma chamada atingir um limite de taxa, use o atraso de repetição do servidor.
  • Em completed, informe billedCredits quando retornado e compartilhe o resultUrl privado com o usuário. A página de resultado finaliza o vídeo no navegador e oferece pré-visualização e download do MP4. Em failed, informe a falha e quaisquer créditos faturados retornados. Uma nova tentativa requer uma nova aprovação.

Habilidades Relacionadas