# XTTS-v2

> Coqui XTTS-v2 multilingual voice-cloning TTS. Clone a voice from a single short audio sample and speak in 16 languages.

- **Provider**: replicate
- **Model ID**: lucataco/xtts-v2
- **Category**: tts_voice
- **Credits**: 26 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `cleanup_voice` (boolean, optional): Whether to apply denoising to the speaker audio (microphone recordings) (Default: `False`)
- `language` (string, optional): Output language for the synthesised speech (Default: `en`; Options: `en`, `es`, `fr`, `de`, `it`, `pt`, `pl`, `tr`, `ru`, `nl`, `cs`, `ar`, `zh`, `hu`, `ko`, `hi`)
- `text` (string, optional): Text to synthesize (Default: `Hi there, I'm your new voice clone. Try your best to upload quality audio`)
- `speaker` (string, **required**): Original speaker audio (wav, mp3, m4a, ogg, or flv)

## Example Request

```json
{
  "model": "lucataco/xtts-v2",
  "input": {
    "cleanup_voice": false,
    "language": "en",
    "text": "Hi there, I'm your new voice clone. Try your best to upload quality audio",
    "speaker": "https://replicate.delivery/pbxt/Jt79w0xsT64R1JsiJ0LQRL8UcWspg5J4RFrU6YwEKpOT1ukS/male.wav"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

text-to-speech, tts, audio, voice-cloning, coqui, xtts, multilingual, open-source

## Documentation

https://replicate.com/lucataco/xtts-v2