Maartenlouis/elevenlabs-remotion-skill

Was macht elevenlabs-remotion-skill?

Generieren Sie professionelle KI-Sprachaufnahmen für Remotion-Videos mit ElevenLabs. Enthält szenenbasierte Generierung, Zeichenvorgaben, Zeitvalidierung und Aussprachewörterbücher.

Eigenschaften

• Szenenbasierte Generierung: Weisen Sie jeder Szene Ihres Remotion-Videos einzigartige Sprachvorgaben zu.
• Zeichenvorgaben: Definieren Sie Zeichen mit Stimmen, Stil und Aussprache für konsistente Voiceovers.
• Zeitvalidierung: Stellen Sie sicher, dass generierte Sprachaufnahmen innerhalb der Szenendauer liegen, mit Warnungen bei Überlauf.
• Aussprachewörterbücher: Passen Sie die Aussprache bestimmter Wörter mit phonetischen Ersetzungen an.
• Batch-Verarbeitung: Generieren Sie mehrere Szenen in einem Durchgang mit automatischer Warteschlangenverwaltung und Neuversuchen.

Voraussetzungen

• Remotion-Projekt (v4.0+ empfohlen)
• ElevenLabs API-Schlüssel gesetzt in ELEVENLABS_API_KEY Umgebungsvariable
• Node.js 18+

Installation

npm install @maartenlouis/elevenlabs-remotion-skill

Schnellstart

1. Erstellen Sie eine Anforderungsdatei (voiceover-request.json):

{
  "scenes": [
    {
      "id": "intro",
      "text": "Willkommen zu unserem Produkt-Demo!",
      "voice": "21m00Tcm4TlvDq8ikWAM",
      "duration": 5,
      "character": "erzähler"
    },
    {
      "id": "scene2",
      "text": "Sehen wir uns die Kernfunktionen an.",
      "voice": "21m00Tcm4TlvDq8ikWAM",
      "duration": 4,
      "character": "erzähler"
    }
  ],
  "characters": {
    "erzähler": {
      "voice": "21m00Tcm4TlvDq8ikWAM",
      "stability": 0.5,
      "similarity_boost": 0.7
    }
  },
  "pronunciation_dictionary": [
    {
      "word": "API",
      "pronunciation": "ay-pee-eye"
    }
  ]
}

2. Führen Sie das Skill aus:

npx elevenlabs-remotion-skill --request voiceover-request.json --output ./voiceovers

API

CLI-Optionen

Flag	Beschreibung	Standard
--request	Pfad zur JSON-Anforderungsdatei	erforderlich
--output	Ausgabeverzeichnis für Audiodateien	./voiceovers
--api-key	ElevenLabs API-Schlüssel (überschreibt ELEVENLABS_API_KEY env)	optional
--dry-run	Validiert nur, ohne Audio zu generieren	false

Programmatische Nutzung

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

const result = await generateVoiceovers({
  scenes: [
    { id: 'intro', text: 'Hallo Welt!', voice: '21m00Tcm4TlvDq8ikWAM', duration: 3 }
  ],
  apiKey: process.env.ELEVENLABS_API_KEY
});

console.log('Generierte Dateien:', result.files);

Integration in Remotion

Um die generierten Voiceovers in Ihren Remotion-Kompositionen zu verwenden, importieren Sie die Audiodateien:

import { AbsoluteFill, Audio, useVideoConfig } from 'remotion';
import voiceoverIntro from './voiceovers/intro.mp3';

export const MyComposition = () => {
  return (
    <AbsoluteFill>
      <Audio src={voiceoverIntro} />
    </AbsoluteFill>
  );
};

Lizenz

MIT