ElevenLabs TTS
使用此技能進行 ElevenLabs 文字轉語音生成。保持技能可重複使用且不帶個人資訊:
- 請勿在技能中儲存 API 金鑰、語音名稱、語音 ID、電子郵件、帳戶名稱、客戶名稱或個人預設值。
- 從處理程序環境變數或最近的
.env檔案讀取ELEVENLABS_API_KEY。 - 從此技能外部的本機 JSON 設定讀取帳戶特定的語音設定檔。
- 使用請求層級的設定來產生音訊。除非使用者明確要求,否則請勿變更已儲存的 ElevenLabs 帳戶或語音設定。
本機設定檔
偏好使用下列設定來源,依序為:
--config /path/to/profiles.jsonELEVENLABS_TTS_CONFIG=/path/to/profiles.jsonlocal/elevenlabs/profiles.json
專案本機的設定檔檔案(例如 config/local/elevenlabs-tts.json)若已加入 .gitignore,也可以使用。
輔助腳本預期使用以下格式:
{
"default_profile": "default",
"profiles": {
"default": {
"voice_name": "Voice name from the local account",
"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": []
}
}
}
emails、擁有者、別名和備註等欄位僅用於本機路由/上下文。腳本會忽略未知的中繼資料欄位。
工作流程
- 從
--profile、ELEVENLABS_TTS_PROFILE或default_profile選擇設定檔。 - 偏好使用輔助腳本:
python3 <skill-root>/scripts/generate_voice.py --text-file script.txt --profile default --output output.mp3 - 如果設定檔有
voice_id,則使用它。如果有voice_id_env,則讀取該環境變數。否則透過voice_name搜尋 ElevenLabs。 - 除非使用者針對此次生成進行覆寫,否則使用設定檔的
model_id、output_format和voice_settings。 - 將生成的音訊放到請求的目的地。如果未提供目的地,則使用設定檔的
output_dir,然後使用outputs/voiceovers/。 - 回報輸出路徑和任何重要的警告。請勿列印機密資訊。
輔助腳本
捆綁的腳本支援:
--text "..."用於內嵌文字--text-file path.txt用於腳本檔案- 當未提供
--text和--text-file時,使用標準輸入 --profile name用於選擇本機設定檔--config path.json用於選擇本機設定檔檔案--voice-id、--voice-name、--model-id、--output-format和--settings-json用於一次性覆寫--output path.mp3用於選擇輸出檔案--dry-run用於列印解析後的請求內容,而不呼叫文字轉語音端點--list-voices用於列出匹配的 ElevenLabs 語音,而不生成音訊
API 注意事項
使用最新的 ElevenLabs 端點:
- 語音搜尋:
GET https://api.elevenlabs.io/v2/voices - 語音生成:
POST https://api.elevenlabs.io/v1/text-to-speech/:voice_id?output_format=...
將 API 金鑰作為 xi-api-key 傳送。