/dubbing

English ｜ 한국어 ｜ Español ｜ Português ｜ Русский ｜ Bahasa Indonesia ｜ Deutsch ｜ ไทย ｜ 日本語 ｜ 繁體中文 ｜ 简体中文 ｜ Tiếng Việt ｜ Français

Perguntas comuns sobre as skills /dubbing e /srt. Para instalação e uso, consulte o README.

O que eu preciso para usá-la?

Node.js 18+ é tudo o que você precisa. Legendas estilizadas, traduzir um SRT que você fornece e clipes curtos funcionam sem cadastro. Somente as etapas de IA do lado do servidor (dublagem, sincronização labial, separação, reconhecimento de fala) precisam de uma chave de API do Perso Dubbing. → Obtenha uma chave de API

Como registro minha chave de API?

Na primeira execução, uma página do navegador é aberta — faça login e clique uma vez, e sua chave é emitida e armazenada criptografada nesta máquina. Não há nada para copiar. Se nenhum navegador puder ser aberto, um arquivo de chave é aberto no lugar: cole nele apenas a sua chave de API e salve (ela é criptografada e o arquivo é excluído). Nunca cole a chave no chat. Verificação manual: npm run key:check.

Isso tem custo?

A skill é gratuita e de código aberto (MIT). Legendas estilizadas, traduzir um SRT que você fornece e clipes curtos são grátis. Somente as etapas de IA do lado do servidor (dublagem, sincronização labial, separação, reconhecimento de fala) cobram créditos — você paga apenas pelo que processa.

O que posso fornecer como entrada?

Um arquivo local, uma pasta local ou uma URL (YouTube, TikTok, Google Drive). Vídeos grandes demais ou muito longos são divididos, processados e remontados automaticamente.

Ela consegue dublar para vários idiomas ou processar muitos arquivos de uma vez?

Sim. Coloque vários idiomas em um único comando (--target en,ja,zh) — a fonte é enviada e dividida uma única vez, e depois reutilizada por idioma. Você também pode misturar vários arquivos, pastas e URLs em uma única execução.

Onde meus resultados são salvos?

Por padrão, junto ao vídeo de origem, ou na pasta que você informar com --out. Cada execução também vira um projeto no seu portal da Perso (https://perso.ai/en/workspace/vt), onde você pode baixá-lo novamente ou obter outros formatos.

O que é a sincronização labial?

Ela ajusta os movimentos da boca ao áudio dublado. É executada depois da dublagem, funciona apenas com vídeo, demora consideravelmente mais e custa créditos extras. Adicione --lipsync.

O que é a separação de áudio?

Ela divide a fonte em faixas de voz / fundo / subfundo — sem envolver dublagem. Adicione --separate.

Ela consegue gerar legendas (SRT) em vez de dublar?

A skill /srt extrai as legendas no idioma original de um vídeo/áudio/URL usando o reconhecimento de fala da Perso. Se você também quiser as legendas traduzidas, peça o SRT indicando os idiomas desejados. Ela também pode incorporar legendas estilizadas no vídeo — presets prontos ou sua própria fonte, cor e posição — algo que roda localmente e é grátis (com o seu próprio SRT, não são necessários chave nem créditos).

Parou no meio do processo (sem créditos, uma falha ou um shell encerrado). E agora?

O progresso é salvo em um arquivo de estado durante toda a execução (*.dubresume.json para /dubbing, *.srtresume.json para /srt). Execute novamente o comando --resume "<state-file>" exibido para concluir apenas as partes restantes — as partes já concluídas são ignoradas e nunca são cobradas novamente.

Fiquei sem créditos. Como faço para recarregar?

A skill pode gerar um link de pagamento do Stripe (assinar, mudar de plano ou comprar créditos, dependendo do seu plano). Você mesmo abre o link e paga — o agente nunca paga em seu nome. Depois de recarregar, retome com o comando --resume exibido.

Posso dublar sem salvar um arquivo local?

Sim, para um único vídeo (não dividido): adicione --no-save. O resultado permanece no seu espaço de trabalho da Perso e não é baixado. Vídeos divididos ainda são salvos normalmente, porque o arquivo combinado precisa de um download local.

node não foi encontrado — o que faço?

A skill precisa do Node.js 18+. Verifique com node -v; instale a versão LTS em https://nodejs.org, ou simplesmente peça ao agente para instalá-lo para você e tente novamente.

Como atualizo a skill?

npx perso-dubbing@latest, ou no plugin do Claude Code: /plugin update perso-dubbing.

Quais dados a skill coleta?

Apenas eventos de uso — qual ação foi executada, se teve sucesso, contagens aproximadas, versão do app e sistema operacional — identificados com um ID aleatório por instalação e o número do seu espaço de trabalho. Sua chave de API e sua mídia nunca são incluídas.