Introduction

Installation

You can interact with the TTSLab API through HTTP requests from any language. For Python, we recommend using the requests library with a virtual environment.

Python Setup

Create a virtual environment and install requests:

# Create virtual environment
python -m venv ttslab-env

# Activate virtual environment (Windows)
ttslab-env\Scripts\activate

# Activate virtual environment (macOS/Linux)
source ttslab-env/bin/activate

# Install requests
pip install requests python-dotenv

Node.js Setup

For Node.js projects, install the required packages:

npm install node-fetch dotenv

API Base URL

All API requests should be made to:

https://api.elevenlabs8.com

Authentication

All API requests require authentication using the X-API-KEY header:

X-API-KEY: your_api_key_here

Available Endpoints

Endpoints

• Text-to-Speech: POST /v1/text-to-speech - Convert text to speech
• Models: GET /api/tts/models/ - List available models
• Voices: GET /api/tts/voices/ - List available voices
• History: GET /api/tts/elevenlabs-histories/ - Get generation history

Voice Management

• Create Voice: POST /api/tts/voices/ - Create a new voice
• Get Voice: GET /api/tts/voices/{voice_id} - Get voice details

User Management

• User Profile: GET /api/users/me/ - Get user profile

Response Format

All API responses are returned in JSON format with the following structure:

{
  "success": true,
  "data": {
    // Response data here
  },
  "message": "Success message"
}

Error Handling

Errors are returned with appropriate HTTP status codes and error messages:

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key provided"
  }
}