---
title: "OpenClaw에서 RunAPI로 ElevenLabs 사용하기 — TTS & 오디오 API 가이드"
url: "https://runapi.ai/ko/openclaw-elevenlabs.md"
canonical: "https://runapi.ai/ko/openclaw-elevenlabs"
locale: "ko"
model: "elevenlabs"
---

# OpenClaw에서 ElevenLabs를 사용하세요.

ElevenLabs는 RunAPI를 통해 6개의 오디오 엔드포인트를 제공합니다 — 초저지연의 turbo-v2.5 TTS, 29개 언어를 지원하는 multilingual-v2, 다중 화자 대화용 dialogue-v3, 효과음, 음성 인식 전사, 보컬 분리. OpenClaw 에이전트는 채팅에 사용하는 것과 동일한 RunAPI key로 모두 호출합니다.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/elevenlabs/text_to_speech \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-to-speech-turbo-v2.5",
    "text": "Welcome to RunAPI. This audio was generated by ElevenLabs turbo v2.5.",
    "speed": 1.0,
    "stability": 0.5,
    "similarity_boost": 0.75
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "text-to-speech-turbo-v2.5"
}

```

## How it works

1. **RunAPI 설정** — 환경 변수에 RUNAPI_API_KEY를 설정하세요. 이미 OpenClaw에서 채팅용으로 RunAPI를 설정했다면 동일한 key로 모든 ElevenLabs 엔드포인트 — TTS, STT, 대화, 효과음, 오디오 분리 — 를 모두 사용할 수 있습니다.
2. **text_to_speech 호출** — model을 text-to-speech-turbo-v2.5로 설정하고, 변환할 텍스트와 선택적으로 voice, speed, stability 파라미터를 포함하여 text_to_speech 엔드포인트로 POST 요청을 보내세요. 다국어 출력에는 voice와 language_code를 사용하여 text-to-speech-multilingual-v2를 사용하세요.
3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 오디오 URL을 읽으세요.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |
| `style` | `float` | 선택 사항. 스타일 과장. 범위 0.0~1.0. |
| `language_code` | `string` | 선택 사항. multilingual-v2의 목표 언어 (예: en, es, ja). |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신할 웹훅 URL. |

## FAQ

### OpenClaw에서 사용할 수 있는 ElevenLabs 엔드포인트는 무엇인가요?

RunAPI는 6개의 ElevenLabs 엔드포인트를 제공합니다: text_to_speech(turbo-v2.5 및 multilingual-v2), text_to_dialogue(다중 화자용 dialogue-v3), text_to_sound(효과음), speech_to_text(전사), isolate_audio(보컬 추출). 모두 동일한 RUNAPI_API_KEY를 공유합니다.

### turbo-v2.5와 multilingual-v2의 차이점은 무엇인가요?

turbo-v2.5는 저지연과 영어 우선 출력에 최적화되어 있으며 음성이 지정되지 않으면 기본 음성을 적용합니다. multilingual-v2는 29개 언어를 지원하며 명시적인 voice ID와 선택적 language_code가 필요합니다. turbo는 글자당 비용이 약 절반입니다.

### RunAPI에서 ElevenLabs TTS는 동기식인가요, 비동기식인가요?

비동기식입니다. 생성 엔드포인트는 즉시 task_id를 반환합니다. 작업 상태 엔드포인트를 폴링하거나 callback_url을 제공하여 오디오 파일이 준비되면 웹훅을 받으세요.

### RunAPI에서 ElevenLabs는 어떻게 청구되나요?

음성 합성 및 대화 엔드포인트는 입력 텍스트의 글자 수 기준으로 청구됩니다. 음성 인식은 오디오 분 단위로 청구됩니다. 오디오 분리는 작업당 청구됩니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요.

### OpenClaw에서 다중 화자 오디오를 위해 ElevenLabs dialogue-v3를 사용할 수 있나요?

네. model을 text-to-dialogue-v3로 설정하여 text_to_dialogue 엔드포인트를 호출하세요. 각 항목에 text와 voice ID가 있는 dialogue 배열을 전달하세요. 모든 화자의 총 텍스트는 5000자 미만이어야 합니다.


## Links

- [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw)
- [RunAPI의 ElevenLabs →](https://runapi.ai/ko/models/elevenlabs)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)