ElevenLabs TTS은(는) 무엇을 하나요?
이 스킬을 ElevenLabs 텍스트-음성 변환 생성에 사용합니다. 스킬을 재사용 가능하고 개인 정보가 없도록 유지하세요:
- API 키, 음성 이름, 음성 ID, 이메일, 계정 이름, 고객 이름 또는 개인 기본값을 스킬에 저장하지 마세요.
ELEVENLABS_API_KEY는 프로세스 환경 또는 가장 가까운.env파일에서 읽어옵니다.- 계정별 음성 프로필은 이 스킬 외부의 로컬 JSON 설정에서 읽어옵니다.
- 요청 수준 설정으로 오디오를 생성하세요. 사용자가 명시적으로 요청하지 않는 한 저장된 ElevenLabs 계정 또는 음성 설정을 변경하지 마세요.
로컬 프로필
다음 설정 소스를 우선 순위대로 선호합니다:
--config /path/to/profiles.jsonELEVENLABS_TTS_CONFIG=/path/to/profiles.jsonlocal/elevenlabs/profiles.json
프로젝트 로컬 프로필 파일도 gitignore 되어 있다면 괜찮습니다. 예: config/local/elevenlabs-tts.json
도우미 스크립트는 다음 형태를 기대합니다:
{
"default_profile": "default",
"profiles": {
"default": {
"voice_name": "로컬 계정의 음성 이름",
"voice_id": "선택적-직접-음성-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로 보내세요.