Introduction

Installation

You can interact with the API through HTTP or Websocket requests from any language, via our official Python bindings or our official Node.js libraries.

To install the official Python bindings, run the following command:

$
pip install elevenlabs

To install the official Node.js library, run the following command in your Node.js project directory:

$
npm install @elevenlabs/elevenlabs-js

Tracking generation costs

Access response headers to retrieve generation metadata including character costs.

1
from elevenlabs.client import ElevenLabs
2
3
client = ElevenLabs(api_key="your_api_key")
4
5
# Get raw response with headers
6
response = client.text_to_speech.with_raw_response.convert(
7
    text="Hello, world!",
8
    voice_id="voice_id"
9
)
10
11
# Access character cost from headers
12
char_cost = response.headers.get("x-character-count")
13
request_id = response.headers.get("request-id")
14
audio_data = response.data

The raw response provides access to:

• Response data - The actual API response content
• HTTP headers - Metadata including character costs and request IDs