Communitygithub.com

ai-video-voice: 配音

Adiciona narração, legendas e mixagem de áudio a um vídeo curto: síntese TTS em uma única tomada, sincronia áudio-vídeo pela duração real, temporização das legendas a partir do áudio, mixagem normalizada para -14 LUFS. Executado após ai-video-render, antes da revisão.

O que é ai-video-voice: 配音?

O skill ai-video-voice é uma habilidade projetada para ser executada após a renderização do vídeo (ai-video-render) e antes da revisão, adicionando narração (voiceover), legendas e mixagem de áudio a um vídeo curto. Sua principal função é sintetizar a narração em uma única tomada para evitar costuras e desvios, sincronizar o áudio com o vídeo pela duração real (sem esticar o áudio), gerar legendas a partir da transcrição do áudio (e não de uma estimativa textual), e normalizar o áudio final para -14 LUFS. O skill verifica a configuração de voz antes da síntese, reporta erros ao usuário e nunca troca silenciosamente para uma voz diferente. Entrega os arquivos de áudio (voiceover.wav), legendas (captions.srt) e um relatório de mixagem (mix-report.md) com métricas como duração, pico e LUFS. É útil para desenvolvedores que trabalham com criação automatizada de vídeos, garantindo consistência e qualidade profissional na pós-produção de áudio.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LaomaiAI/ai-video-skills/tree/HEAD/skills/04-voice

Perguntar na sua IA favorita

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

Documentação

O que ai-video-voice: 配音 faz?

Quando usar

O vídeo silencioso (film.mp4) existe. Este skill adiciona narração, legendas e a mixagem final. Ele nunca altera a imagem.

1. Verifique primeiro a configuração de voz

Execute a verificação da configuração de TTS antes de sintetizar (por exemplo, um comando doctor se a ferramenta de TTS fornecer um). Reporte configuração ausente ao usuário; não mude silenciosamente para uma voz diferente.

  • Se o usuário solicitou uma voz pessoal e sua configuração está ausente ou quebrada, pause apenas a narração afetada. Não troque silenciosamente por outra voz.
  • Configurações de voz pessoal, gravações, clipes de referência e pesos do modelo permanecem em um diretório privado. Eles nunca entram neste repositório.

2. Sintetize em uma tomada única

  • Sintetize a narração em uma tomada única, não costurada frase por frase. A costura cria emendas audíveis e desvios.
  • Se o modelo de voz ou clipe de referência mudar, gere uma nova versão da narração. Nunca sobrescreva o arquivo de áudio antigo.

3. Sincronia áudio-vídeo usa a duração real

  • Sincronize pela duração real da narração. Nunca estique o áudio no tempo para caber em um plano.
  • Se a filmagem for curta, segure o último quadro para preencher a lacuna. Se a filmagem for longa, corte o segmento de menor informação.
  • Posicione ações pesadas em batidas fortes. Mova efeitos sonoros do próprio movimento.

4. Legendas seguem o áudio

  • A temporização das legendas vem do áudio, não da estimativa do roteiro. Transcreva com um reconhecedor de fala quando disponível; sem ele, use o roteiro mais a detecção de silêncio (erro pode chegar a 0,4 segundos).
  • Corrija reconhecimentos incorretos em relação ao roteiro. Corte sentenças iniciais e finais que pertencem a vizinhos.
  • Entregue captions.srt junto com o filme. Se o filme for re-editado para um editor que adiciona suas próprias legendas, entregue também um vídeo sem legendas mais o arquivo .srt.

5. Mixagem

  • Normalize o áudio mixado para -14 LUFS.
  • Mantenha música, narração e efeitos sonoros em uma única linha do tempo com a imagem.
  • Verifique o pico de áudio e a decodificação completa antes de passar para a revisão.

Contrato de saída

  • voiceover.wav (ou .mp3), uma única tomada.
  • captions.srt.
  • mix-report.md (duração, pico, LUFS, origem da legenda e limite de erro).

Regras

  • Uma configuração de voz ausente bloqueia apenas a narração. Nunca bloqueia o trabalho de roteiro ou imagem.
  • Nunca afirme que um arquivo de legenda é exato quando veio de detecção de silêncio; escreva o limite de erro no relatório de mixagem.
  • Sem upload ou implantação de áudio sem autorização de lançamento.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas