ElevenLabs 자동화
ElevenLabs 텍스트 음성 변환 워크플로우를 자동화하세요. 텍스트를 자연스러운 음성으로 변환하고, 음성 라이브러리를 탐색하며, 음성 세부 정보를 확인하고, 구독 크레딧을 확인하고, TTS 모델을 선택하고, 저지연 전송을 위해 오디오를 스트리밍하고, 이전에 생성된 오디오를 기록에서 검색할 수 있습니다.
툴킷 문서: composio.dev/toolkits/elevenlabs
설정
- Composio MCP 서버를 클라이언트에 추가:
https://rube.app/mcp - 메시지가 표시되면 ElevenLabs 계정을 연결합니다 (API 키 인증)
- 아래 워크플로우를 사용하기 시작합니다
핵심 워크플로우
1. 텍스트로 음성 생성
ELEVENLABS_TEXT_TO_SPEECH를 사용하여 텍스트를 다운로드 가능한 오디오 파일로 변환합니다.
도구: ELEVENLABS_TEXT_TO_SPEECH
입력:
- voice_id: 문자열 (필수) -- ELEVENLABS_GET_VOICES에서 획득
- text: 문자열 (필수) -- 대부분의 모델 최대 ~10,000자, Flash/Turbo v2의 경우 30,000자, v2.5의 경우 40,000자
- model_id: 문자열 (기본값 "eleven_monolingual_v1") -- 예: "eleven_multilingual_v2"
- output_format: 문자열 (기본값 "mp3_44100_128") -- 아래 형식 참조
- optimize_streaming_latency: 정수 (0-4; eleven_v3에서는 지원되지 않음)
- seed: 정수 (선택 사항, 재현성용 -- 보장되지 않음)
- pronunciation_dictionary_locators: 배열 (선택 사항, 최대 3개 사전)
출력 형식:
- MP3:
mp3_22050_32,mp3_44100_32,mp3_44100_64,mp3_44100_96,mp3_44100_128,mp3_44100_192(Creator+) - PCM:
pcm_16000,pcm_22050,pcm_24000,pcm_44100(Pro+) - uLaw:
ulaw_8000(Twilio용)
중요: 출력은 data.file.s3url에 사전 서명된 다운로드 링크가 있는 파일 객체입니다 (약 1시간 후 만료). 즉시 다운로드하세요.
2. 사용 가능한 음성 탐색
ELEVENLABS_GET_VOICES를 사용하여 모든 음성과 해당 속성 및 설정을 목록으로 확인합니다.
도구: ELEVENLABS_GET_VOICES
입력: (없음)
data.voices[]에 voice_id, name, labels (성별, 억양, 사용 사례) 및 설정이 포함된 배열을 반환합니다.
3. 특정 음성 검사
ELEVENLABS_GET_VOICE를 사용하여 합성 전 후보 음성의 상세 메타데이터를 가져옵니다.
도구: ELEVENLABS_GET_VOICE
입력:
- voice_id: 문자열 (필수) -- 예: "21m00Tcm4TlvDq8ikWAM"
- with_settings: 부울 (기본값 false) -- 상세 음성 설정 포함
4. 구독 및 크레딧 확인
ELEVENLABS_GET_USER_SUBSCRIPTION_INFO를 사용하여 대량 생성 전에 요금제 한도와 남은 크레딧을 확인합니다.
도구: ELEVENLABS_GET_USER_SUBSCRIPTION_INFO
입력: (없음)
5. 사용 가능한 TTS 모델 목록
ELEVENLABS_GET_MODELS를 사용하여 호환 가능한 모델을 찾고 can_do_text_to_speech: true로 필터링합니다.
도구: ELEVENLABS_GET_MODELS
입력: (없음)
6. 오디오 스트리밍 및 기록 검색
저지연 스트리밍 전송을 위해 ELEVENLABS_TEXT_TO_SPEECH_STREAM을 사용하고, 이전에 생성된 오디오를 재다운로드하려면 ELEVENLABS_GET_AUDIO_FROM_HISTORY_ITEM을 사용합니다.
도구: ELEVENLABS_TEXT_TO_SPEECH_STREAM
- TEXT_TO_SPEECH와 동일한 핵심 입력이지만 저지연 재생을 위한 스트림을 반환합니다.
도구: ELEVENLABS_GET_AUDIO_FROM_HISTORY_ITEM
- history_item_id: 문자열 (필수) -- 이전 생성에서의 ID
알려진 문제점
| 문제점 | 세부 사항 |
|---|---|
| 텍스트 길이 제한 | 대부분의 모델은 요청당 최대 약 10,000~20,000자로 제한됩니다. 초과 입력 시 HTTP 400 오류가 발생합니다. 긴 텍스트는 청크(약 5,000자)로 나누어 청크별로 생성하세요. |
| 출력이 사전 서명된 URL | ELEVENLABS_TEXT_TO_SPEECH는 약 1시간 만료 시간(X-Amz-Expires=3600)의 data.file.s3url을 반환합니다. 오디오 파일을 즉시 다운로드하세요. |
| 할당량 및 크레딧 오류 | quota_exceeded와 함께 HTTP 401 또는 payment_required와 함께 HTTP 402가 발생하면 크레딧이 부족하거나 등급 제한이 있음을 의미합니다. 대량 작업 전에 ELEVENLABS_GET_USER_SUBSCRIPTION_INFO로 확인하세요. |
| 음성 권한 | missing_permissions와 함께 HTTP 401이 발생하면 API 키에 voices_read 범위가 없음을 의미합니다. 키 권한을 확인하세요. |
| 모델 호환성 | 모든 모델이 TTS를 지원하지는 않습니다. ELEVENLABS_GET_MODELS를 사용하고 can_do_text_to_speech: true로 필터링하세요. optimize_streaming_latency 파라미터는 eleven_v3에서 지원되지 않습니다. |
| 큰 음성 목록 잘림 | ELEVENLABS_GET_VOICES는 큰 목록을 반환할 수 있습니다. 전체 data.voices[] 페이로드에서 선택하세요. 미리보기가 잘려 보일 수 있습니다. |
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
ELEVENLABS_TEXT_TO_SPEECH | 텍스트를 음성으로 변환, 다운로드 가능한 오디오 파일 반환 |
ELEVENLABS_GET_VOICES | 사용 가능한 모든 음성과 속성 목록 |
ELEVENLABS_GET_VOICE | 특정 음성의 상세 정보 가져오기 |
ELEVENLABS_GET_USER_SUBSCRIPTION_INFO | 구독 요금제와 남은 크레딧 확인 |
ELEVENLABS_GET_MODELS | 사용 가능한 TTS 모델 및 기능 목록 |
ELEVENLABS_TEXT_TO_SPEECH_STREAM | 저지연 전송을 위해 오디오 스트리밍 |
ELEVENLABS_GET_AUDIO_FROM_HISTORY_ITEM | 생성 기록에서 오디오 재다운로드 |
Composio 제공