elevenlabs-tts

1# ElevenLabs Text-to-Speech
2 
3Generate high-quality speech audio from text using the ElevenLabs API.
4 
5## Authentication
6 
7The API key is available as environment variable:
8```bash
9ELEVENLABS_API_KEY
10```
11 
12Include in request header:
13```
14xi-api-key: $ELEVENLABS_API_KEY
15```
16 
17## API Endpoints
18 
19### Text-to-Speech
20```
21POST https://api.elevenlabs.io/v1/text-to-speech/{voice_id}
22```
23 
24**Request Body:**
25```json
26{
27  "text": "Your text here",
28  "model_id": "eleven_turbo_v2_5",
29  "voice_settings": {
30    "stability": 0.5,
31    "similarity_boost": 0.5
32  }
33}
34```
35 
36**Response:** Audio bytes (mp3 format by default)
37 
38## Popular Voice IDs
39 
40- `21m00Tcm4TlvDq8ikWAM` - Rachel (female, calm)
41- `EXAVITQu4vr4xnSDxMaL` - Bella (female, soft)
42- `ErXwobaYiN019PkySvjV` - Antoni (male, warm)
43- `TxGEqnHWrfWFTfGW9XjX` - Josh (male, deep)
44 
45## Python Example
46 
47```python
48import os
49import requests
50 
51ELEVENLABS_API_KEY = os.environ.get("ELEVENLABS_API_KEY")
52VOICE_ID = "21m00Tcm4TlvDq8ikWAM"  # Rachel
53 
54def text_to_speech(text, output_path):
55    url = f"https://api.elevenlabs.io/v1/text-to-speech/{VOICE_ID}"
56 
57    headers = {
58        "xi-api-key": ELEVENLABS_API_KEY,
59        "Content-Type": "application/json"
60    }
61 
62    data = {
63        "text": text,
64        "model_id": "eleven_turbo_v2_5",
65        "voice_settings": {
66            "stability": 0.5,
67            "similarity_boost": 0.75
68        }
69    }
70 
71    response = requests.post(url, json=data, headers=headers)
72 
73    if response.status_code == 200:
74…