Shorts Voiceover

O que Shorts Voiceover faz?

Roteiro entra, Short pronto para upload sai. Diferente de ferramentas que estimam o tempo das legendas a partir do comprimento do texto, este skill transcreve a faixa de voz finalizada, para que cada legenda apareça exatamente no momento em que a palavra é falada.

Quando usar

• "Transforme este roteiro / estas dicas / esta postagem em um Short (ou Reel, ou TikTok)."
• "Faça um vídeo curto sem rosto com narração e legendas." "Use minha voz."
• "Faça 5 vídeos curtos a partir destes roteiros" -> execute uma vez para cada arquivo de roteiro.

Passos

1. Verifique se MIRAGEA_API_KEY está definida (nunca a imprima). Voz: o ID da voz Miragea do usuário, ou uma URL pública de um clipe da voz dele mais as palavras exatas. Sugira export MIRAGEA_VOICE_ID=.... Clone apenas uma voz que o usuário possua ou tenha permissão para usar.

2. Escreva o roteiro: um parágrafo curto por cena, linha em branco entre cenas, total de 120-170 palavras para um Short de 45-60 s. Comece com um gancho na cena 1. Opcionalmente, @arquivo no início de uma cena seleciona seu fundo:

   Três dicas rápidas para fazer qualquer narração soar profissional.
   
   @broll/mesa.mp4
   Primeiro, grave em um cômodo pequeno com móveis macios. Eco é mais difícil de corrigir do que ruído.
   

3. Renderize:

   python3 scripts/short.py dicas.txt --voice ID_VOZ                       # fundos gradientes
   python3 scripts/short.py dicas.txt --media ./broll --music fundo.mp3    # imagens/clipes do usuário + música
   

4. Entregue ao usuário video e srt do JSON impresso. Ofereça edições: altere o texto de uma cena e execute novamente; apenas essa cena é regravada e o restante vem do cache.

O que é automático

Etapa	Como
Voz	Cada cena é narrada com Miragea; pausa de 0,18 s entre cenas
Sincronismo das legendas	Faixa de voz finalizada transcrita pelo Miragea; dicas em LETRAS MAIÚSCULAS de 1 a 3 palavras, terço inferior
Imagens	Cortadas para 9:16, zoom lento para dentro/fora alternando por cena
Clipes	Cortados para 9:16, em loop ou ajustados à duração da cena, som original descartado
Sem mídia	Gradiente animado (4 paletas, girando)
Música	Em loop, a 30%, ducking lateral sob a voz
Loudness	-14 LUFS integrado, -1 dBTP (alvo Shorts/TikTok/Reels)
Reexecuções	Voz por cena e transcrição em cache; cenas inalteradas são gratuitas

Opções

Bandeira	Padrão	O que faz
--voice ID / --ref-url URL --ref-text TEXTO	env	Voz salva do Miragea, ou clonagem a partir de um clipe público
--media DIR	nenhum	Imagens/clipes para cenas sem @arquivo, em ordem de nome
--music ARQUIVO	nenhum	Música de fundo, com ducking automático
--lowercase	desligado	Legendas em letras maiúsculas/minúsculas
--no-captions	desligado	Pular legendas (sem custo de transcrição)
--model	expressive	ou standard
-o ARQUIVO	SCRIPT.short.mp4	Caminho de saída

Custo e limites

Voz: por caractere (um Short de 150 palavras tem ~850 caracteres). Sincronismo das legendas: 3 pontos por segundo da voz finalizada (~75 pontos para 25 s); em cache depois. Taxas vigentes: GET https://miragea.ai/v1/capabilities. As cenas devem ter menos de 2.000 caracteres. Um aviso é impresso acima de 3 minutos (limite do YouTube Shorts).

Solução de problemas

• arquivo de mídia não encontrado -> caminhos após @ são relativos ao roteiro ou à pasta --media.
• Nenhum filtro encontrado: gradients -> ffmpeg é anterior à versão 6.1; atualize ou use --media com imagens.
• 401 chave errada, 402 recarregue em miragea.ai, 429 aguarde e execute novamente (nada em cache é cobrado novamente).

Use apenas músicas e imagens para as quais você tem direitos. Veja examples/ para um roteiro real e sua saída.