# VoiceClonerTTS (`anyscrap/voiceclonertts`) Actor

High-quality text-to-speech API with voice cloning.

- **URL**: https://apify.com/anyscrap/voiceclonertts.md
- **Developed by:** [Anyscrap](https://apify.com/anyscrap) (community)
- **Categories:** AI, Other, Social media
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.005 / actor start

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Ultra Quality TTS – Voice Cloning API

High-quality text-to-speech API with voice cloning. Send your text and a short reference audio URL (or upload), get natural speech in the cloned voice. No code required—run from Apify Console or call the Apify API. Output is stored in the run's key-value store and returned in the dataset.

### Features

- **Voice cloning** – Clone any voice from a ~3 second reference audio sample (URL or file upload).
- **Ultra quality TTS** – Natural, realistic speech output.
- **Simple API** – Input: text (max 2000 characters) + reference audio URL. Output: audio file (WAV) in key-value store (e.g. `audio-<uuid>.wav`).
- **No code** – Use the Apify Console form, or trigger via API, webhooks, [Make](https://apify.com/integrations), [Zapier](https://apify.com/integrations), or any HTTP client.
- **Flexible input** – Support for S3 URLs, public URLs, or Apify file upload for reference audio.

### Quick start

1. **Input** – Provide `text` (required) and `reference_audio` (required: URL or upload).
2. **Run** – Start the Actor from [Apify Console](https://console.apify.com) or via the [Apify API](https://docs.apify.com/api/v2#reference/actors/run-actor/run-actor).
3. **Output** – In the run's dataset you get `success` and `outputKey` (e.g. `audio-<uuid>.wav`). Download the audio from the run's key-value store using that key.

### Input / Parameters

| Parameter         | Required | Description |
|-------------------|----------|-------------|
| `text`            | Yes      | Text to synthesize into speech. **Maximum 2000 characters.** |
| `reference_audio` | Yes      | URL of the reference audio (e.g. S3) or upload a file. About 3 seconds of clean speech recommended. |

### Output

Each run writes one item to the default dataset and one file to the default key-value store:

- **Dataset** – `{ "success": true, "outputKey": "audio-<uuid>.wav" }` (or `success: false` and `error` on failure).
- **Key-value store** – WAV audio file under the key `outputKey` (e.g. `audio-f47ac10b-58cc-4372-a567-0e02b2c3d479.wav`). Use the [Apify Key-Value Store API](https://docs.apify.com/api/v2#reference/key-value-stores/record/get-record) or the run's Storage tab to download the file.

### Example: Run via API

**Option 1 – Run and get dataset items in one call** (waits for completion, returns `outputKey` in the response):

```bash
curl -X POST "https://api.apify.com/v2/acts/lucymakeit~VoiceClonerTTS/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to our product. This is an example of voice cloning.",
    "reference_audio": "https://your-bucket.s3.region.amazonaws.com/path/to/reference.mp3"
  }'
````

Response is an array of dataset items, e.g. `[{ "success": true, "outputKey": "audio-<uuid>.wav" }]`. Use `outputKey` to download the audio from the run's key-value store.

**Option 2 – Start run, then fetch result** (async: start run, poll or wait, then get dataset/key-value store):

```bash
## Start the run
curl -X POST "https://api.apify.com/v2/acts/lucymakeit~VoiceClonerTTS/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to our product. This is an example of voice cloning.",
    "reference_audio": "https://your-bucket.s3.region.amazonaws.com/path/to/reference.mp3"
  }'
```

Response includes `data.id` (run ID). Then get the output:

```bash
## Get dataset items (contains outputKey)
curl "https://api.apify.com/v2/actor-runs/RUN_ID/dataset/items?token=YOUR_APIFY_TOKEN"

## Download the audio (use defaultKeyValueStoreId from run details and outputKey from dataset)
curl "https://api.apify.com/v2/key-value-stores/STORE_ID/records/OUTPUT_KEY?token=YOUR_APIFY_TOKEN" -o output.wav
```

### Example: Input/Output

**Input (JSON):**

```json
{
  "text": "Le contenu de ce site est le fruit du travail de journalistes qui s'engagent chaque jour pour vous apporter une information locale de qualité.",
  "reference_audio": "https://your-bucket.s3.eu-west-1.amazonaws.com/samples/voice-sample.mp3"
}
```

**Output (dataset item):**

```json
{
  "success": true,
  "outputKey": "audio-a1b2c3d4-e5f6-7890-abcd-ef1234567890.wav"
}
```

The audio file is in the run's key-value store under `outputKey`.

### Use cases

- **Audio content** – Generate voiceovers for podcasts, videos, or social media in a consistent cloned voice.
- **Dubbing** – Produce dubbed speech from text while keeping a target voice character.
- **Accessibility** – Turn articles or scripts into natural speech with a chosen or cloned voice.
- **IVR & voicebots** – Create custom TTS for hotlines or conversational AI without generic synthetic voices.
- **App personalization** – Let users clone their voice for personalized assistants or messages.

### FAQ

**What audio format is supported for the reference?**\
URLs to common formats (e.g. MP3, WAV) work. About 3 seconds of clear speech without music or noise gives the best results.

**Is there a maximum text length?**\
Yes. The text must not exceed **2000 characters**. For longer content, split it into segments and run the Actor multiple times.

**What is the output audio format?**\
The file is stored as WAV under a key like `audio-<uuid>.wav`. Use the key-value store URL to download it.

**Can I use S3 URLs for reference\_audio?**\
Yes. Use a public URL or a pre-signed S3 URL that is accessible from the Actor (no auth required beyond the URL itself).

**The run failed with "reference\_audio is required".**\
Ensure your input includes both `text` and `reference_audio` (non-empty URL or an uploaded file via the file upload field).

# Actor input Schema

## `text` (type: `string`):

Text to synthesize into speech (max 2000 characters)

## `reference_audio` (type: `string`):

URL of the reference audio (e.g. S3). Upload a file or paste your URL (about 3 seconds of clean audio).

## Actor input object example

```json
{
  "reference_audio": "https://your-bucket.s3.region.amazonaws.com/path/to/reference.mp3"
}
```

# Actor output Schema

## `dataset` (type: `string`):

Run result (success, outputKey or error).

## `audioFiles` (type: `string`):

Key-value store keys for generated WAV files. Use outputKey from dataset to download.

# 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 = {
    "reference_audio": "https://your-bucket.s3.region.amazonaws.com/path/to/reference.mp3"
};

// Run the Actor and wait for it to finish
const run = await client.actor("anyscrap/voiceclonertts").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 = { "reference_audio": "https://your-bucket.s3.region.amazonaws.com/path/to/reference.mp3" }

# Run the Actor and wait for it to finish
run = client.actor("anyscrap/voiceclonertts").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "reference_audio": "https://your-bucket.s3.region.amazonaws.com/path/to/reference.mp3"
}' |
apify call anyscrap/voiceclonertts --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=anyscrap/voiceclonertts",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "VoiceClonerTTS",
        "description": "High-quality text-to-speech API with voice cloning.",
        "version": "0.0",
        "x-build-id": "3OeLeQliYDdIsVvBl"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/anyscrap~voiceclonertts/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-anyscrap-voiceclonertts",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/anyscrap~voiceclonertts/runs": {
            "post": {
                "operationId": "runs-sync-anyscrap-voiceclonertts",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/anyscrap~voiceclonertts/run-sync": {
            "post": {
                "operationId": "run-sync-anyscrap-voiceclonertts",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "text",
                    "reference_audio"
                ],
                "properties": {
                    "text": {
                        "title": "Text",
                        "maxLength": 2000,
                        "type": "string",
                        "description": "Text to synthesize into speech (max 2000 characters)"
                    },
                    "reference_audio": {
                        "title": "Reference audio",
                        "type": "string",
                        "description": "URL of the reference audio (e.g. S3). Upload a file or paste your URL (about 3 seconds of clean audio)."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```