PHPackages                             digitalcorehub/laravel-elevenlabs - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. digitalcorehub/laravel-elevenlabs

ActiveLibrary[Image & Media](/categories/media)

digitalcorehub/laravel-elevenlabs
=================================

Laravel package for ElevenLabs Text-to-Speech API integration

0.4.0(5mo ago)1141MITPHPPHP ^8.2CI passing

Since Nov 14Pushed 2mo agoCompare

[ Source](https://github.com/DigitalCoreHub/laravel-elevenlabs)[ Packagist](https://packagist.org/packages/digitalcorehub/laravel-elevenlabs)[ RSS](/packages/digitalcorehub-laravel-elevenlabs/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (6)Versions (8)Used By (0)

Laravel ElevenLabs
==================

[](#laravel-elevenlabs)

[![Latest Version](https://camo.githubusercontent.com/b54ff1b4f57bcd5f7ca9751b028b61430984b464d9a67e1de733aa90085b7a8e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6469676974616c636f72656875622f6c61726176656c2d656c6576656e6c6162732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/digitalcorehub/laravel-elevenlabs)[![Total Downloads](https://camo.githubusercontent.com/33da07165e85597e4680953900386bbc8fed86638855a6c32cc470c158956479/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6469676974616c636f72656875622f6c61726176656c2d656c6576656e6c6162732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/digitalcorehub/laravel-elevenlabs)[![License](https://camo.githubusercontent.com/fbfc68088067c46d5f58c0cdab842cd10241a91d9a459cc0d8f170324ba1e396/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6469676974616c636f72656875622f6c61726176656c2d656c6576656e6c6162732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/digitalcorehub/laravel-elevenlabs)

A modern, fluent Laravel package for integrating with the ElevenLabs Text-to-Speech (TTS) and Speech-to-Text (STT) APIs. This package provides a clean and intuitive interface for converting text to speech and transcribing audio in your Laravel applications.

**📖 [Türkçe Dokümantasyon](README.tr.md)**

📋 Requirements
--------------

[](#-requirements)

- PHP 8.2 or higher
- Laravel 12.0 or higher

🚀 Installation
--------------

[](#-installation)

You can install the package via Composer:

```
composer require digitalcorehub/laravel-elevenlabs
```

⚙️ Configuration
----------------

[](#️-configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=elevenlabs-config
```

This will create a `config/elevenlabs.php` file in your config directory.

### Environment Variables

[](#environment-variables)

Add the following to your `.env` file:

```
ELEVENLABS_API_KEY=your_api_key_here
ELEVENLABS_DEFAULT_VOICE=nova
ELEVENLABS_DEFAULT_FORMAT=mp3_44100_128
ELEVENLABS_BASE_URL=https://api.elevenlabs.io/v1
ELEVENLABS_TIMEOUT=30
```

### Configuration Options

[](#configuration-options)

- **api\_key**: Your ElevenLabs API key (required)
- **base\_url**: The base URL for the ElevenLabs API (default: `https://api.elevenlabs.io/v1`)
- **default\_voice**: The default voice ID to use (default: `nova`)
- **default\_format**: The default audio format (default: `mp3_44100_128`)
- **timeout**: Request timeout in seconds (default: `30`)

📖 Usage
-------

[](#-usage)

Text-to-Speech (TTS)
--------------------

[](#text-to-speech-tts)

### Basic TTS Usage

[](#basic-tts-usage)

The package provides a fluent API for generating text-to-speech audio:

```
use DigitalCoreHub\LaravelElevenLabs\Facades\ElevenLabs;

// Generate audio and save to storage
ElevenLabs::tts()
    ->voice('nova')
    ->text('Hello from Laravel')
    ->format('mp3_44100_128')
    ->save('voices/hello.mp3');
```

### Using Defaults

[](#using-defaults)

If you've configured default voice and format, you can omit them:

```
ElevenLabs::tts()
    ->text('Hello from Laravel')
    ->save('voices/hello.mp3');
```

### Getting Audio File Object

[](#getting-audio-file-object)

Instead of saving directly, you can get an `AudioFile` object:

```
$audioFile = ElevenLabs::tts()
    ->voice('nova')
    ->text('Hello from Laravel')
    ->format('mp3_44100_128')
    ->generate();

// Access the content
$content = $audioFile->getContent();

// Get the format
$format = $audioFile->getFormat();

// Save to a different location
$audioFile->save('custom/path/audio.mp3', 's3');
```

### Custom Voice Settings

[](#custom-voice-settings)

You can customize voice settings (stability, similarity\_boost, etc.):

```
ElevenLabs::tts()
    ->voice('nova')
    ->text('Hello from Laravel')
    ->voiceSettings([
        'stability' => 0.7,
        'similarity_boost' => 0.8,
    ])
    ->save('voices/hello.mp3');
```

### Available Voices

[](#available-voices)

Common voice IDs include:

- `nova`
- `rachel`
- `domi`
- `bella`
- `antoni`
- `elli`
- `josh`
- `arnold`
- `adam`
- `sam`

### Supported Formats

[](#supported-formats)

- `mp3_44100_128`
- `mp3_44100_192`
- `mp3_44100_256`
- `pcm_16000`
- `pcm_22050`
- `pcm_24000`
- `pcm_44100`
- `ulaw_8000`

### Using Different Storage Disks

[](#using-different-storage-disks)

```
ElevenLabs::tts()
    ->text('Hello from Laravel')
    ->save('voices/hello.mp3', 's3'); // Save to S3
```

Speech-to-Text (STT)
--------------------

[](#speech-to-text-stt)

### Basic STT Usage

[](#basic-stt-usage)

The package provides a fluent API for transcribing audio files:

```
use DigitalCoreHub\LaravelElevenLabs\Facades\ElevenLabs;

// Transcribe an audio file
$result = ElevenLabs::stt()
    ->file('audio.wav')
    ->transcribe();

// Access the transcribed text
echo $result->text;

// Access words array (if available)
$words = $result->words;

// Access confidence score (if available)
$confidence = $result->confidence;
```

### Using Storage Disks

[](#using-storage-disks)

You can transcribe files from any Laravel storage disk:

```
// From local storage
$result = ElevenLabs::stt()
    ->file('audio/recording.wav', 'local')
    ->transcribe();

// From S3
$result = ElevenLabs::stt()
    ->file('audio/recording.wav', 's3')
    ->transcribe();
```

### Using Absolute File Paths

[](#using-absolute-file-paths)

You can also use absolute file paths:

```
$result = ElevenLabs::stt()
    ->file('/path/to/audio.wav')
    ->transcribe();
```

### Custom Model

[](#custom-model)

You can specify a custom model for transcription:

```
$result = ElevenLabs::stt()
    ->file('audio.wav')
    ->model('eleven_multilingual_v2')
    ->transcribe();
```

### TranscriptionResult Data Model

[](#transcriptionresult-data-model)

The `transcribe()` method returns a `TranscriptionResult` object with the following properties:

- **text** (string): The transcribed text
- **words** (array|null): Array of word objects with timing information (if available)
- **confidence** (float|null): Confidence score of the transcription (if available)

Example:

```
$result = ElevenLabs::stt()
    ->file('audio.wav')
    ->transcribe();

// Get text
$text = $result->getText();

// Get words array
$words = $result->getWords();
// [
//     ['word' => 'Hello', 'start' => 0.0, 'end' => 0.5],
//     ['word' => 'world', 'start' => 0.5, 'end' => 1.0],
// ]

// Get confidence
$confidence = $result->getConfidence(); // 0.95

// Convert to array
$array = $result->toArray();
```

### Supported Audio Formats

[](#supported-audio-formats)

The STT API supports various audio formats:

- WAV
- MP3
- M4A
- FLAC
- And other common audio formats

Voice Management
----------------

[](#voice-management)

### List All Voices

[](#list-all-voices)

Get a collection of all available voices:

```
$voices = ElevenLabs::voices()->list();

// Iterate through voices
foreach ($voices as $voice) {
    echo $voice->name;
    echo $voice->voiceId;
}

// Find voice by ID
$voice = $voices->findById('voice-id');

// Find voices by name
$found = $voices->findByName('Nova');
```

### Get Single Voice

[](#get-single-voice)

Get detailed information about a specific voice:

```
$voice = ElevenLabs::voices()->get('voice-id');

// Access voice properties
echo $voice->name;
echo $voice->description;
echo $voice->category;
$settings = $voice->settings;
```

### Create Custom Voice

[](#create-custom-voice)

Create a custom voice using audio files:

```
// Using absolute file paths
$voice = ElevenLabs::voices()
    ->name('My Custom Voice')
    ->files(['/path/to/voice1.wav', '/path/to/voice2.wav'])
    ->description('A custom voice for my project')
    ->labels(['accent' => 'british', 'age' => 'young'])
    ->create();

// Using storage disk files
$voice = ElevenLabs::voices()
    ->name('My Custom Voice')
    ->files([
        ['path' => 'voices/voice1.wav', 'disk' => 'local'],
        ['path' => 'voices/voice2.wav', 'disk' => 's3'],
    ])
    ->create();
```

### Delete Voice

[](#delete-voice)

Delete a voice:

```
$deleted = ElevenLabs::voices()->delete('voice-id');
```

### Sync Voices

[](#sync-voices)

Sync voices from the API (useful for caching or updating local database):

```
// Direct sync
$voices = ElevenLabs::voices()->sync();

// Using queue job
use DigitalCoreHub\LaravelElevenLabs\Jobs\SyncVoicesJob;

SyncVoicesJob::dispatch();
```

### Voice Events

[](#voice-events)

The package dispatches events when voices are created or synced:

```
use DigitalCoreHub\LaravelElevenLabs\Events\VoiceCreated;
use DigitalCoreHub\LaravelElevenLabs\Events\VoiceSynced;

// Listen to voice created event
Event::listen(VoiceCreated::class, function (VoiceCreated $event) {
    $voice = $event->voice;
    // Handle voice creation
});

// Listen to voice synced event
Event::listen(VoiceSynced::class, function (VoiceSynced $event) {
    $voices = $event->voices;
    // Handle voice sync
});
```

### Voice Data Model

[](#voice-data-model)

The `Voice` class provides access to all voice properties:

```
$voice = ElevenLabs::voices()->get('voice-id');

// Properties
$voice->voiceId;
$voice->name;
$voice->description;
$voice->category;
$voice->samples;
$voice->settings;
$voice->labels;
$voice->previewUrl;

// Convert to array
$array = $voice->toArray();
```

### VoiceCollection

[](#voicecollection)

The `VoiceCollection` extends Laravel's Collection with additional methods:

```
$voices = ElevenLabs::voices()->list();

// Collection methods
$voices->count();
$voices->first();
$voices->filter(fn ($voice) => $voice->category === 'premade');

// Custom methods
$voice = $voices->findById('voice-id');
$found = $voices->findByName('Nova');
```

Dubbing (Auto Dubbing Engine)
-----------------------------

[](#dubbing-auto-dubbing-engine)

### Basic Dubbing Usage

[](#basic-dubbing-usage)

Dub videos or audio files to different languages:

```
// Run dubbing synchronously
$result = ElevenLabs::dubbing()
    ->source('input.mp4')
    ->target('tr')
    ->run();

// Check status
echo $result->status; // processing, completed, failed
echo $result->jobId;
echo $result->outputUrl; // Available when completed
```

### Using Storage Disks

[](#using-storage-disks-1)

You can use files from any Laravel storage disk:

```
// From local storage
$result = ElevenLabs::dubbing()
    ->source('videos/input.mp4', 'local')
    ->target('en')
    ->run();

// From S3
$result = ElevenLabs::dubbing()
    ->source('videos/input.mp4', 's3')
    ->target('es')
    ->run();
```

### Using Absolute File Paths

[](#using-absolute-file-paths-1)

You can also use absolute file paths:

```
$result = ElevenLabs::dubbing()
    ->source('/path/to/video.mp4')
    ->target('fr')
    ->run();
```

### Dubbing Options

[](#dubbing-options)

You can pass additional options:

```
$result = ElevenLabs::dubbing()
    ->source('input.mp4')
    ->target('tr')
    ->options([
        'num_speakers' => 2,
        'watermark' => false,
    ])
    ->run();
```

### Background Dubbing with Queue

[](#background-dubbing-with-queue)

For long-running dubbing jobs, use the queue:

```
// Dispatch to queue
ElevenLabs::dubbing()
    ->source('input.mp4')
    ->target('tr')
    ->dispatch();

// Or with parameters
ElevenLabs::dubbing()->dispatch('input.mp4', 'tr');
```

Or create a dedicated job:

```
use DigitalCoreHub\LaravelElevenLabs\Jobs\RunDubbingJob;

RunDubbingJob::dispatch('input.mp4', null, 'tr', ['watermark' => false]);
```

### Check Dubbing Status

[](#check-dubbing-status)

Check the status of a dubbing job:

```
$result = ElevenLabs::dubbing()->status('job-id');

if ($result->isCompleted()) {
    // Download the dubbed file
    $outputUrl = $result->outputUrl;
}

if ($result->isInProgress()) {
    // Job is still processing
}

if ($result->isFailed()) {
    // Job failed
}
```

### Dubbing Events

[](#dubbing-events)

The package dispatches events when dubbing completes:

```
use DigitalCoreHub\LaravelElevenLabs\Events\DubbingCompleted;

Event::listen(DubbingCompleted::class, function (DubbingCompleted $event) {
    $result = $event->result;

    if ($result->isCompleted()) {
        // Download or process the dubbed file
        $outputUrl = $result->outputUrl;
    }
});
```

### DubbingResult Data Model

[](#dubbingresult-data-model)

The `run()` and `status()` methods return a `DubbingResult` object:

```
$result = ElevenLabs::dubbing()
    ->source('input.mp4')
    ->target('tr')
    ->run();

// Properties
$result->status;      // processing, completed, failed
$result->jobId;       // Job ID for status checking
$result->outputUrl;   // URL to download dubbed file (when completed)
$result->duration;     // Duration in seconds (when completed)
$result->metadata;     // Additional metadata

// Status checks
$result->isCompleted();
$result->isInProgress();
$result->isFailed();

// Convert to array
$array = $result->toArray();
```

### Supported Languages

[](#supported-languages)

Common target language codes:

- `en` - English
- `tr` - Turkish
- `es` - Spanish
- `fr` - French
- `de` - German
- `it` - Italian
- `pt` - Portuguese
- And more...

🔄 Queue Usage
-------------

[](#-queue-usage)

You can easily queue TTS generation jobs:

```
use Illuminate\Support\Facades\Queue;

Queue::push(function () {
    ElevenLabs::tts()
        ->text('This will be processed in the background')
        ->save('voices/queued.mp3');
});
```

Or create a dedicated job:

```
namespace App\Jobs;

use DigitalCoreHub\LaravelElevenLabs\Facades\ElevenLabs;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class GenerateTtsJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public function __construct(
        public string $text,
        public string $outputPath,
        public ?string $voice = null
    ) {}

    public function handle(): void
    {
        $tts = ElevenLabs::tts()->text($this->text);

        if ($this->voice) {
            $tts->voice($this->voice);
        }

        $tts->save($this->outputPath);
    }
}
```

🧪 Testing
---------

[](#-testing)

The package includes fake providers for testing purposes.

### Testing TTS

[](#testing-tts)

```
use DigitalCoreHub\LaravelElevenLabs\Tests\Fake\FakeTtsProvider;
use DigitalCoreHub\LaravelElevenLabs\Http\Endpoints\TtsEndpoint;
use DigitalCoreHub\LaravelElevenLabs\Http\Clients\ElevenLabsClient;

// In your test setup
$this->app->singleton(TtsEndpoint::class, function ($app) {
    $client = $app->make(ElevenLabsClient::class);
    return new FakeTtsProvider($client);
});
```

### Testing STT

[](#testing-stt)

```
use DigitalCoreHub\LaravelElevenLabs\Tests\Fake\FakeSttProvider;
use DigitalCoreHub\LaravelElevenLabs\Http\Endpoints\SttEndpoint;
use DigitalCoreHub\LaravelElevenLabs\Http\Clients\ElevenLabsClient;

// In your test setup
$this->app->singleton(SttEndpoint::class, function ($app) {
    $client = $app->make(ElevenLabsClient::class);
    return new FakeSttProvider($client);
});
```

🛣️ Roadmap
----------

[](#️-roadmap)

### v0.1 - Text-to-Speech (TTS) ✅

[](#v01---text-to-speech-tts-)

- Fluent API for TTS generation
- Support for multiple audio formats
- Custom voice settings
- Storage integration
- Configuration management
- Comprehensive test coverage

### v0.2 - Speech-to-Text (STT) ✅

[](#v02---speech-to-text-stt-)

- Fluent API for STT transcription
- File upload support (local and storage disks)
- TranscriptionResult data model
- Support for multiple audio formats
- Custom model selection
- Words array and confidence scores
- Comprehensive test coverage

### v0.3 - Voice Management ✅

[](#v03---voice-management-)

- Fluent API for voice management
- List and get voice operations
- Custom voice creation with file uploads
- Voice deletion support
- Voice sync functionality
- Queue support with SyncVoicesJob
- Event system (VoiceCreated, VoiceSynced)
- Voice and VoiceCollection data models
- Storage disk integration
- Comprehensive test coverage

### v0.4 - Dubbing (Auto Dubbing Engine) ✅

[](#v04---dubbing-auto-dubbing-engine-)

- Fluent API for video/audio dubbing
- Source file support (local and storage disks)
- Target language selection
- Dubbing options support
- Job status checking
- Queue support with RunDubbingJob
- Event system (DubbingCompleted)
- DubbingResult data model
- Status checking methods (isCompleted, isInProgress, isFailed)
- Storage disk integration
- Comprehensive test coverage

📝 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Support
---------

[](#-support)

For issues, questions, or contributions, please open an issue on GitHub.

---

Made with ❤️ by [DigitalCoreHub](https://digitalcorehub.com)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance78

Regular maintenance activity

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 79.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

179d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/32592602?v=4)[Batuhan Haymana](/maintainers/1batu)[@1batu](https://github.com/1batu)

---

Top Contributors

[![1batu](https://avatars.githubusercontent.com/u/32592602?v=4)](https://github.com/1batu "1batu (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (2 commits)")

---

Tags

aiai-integrationaudioaudio-aiaudio-effectsdubbingelevenlabselevenlabs-apilaravellaravel-audiolaravel-frameworklaravel-packageslaravel12phpspeech-to-textstttext-to-speechttsvoicevoice-managementlaravelaudiovoiceelevenlabstext-to-speechtts

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/digitalcorehub-laravel-elevenlabs/health.svg)

```
[![Health](https://phpackages.com/badges/digitalcorehub-laravel-elevenlabs/health.svg)](https://phpackages.com/packages/digitalcorehub-laravel-elevenlabs)
```

###  Alternatives

[intervention/image-laravel

Laravel Integration of Intervention Image

1496.5M102](/packages/intervention-image-laravel)[ralphjsmit/laravel-glide

Auto-magically generate responsive images from static image files.

4719.6k5](/packages/ralphjsmit-laravel-glide)[erlandmuchasaj/laravel-gzip

Gzip your responses.

40129.3k2](/packages/erlandmuchasaj-laravel-gzip)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[synchro/laravel-medialibrary-audio

Audio file thumbnail generator for Spatie's Laravel Media Library

292.4k](/packages/synchro-laravel-medialibrary-audio)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)