# TTS (Text-to-Speech) (/docs/voice-agent/tts)

## TTS (Text-to-Speech)

Pipeline 모드에서 텍스트를 음성으로 변환하는 빌트인 Provider입니다.

아래 제공자들은 모두 **검증 전** 상태입니다. 검증 상태는 [제공자 호환성](/docs/voice-agent/providers) 문서에서 확인하세요.

## ElevenLabsTTS

ElevenLabs WebSocket 기반 저지연 음성 합성입니다. SDK가 출력 오디오를 자동으로 G.711 μ-law 8kHz로 변환합니다.

```python
from clawops.agent.pipeline import ElevenLabsTTS

tts = ElevenLabsTTS(
    voice_id="EXAVITQu4vr4xnSDxMaL",
    model="eleven_flash_v2_5",
    stability=0.5,
    similarity_boost=0.75,
)
```

### 파라미터

| 파라미터 | 타입 | 기본값 | 설명 |
|----------|------|--------|------|
| `api_key` | `str \| None` | `None` | ElevenLabs API 키. 미지정 시 `ELEVENLABS_API_KEY` 환경변수 사용 |
| `voice_id` | `str` | `"EXAVITQu4vr4xnSDxMaL"` | 음성 ID |
| `model` | `str` | `"eleven_flash_v2_5"` | TTS 모델 |
| `output_format` | `str` | `"pcm_24000"` | 출력 오디오 포맷 |
| `stability` | `float` | `0.5` | 음성 안정성 (0.0~1.0). 낮을수록 표현력 증가 |
| `similarity_boost` | `float` | `0.75` | 원본 음성 유사도 (0.0~1.0) |
| `language_code` | `str` | `"ko"` | 합성 언어 코드 |