# Smart Dubber: Multilingual Audio/Video Tool (using ElevenLabs) (`encelade-conseil/multilingual-dubber`) Actor

Smart Dubber is an AI-powered tool that translates and dubs audio/video into 29 languages using ElevenLabs/11Labs.
It preserves original voice tone and emotion, delivering high-quality, watermark-free outputs in formats like MP4, WAV, AAC or MP3 formats.
Pay as you go — per second, per language

- **URL**: https://apify.com/encelade-conseil/multilingual-dubber.md
- **Developed by:** [Encelade Conseil](https://apify.com/encelade-conseil) (community)
- **Categories:** Videos, AI, Automation
- **Features:** Full permissions
- **Stats:** 17 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$19.00 / 1,000 pay-per-second dubs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Smart Dubber – Actor (encelade-conseil/multilingual-dubber)

**Smart Dubber** is an AI-powered, pay-per-event (pay-as-you-go) Apify Actor that turns any public audio or video into **natural-sounding dubs** in **29 languages** using ElevenLabs (11Labs).\
It preserves original **tone** and **emotion**, delivering **high-quality**, **watermark-free** outputs in **MP4**, **WAV**, **AAC**, or **MP3** formats.
Current limitation: Dubbed files are limited to 30 minutes (1 800 s) per language.

***

### 🚀 Why Smart Dubber?

| **Advantage**             | **Details**                                                                 |
|---------------------------|------------------------------------------------------------------------------|
| All-in-one dubbing        | ElevenLabs neural voices preserve timing, emotion, and identity.            |
| Pay as you go             | Flexible billing: only pay for the seconds dubbed per language.             |
| Broad language coverage   | 29 ISO-coded languages supported: `en`, `ja`, `zh`, `de`, `hi`, `fr`, `ko`, `pt`, `it`, `es`, `id`, `nl`, `tr`, `fil`, `pl`, `sv`, `bg`, `ro`, `ar`, `cs`, `el`, `fi`, `hr`, `ms`, `sk`, `da`, `ta`, `uk`, `ru`. |
| Flexible audio input formats    | AAC, AIFF, FLAC, M4A, MP3, OGG, OPUS, WAV, WEBA, OGA |
| Flexible video input formats    | MP4, AVI, MKV, MOV, MPEG/MPG, WEBM, WMV, M4V, 3GPP |
| Flexible output formats   | AAC · WAV · MP3 · MP4                                                        |
| Zero watermark            | Output files are production-ready and downloadable directly from Apify.     |
| Closed-source protection  | Proprietary codebase; redistribution or forking is not permitted.           |

***

### 🔧 How it works

1. Submit a **public HTTPS URL**, a **Google Drive share link**, or a **Key-Value Store key URL**.
2. Choose one or more **target languages** and an **output format** (AAC, WAV, MP3 or MP4).
3. **Wait until the process is complete.**\
   It can take several minutes or more depending on the duration of the media and the number of languages to be dubbed.
4. When the run is complete, check the **Dataset** to download the result files for each language.

> ⚠️ Larger input files will result in longer processing times.

***

### 📥 Input Schema

**Example:**

{
"mediaUrl": "https://example.com/video.mp4",
"targetLanguages": \["fr", "es", "ja"],
"outputFormat": "MP3"
}

| **Field**         | **Required** | **Notes**                                                                 |
|-------------------|--------------|---------------------------------------------------------------------------|
| `mediaUrl`        | ✔︎           | HTTPS link, public-share link, or KV-Store record URL                           |
| `targetLanguages` | ✔︎           | Subset of the 29 supported ISO codes (see above)                          |
| `outputFormat`    | ✔︎           | `"AAC"`, `"WAV"`, `"MP3"` for audio, or `"MP4"` for video                 |

***

### 📚 Example Inputs

| **Scenario**             | **Sample JSON** |
|--------------------------|------------------|
| **Public URL**           | { "mediaUrl": "https://abc.example.com/video.mp4", "targetLanguages": \["it", "pt"], "outputFormat": "MP4" } |
| **Google Drive share**   | { "mediaUrl": "https://drive.google.com/file/d/1CJEv-8Q1czu65VDKctfSnq_leqIBdIoz/view?usp=drive_link", "targetLanguages": \["fr", "ja"], "outputFormat": "MP3" } |
| **KV-Store Record URL**         | { "mediaUrl": "https://api.apify.com/v2/key-value-stores/8A7OrQiQSZxRlal6G/records/audio.wav", "targetLanguages": \["de", "ru", "nl"], "outputFormat": "WAV" } |

***

### 📊 Output Dataset

| **Column**         | **Description**                                                 |
|--------------------|-----------------------------------------------------------------|
| `runId`            | Actor run ID                                                    |
| `mediaUrl`         | Original URL                                            |
| `targetLanguages`  | Languages requested                                             |
| `requestedFormat`  | Output format                                                   |
| `outputs`          | Array: `{ language, fileKey, url, format, duration, error }`    |
| `totalDuration`    | Total processed seconds                                         |
| `processedAt`      | ISO timestamp                                                   |
| `error`            | Global error message (if any)                                   |

> 💡 Use the **"Results"** or **"All fields"** view in the Apify Console to preview or download outputs.

***

### Limitations

- **Output length per language:** Every dubbed file generated by the actor is guaranteed to be **no longer than 30 minutes (1 800 seconds)** for each target language.
- **Maximum source size:** Media files **larger than 1 GB are rejected**.
- **Supported languages:** Only the ISO language codes listed in the input form are accepted; any other code will be ignored.
- **Network accessibility:** `mediaUrl` must be a direct HTTPS link or an Apify KV-store record URL. Links that require sign-in are not supported.
- **Resource usage:** The temporary disk space inside the container is roughly twice the RAM you allocate, so very large raw files may exhaust this space during processing.

***

### Concurrency & Queueing

- **Maximum parallel runs:** The actor will execute up to **5 runs in parallel**.\
  When more than five runs are triggered at the same time, the additional runs are automatically placed in a queue and start as soon as a slot frees up.

- **Impact on waiting time:** If many users launch the actor concurrently, your run may spend some time in the queue before it actually starts.\
  **Please be patient**—the queue processes runs in the order they were received.

***

### 🛠️ Troubleshooting

| **Issue**                     | **Possible Fix**                                                                   |
|-------------------------------|-------------------------------------------------------------------------------------|
| Dataset row has error         | Check that your `mediaUrl` is publicly accessible and in a supported format.       |
| File missing for one language | That language may have failed to dub — check the `outputs[].error` field.         |
| Run seems slow                | Large input files or peak-time usage may cause delays — consider splitting media.  |

# Actor input Schema

## `mediaUrl` (type: `string`):

HTTPS URL, public-share link, or KV-store record URL

## `targetLanguages` (type: `array`):

Select one or more ISO codes of the target languages

## `outputFormat` (type: `string`):

Desired output format

## Actor input object example

```json
{}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("encelade-conseil/multilingual-dubber").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("encelade-conseil/multilingual-dubber").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call encelade-conseil/multilingual-dubber --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,encelade-conseil/multilingual-dubber"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/udD6gdSFidsi0EpEa/builds/ytoBj21FL2mdcecKm/openapi.json
