Maartenlouis/elevenlabs-remotion-skill

O que elevenlabs-remotion-skill faz?

Gere narrações profissionais com IA para vídeos Remotion usando ElevenLabs. Recursos incluem geração por cena, predefinições de personagens, validação de tempo e dicionários de pronúncia.

Funcionalidades

• Geração por Cena: Atribua diferentes vozes e estilos a diferentes cenas do seu vídeo.
• Predefinições de Personagens: Configure e reutilize configurações de voz para personagens consistentes.
• Validação de Tempo: Verifique se a duração do áudio gerado se ajusta perfeitamente à duração das cenas.
• Dicionários de Pronúncia: Corrija a pronúncia de palavras específicas para garantir naturalidade.

Pré-requisitos

• Node.js 18+ e npm
• Um projeto Remotion configurado
• Uma conta na ElevenLabs com uma chave de API

Instalação

npm install @maartenlouis/elevenlabs-remotion-skill

Configure a chave de API da ElevenLabs como uma variável de ambiente:

export ELEVENLABS_API_KEY="sua-chave-aqui"

Uso

Exemplo básico

import { generateVoiceover } from '@maartenlouis/elevenlabs-remotion-skill';

const voiceover = await generateVoiceover({
  text: "Bem-vindo ao nosso tutorial.",
  voice: "21m00Tcm4TlvDq8ikWAM", // ID da voz da ElevenLabs
  sceneDuration: 5, // segundos
});

Com predefinições de personagens

const characterPresets = {
  narrador: {
    voiceId: "21m00Tcm4TlvDq8ikWAM",
    stability: 0.5,
    similarity_boost: 0.75,
  },
  entrevistado: {
    voiceId: "AZnzlk1XvdvUeBnXmlld",
    stability: 0.3,
    similarity_boost: 0.8,
  },
};

const voiceover = await generateVoiceover({
  scene: [
    { personagem: "narrador", texto: "Vamos começar." },
    { personagem: "entrevistado", texto: "Estou pronto." },
  ],
  presets: characterPresets,
});

Documentação da API

Opções

Parâmetro	Tipo	Obrigatório	Descrição
text	string	Sim	O texto a ser narrado.
voice	string	Sim	O ID da voz da ElevenLabs.
sceneDuration	number	Não	Duração máxima esperada da cena em segundos.
stability	number	Não	Estabilidade da voz (0.0 a 1.0).
similarity_boost	number	Não	Similaridade da voz ao original (0.0 a 1.0).
pronunciationDictionary	object	Não	Mapeamento de palavras para pronúncias personalizadas.

Contribuição

Contribuições são bem-vindas! Envie pull requests para o repositório GitHub.

Licença

MIT