Maiusless/english-trading-video-translation

O que english-trading-video-translation faz?

Habilidade de agente para ASR de vídeos em inglês de fonte protegida, tradução para chinês, exportação de legendas e queima verificada com FFmpeg.

Visão Geral

Esta habilidade automatiza o processo de transcrição e tradução de vídeos em inglês, especialmente aqueles com restrições de direitos autorais ou fontes protegidas. Ela utiliza modelos ASR (como Whisper) para transcrever o áudio, traduz o texto para chinês e gera legendas no formato SRT. Por fim, o FFmpeg é usado para incorporar as legendas ao vídeo, com verificações para garantir que o processo foi bem-sucedido.

Funcionalidades Principais

• Reconhecimento Automático de Fala (ASR): Transcreve áudio de vídeos em inglês usando modelos de última geração, como o Whisper da OpenAI, suportando diversos formatos de áudio e vídeo.
• Tradução para Chinês: Traduz o texto transcrito para chinês simplificado ou tradicional, dependendo da configuração, utilizando APIs de tradução como Google Translate ou DeepL.
• Exportação de Legendas: Gera arquivos de legendas no formato SRT, prontos para uso em players de vídeo ou para edição manual.
• Queima de Legendas com FFmpeg: Usa FFmpeg para incorporar as legendas diretamente no vídeo, criando um arquivo de saída com as legendas visíveis. Inclui verificações de integridade e validação.

Requisitos

• Python 3.8 ou superior
• FFmpeg instalado e acessível no PATH
• Dependências Python: whisper, ffmpeg-python, requests, pysrt
• Chave de API para o serviço de tradução (se aplicável)

Instalação

pip install whisper ffmpeg-python requests pysrt

Certifique-se de que o FFmpeg está instalado:

# Ubuntu/Debian
sudo apt install ffmpeg

# macOS (Homebrew)
brew install ffmpeg

# Windows (baixe o executável e adicione ao PATH)

Uso

Exemplo de Comando

python skill.py --video caminho/para/video.mp4 --output caminho/para/saida.mp4 --language zh

Parâmetros

Parâmetro	Descrição	Obrigatório
--video	Caminho para o arquivo de vídeo de entrada	Sim
--output	Caminho para o arquivo de vídeo de saída	Sim
--language	Idioma de saída das legendas (zh para chinês simplificado, zh-TW para tradicional)	Não (padrão: zh)
--model	Tamanho do modelo Whisper (tiny, base, small, medium, large)	Não (padrão: base)
--translate-api	API de tradução a usar (google ou deepl)	Não (padrão: google)
--api-key	Chave de API para o serviço de tradução (se necessário)	Não

Fluxo de Trabalho Típico

1. Extrair Áudio: O áudio é extraído do vídeo usando FFmpeg.
2. Transcrever: O modelo Whisper transcreve o áudio para texto em inglês.
3. Traduzir: O texto é traduzido para chinês usando a API especificada.
4. Gerar Legendas: Um arquivo SRT é criado com as legendas traduzidas.
5. Queimar Legendas: O FFmpeg incorpora as legendas no vídeo, gerando o arquivo de saída.
6. Verificar: O script verifica se o arquivo de saída foi criado corretamente e se as legendas estão visíveis.

Exemplo de Saída

Após a execução bem-sucedida, você terá:

• video_com_legendas.mp4: Vídeo com legendas queimadas.
• legendas.srt: Arquivo de legendas separado (opcional).

Solução de Problemas

• Erro: ffmpeg não encontrado: Certifique-se de que o FFmpeg está instalado e no PATH do sistema.
• Erro: Chave de API inválida: Verifique se a chave de API para o serviço de tradução está correta.
• Legendas fora de sincronia: Tente usar um modelo Whisper maior (como medium ou large) para melhor precisão.

Notas Legais

Esta habilidade deve ser usada apenas com vídeos para os quais você tem permissão para transcrever e traduzir. Respeite os direitos autorais e as políticas de uso justo.

Contribuição

Contribuições são bem-vindas! Envie issues ou pull requests no repositório.

Licença

MIT