Was macht ElevenLabs TTS?
Verwende diesen Skill für die ElevenLabs-Text-to-Speech-Generierung. Halte den Skill wiederverwendbar und frei von persönlichen Daten:
- Speichere keine API-Schlüssel, Sprachnamen, Sprach-IDs, E-Mails, Kontonamen, Kundennamen oder persönlichen Standardwerte im Skill.
- Lese
ELEVENLABS_API_KEYaus der Prozessumgebung oder der nächstgelegenen.env-Datei. - Lese kontospezifische Sprachprofile aus einer lokalen JSON-Konfiguration außerhalb dieses Skills.
- Generiere Audio mit anfragebezogenen Einstellungen. Ändere keine gespeicherten ElevenLabs-Konto- oder Spracheinstellungen, es sei denn, der Nutzer bittet ausdrücklich darum.
Lokale Profile
Bevorzuge eine dieser Konfigurationsquellen, in dieser Reihenfolge:
--config /pfad/zu/profiles.jsonELEVENLABS_TTS_CONFIG=/pfad/zu/profiles.jsonlocal/elevenlabs/profiles.json
Projektlokale Profildateien sind ebenfalls in Ordnung, wenn sie in .gitignore aufgeführt sind, z. B. config/local/elevenlabs-tts.json.
Das Hilfsskript erwartet diese Struktur:
{
"default_profile": "default",
"profiles": {
"default": {
"voice_name": "Name der Stimme aus dem lokalen Konto",
"voice_id": "optional-direct-voice-id",
"voice_id_env": "OPTIONAL_ENV_VAR_WITH_VOICE_ID",
"model_id": "eleven_multilingual_v2",
"output_format": "mp3_44100_128",
"voice_settings": {
"stability": 0.5,
"similarity_boost": 1.0,
"style": 0.0,
"speed": 1.0,
"use_speaker_boost": true
},
"output_dir": "outputs/voiceovers",
"emails": []
}
}
}
Felder wie emails, Besitzer, Aliase und Notizen dienen nur der lokalen Weiterleitung/Kontext. Das Skript ignoriert unbekannte Metadatenfelder.
Arbeitsablauf
- Wähle das Profil aus
--profile,ELEVENLABS_TTS_PROFILEoderdefault_profile. - Bevorzuge das Hilfsskript:
python3 <skill-root>/scripts/generate_voice.py --text-file script.txt --profile default --output output.mp3 - Wenn das Profil
voice_identhält, verwende sie. Wennvoice_id_envvorhanden ist, lese die Umgebungsvariable. Andernfalls durchsuche ElevenLabs nachvoice_name. - Verwende
model_id,output_formatundvoice_settingsaus dem Profil, es sei denn, der Nutzer überschreibt sie für diese Generierung. - Lege das generierte Audio im angeforderten Ziel ab. Wenn kein Ziel angegeben ist, verwende das
output_dirdes Profils, dannoutputs/voiceovers/. - Gib den Ausgabepfad und alle wichtigen Warnungen aus. Gib keine Geheimnisse preis.
Hilfsskript
Das gebündelte Skript unterstützt:
--text "..."für Inline-Text--text-file pfad.txtfür Skriptdateien- stdin, wenn weder
--textnoch--text-fileangegeben ist --profile namezur Auswahl eines lokalen Profils--config pfad.jsonzur Auswahl einer lokalen Profildatei--voice-id,--voice-name,--model-id,--output-formatund--settings-jsonfür einmalige Überschreibungen--output pfad.mp3zur Wahl der Ausgabedatei--dry-runzur Ausgabe des aufgelösten Anfrage-Payloads ohne Aufruf des Text-to-Speech-Endpunkts--list-voiceszur Auflistung passender ElevenLabs-Stimmen ohne Audio-Generierung
API-Hinweise
Verwende die aktuellen ElevenLabs-Endpunkte:
- Sprachsuche:
GET https://api.elevenlabs.io/v2/voices - Sprachgenerierung:
POST https://api.elevenlabs.io/v1/text-to-speech/:voice_id?output_format=...
Sende den API-Schlüssel als xi-api-key.