--- title: RunAPI를 통해 WorkBuddy에서 ElevenLabs 사용하기 — TTS MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에 ElevenLabs 텍스트 음성 변환, 음성 텍스트 변환, 오디오 분리 기능을 추가하세요. 키 1개, 29개 언어, 비동기 작업. url: https://runapi.ai/ko/workbuddy-elevenlabs.md canonical: https://runapi.ai/ko/workbuddy-elevenlabs locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-elevenlabs zh-CN: https://runapi.ai/zh-CN/workbuddy-elevenlabs es: https://runapi.ai/es/workbuddy-elevenlabs ja: https://runapi.ai/ja/workbuddy-elevenlabs de: https://runapi.ai/de/workbuddy-elevenlabs fr: https://runapi.ai/fr/workbuddy-elevenlabs pt-BR: https://runapi.ai/pt-BR/workbuddy-elevenlabs ko: https://runapi.ai/ko/workbuddy-elevenlabs it: https://runapi.ai/it/workbuddy-elevenlabs nl: https://runapi.ai/nl/workbuddy-elevenlabs pl: https://runapi.ai/pl/workbuddy-elevenlabs tr: https://runapi.ai/tr/workbuddy-elevenlabs zh-TW: https://runapi.ai/zh-TW/workbuddy-elevenlabs zh-HK: https://runapi.ai/zh-HK/workbuddy-elevenlabs ar: https://runapi.ai/ar/workbuddy-elevenlabs x-default: https://runapi.ai/workbuddy-elevenlabs model: elevenlabs --- > HTML version: https://runapi.ai/ko/workbuddy-elevenlabs > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 ElevenLabs를 사용하세요. ElevenLabs는 RunAPI를 통해 6가지 오디오 endpoint를 제공합니다 — 1초 미만의 지연 시간을 갖춘 turbo-v2.5 TTS, 29개 언어를 지원하는 multilingual-v2, 다화자 대화를 위한 dialogue-v3, 사운드 이펙트, 음성 텍스트 변환 전사, 보컬 분리. RunAPI를 MCP 서버로 한 번만 추가하면, WorkBuddy 에이전트가 동일한 키로 모두 호출할 수 있습니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 1개 · 오디오 endpoint 6개 · 문자당 과금 ### 프롬프트 ```text Using the runapi MCP server, generate speech audio with ElevenLabs. Requirements: - Call the ElevenLabs text_to_speech tool exposed by the runapi MCP server. - Set model to "text-to-speech-turbo-v2.5". - Text: "Welcome to RunAPI. This audio was generated from WorkBuddy." - Set speed to 1.0, stability to 0.5, similarity_boost to 0.75. - The task is async — keep polling until the status is "completed", then give me the audio URL. ``` ### MCP 설정 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 응답 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "text-to-speech-turbo-v2.5", "output": { "audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3", "characters_billed": 62 } } ``` ## WorkBuddy에서 ElevenLabs를 3단계로 사용하기 1. **RunAPI를 MCP server로 추가하기** - WorkBuddy를 실행하는 환경에 RUNAPI_API_KEY를 설정한 후, streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키는 runapi라는 MCP 서버를 등록하세요. TTS, STT, 대화, 음향 효과, 오디오 분리 등 ElevenLabs의 6가지 endpoint가 하나의 키로 호출 가능한 도구가 됩니다. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **에이전트에게 텍스트를 읽어달라고 요청하기** - 읽어줄 텍스트와 모델명을 WorkBuddy에 입력하세요 — 저지연 영어용은 text-to-speech-turbo-v2.5, 29개 언어 지원에는 voice ID와 language_code를 함께 text-to-speech-multilingual-v2를 사용합니다. 음성을 조정하려면 speed, stability, similarity_boost를 언급하세요. `model: text-to-speech-turbo-v2.5` 3. **워크벤치에서 오디오 받기** - 작업은 비동기로 실행됩니다. 워크벤치 에이전트가 MCP 도구를 통해 상태를 폴링하다가 completed가 되면 출력 오디오 URL과 청구된 글자 수를 대화에 게시합니다. `"status": "completed"` ## ElevenLabs text_to_speech 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. text-to-speech-turbo-v2.5 (저지연) 또는 text-to-speech-multilingual-v2 (29개 언어). | | `text` | `string` | 필수. 음성으로 변환할 텍스트. 최대 5000자. | | `voice` | `string` | ElevenLabs 음성 ID. multilingual-v2에서 필수. turbo-v2.5는 생략 시 기본 음성을 사용합니다. | | `speed` | `float` | 선택. 재생 속도 배율. 범위 0.7~1.2. | | `stability` | `float` | 선택. 음성 일관성. 범위 0.0~1.0. 낮은 값일수록 표현력이 높아집니다. | | `similarity_boost` | `float` | 선택. 음성 유사도 강도. 범위 0.0~1.0. | ## WorkBuddy에서 ElevenLabs란 무엇인가요? ElevenLabs는 자연스러운 음성 출력을 위한 대표적인 TTS API입니다. RunAPI MCP 서버를 통해 WorkBuddy 에이전트는 turbo-v2.5(영어 초저지연), multilingual-v2(29개 언어), dialogue-v3(다중 화자 대화), 음향 효과 생성, 음성-텍스트 변환, 보컬 분리 기능을 사용할 수 있습니다. stability와 similarity boost 슬라이더로 음성의 표현력과 일관성을 조정할 수 있으며, 워크벤치에서 자연어 프롬프트만으로 모두 제어 가능합니다. ## ElevenLabs 활용 사례 - **오디오북 및 팟캐스트 나레이션** - 일관된 캐릭터 음성으로 장문 텍스트를 음성 오디오로 변환합니다. 에이전트에게 내레이터 일관성을 위해 stability를 높게 유지하고, 긴 콘텐츠 전반에 걸쳐 similarity boost를 원본 프로필에 가깝게 설정하도록 요청하세요. - **다국어 영상 더빙** - multilingual-v2와 동일한 음성 프로필을 사용해 영상 콘텐츠를 29개 언어로 더빙하여, 원본 화자의 음성 특성을 유지한 현지화 버전을 제작합니다 — 워크벤치 대화에서 요청하기만 하면 됩니다. - **영상 및 게임 제작을 위한 음향 효과** - text_to_sound endpoint를 통해 텍스트 설명으로 커스텀 폴리 사운드, 앰비언트 오디오, 효과음을 생성하여, WorkBuddy 내에서 스톡 오디오 라이브러리 검색을 온디맨드 생성으로 대체합니다. ## ElevenLabs + WorkBuddy 자주 묻는 질문 ### WorkBuddy가 RunAPI를 통해 접근할 수 있는 ElevenLabs endpoint는 무엇인가요? 6가지입니다 — text_to_speech(turbo-v2.5 및 multilingual-v2), text_to_dialogue(다중 화자용 dialogue-v3), text_to_sound(음향 효과), speech_to_text(트랜스크립션), isolate_audio(보컬 추출). 모두 동일한 runapi MCP 서버와 RUNAPI_API_KEY로 사용할 수 있습니다. ### 가장 자연스러운 음성을 위한 stability 및 similarity 설정은 무엇인가요? stability 0.5, similarity_boost 0.75로 시작하세요. stability가 높을수록 음성이 일관되지만 표현력은 줄어듭니다. 오디오북에는 stability 0.6~0.8을 권장합니다. 대화형 콘텐츠에는 낮은 stability(0.3~0.5)가 자연스러운 변화를 줍니다. WorkBuddy 프롬프트에 이 값을 직접 명시하면 됩니다. ### turbo-v2.5와 multilingual-v2의 차이점은 무엇인가요? turbo-v2.5는 저지연 및 영어 우선 출력에 최적화되어 있으며 — 음성이 지정되지 않으면 기본 음성을 적용합니다. multilingual-v2는 29개 언어를 지원하며 명시적인 음성 ID와 선택적 language_code가 필요합니다. Turbo는 문자당 비용이 약 절반입니다. ### RunAPI에서 ElevenLabs 요금은 어떻게 청구되나요? TTS 및 대화 endpoint는 입력 텍스트의 글자 수당 청구됩니다. STT는 오디오 분당, 오디오 분리는 작업당 청구됩니다. 사용량은 WorkBuddy가 호출하는 다른 모든 모델과 동일한 RunAPI 잔액에 합산됩니다 — 현재 요금은 RunAPI 가격 페이지에서 확인하세요. ### WorkBuddy에서 ElevenLabs dialogue-v3로 다중 화자 오디오를 사용할 수 있나요? 네. 에이전트에게 model text-to-dialogue-v3로 text_to_dialogue 도구를 호출하도록 요청하고, 각 항목에 text와 voice ID가 있는 dialogue 배열을 전달하면 됩니다. 모든 화자의 전체 텍스트는 5000자 미만이어야 합니다. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [RunAPI에서 ElevenLabs 보기 →](https://runapi.ai/ko/models/elevenlabs.md) - 모든 ElevenLabs 변형, 가격 및 API 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 ElevenLabs를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 워크벤치 에이전트에게 텍스트를 읽어달라고 요청하세요 — 6가지 오디오 endpoint, 키 하나, 글자 수 기반 청구. [모델 보기 →](https://runapi.ai/ko/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "WorkBuddy용 RunAPI ElevenLabs", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에 ElevenLabs 텍스트 음성 변환, 음성 텍스트 변환, 오디오 분리 기능을 추가하세요. 키 1개, 29개 언어, 비동기 작업.", "url": "https://runapi.ai/ko/workbuddy-elevenlabs" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy가 RunAPI를 통해 접근할 수 있는 ElevenLabs endpoint는 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "6가지입니다 — text_to_speech(turbo-v2.5 및 multilingual-v2), text_to_dialogue(다중 화자용 dialogue-v3), text_to_sound(음향 효과), speech_to_text(트랜스크립션), isolate_audio(보컬 추출). 모두 동일한 runapi MCP 서버와 RUNAPI_API_KEY로 사용할 수 있습니다." } }, { "@type": "Question", "name": "가장 자연스러운 음성을 위한 stability 및 similarity 설정은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "stability 0.5, similarity_boost 0.75로 시작하세요. stability가 높을수록 음성이 일관되지만 표현력은 줄어듭니다. 오디오북에는 stability 0.6~0.8을 권장합니다. 대화형 콘텐츠에는 낮은 stability(0.3~0.5)가 자연스러운 변화를 줍니다. WorkBuddy 프롬프트에 이 값을 직접 명시하면 됩니다." } }, { "@type": "Question", "name": "turbo-v2.5와 multilingual-v2의 차이점은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "turbo-v2.5는 저지연 및 영어 우선 출력에 최적화되어 있으며 — 음성이 지정되지 않으면 기본 음성을 적용합니다. multilingual-v2는 29개 언어를 지원하며 명시적인 음성 ID와 선택적 language_code가 필요합니다. Turbo는 문자당 비용이 약 절반입니다." } }, { "@type": "Question", "name": "RunAPI에서 ElevenLabs 요금은 어떻게 청구되나요?", "acceptedAnswer": { "@type": "Answer", "text": "TTS 및 대화 endpoint는 입력 텍스트의 글자 수당 청구됩니다. STT는 오디오 분당, 오디오 분리는 작업당 청구됩니다. 사용량은 WorkBuddy가 호출하는 다른 모든 모델과 동일한 RunAPI 잔액에 합산됩니다 — 현재 요금은 RunAPI 가격 페이지에서 확인하세요." } }, { "@type": "Question", "name": "WorkBuddy에서 ElevenLabs dialogue-v3로 다중 화자 오디오를 사용할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. 에이전트에게 model text-to-dialogue-v3로 text_to_dialogue 도구를 호출하도록 요청하고, 각 항목에 text와 voice ID가 있는 dialogue 배열을 전달하면 됩니다. 모든 화자의 전체 텍스트는 5000자 미만이어야 합니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 ElevenLabs를 사용하는 방법", "description": "RunAPI를 WorkBuddy의 MCP 서버로 추가하고, 워크벤치 에이전트에게 ElevenLabs로 텍스트를 음성 변환하도록 요청하면 완성된 오디오 URL이 대화에 반환됩니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI를 MCP server로 추가하기", "text": "WorkBuddy를 실행하는 환경에 RUNAPI_API_KEY를 설정한 후, streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키는 runapi라는 MCP 서버를 등록하세요. TTS, STT, 대화, 음향 효과, 오디오 분리 등 ElevenLabs의 6가지 endpoint가 하나의 키로 호출 가능한 도구가 됩니다.", "url": "https://runapi.ai/ko/workbuddy-elevenlabs#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "에이전트에게 텍스트를 읽어달라고 요청하기", "text": "읽어줄 텍스트와 모델명을 WorkBuddy에 입력하세요 — 저지연 영어용은 text-to-speech-turbo-v2.5, 29개 언어 지원에는 voice ID와 language_code를 함께 text-to-speech-multilingual-v2를 사용합니다. 음성을 조정하려면 speed, stability, similarity_boost를 언급하세요.", "url": "https://runapi.ai/ko/workbuddy-elevenlabs#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "워크벤치에서 오디오 받기", "text": "작업은 비동기로 실행됩니다. 워크벤치 에이전트가 MCP 도구를 통해 상태를 폴링하다가 completed가 되면 출력 오디오 URL과 청구된 글자 수를 대화에 게시합니다.", "url": "https://runapi.ai/ko/workbuddy-elevenlabs#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy용 RunAPI ElevenLabs", "item": "https://runapi.ai/ko/workbuddy-elevenlabs" } ] } ] ```