# Chatterbox

> Resemble AI's production-grade open-source TTS with unique emotion exaggeration control and instant voice cloning from a short reference audio.

- **Provider**: replicate
- **Model ID**: resemble-ai/chatterbox
- **Category**: tts_voice
- **Credits**: 59 per request
- **Pricing Type**: token_based

## 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

- `exaggeration` (number, optional): Exaggeration (Neutral = 0.5, extreme values can be unstable) (Default: `0.5`; Range: min: 0.25, max: 2)
- `temperature` (number, optional): Temperature (Default: `0.8`; Range: min: 0.05, max: 5)
- `seed` (integer, optional): Seed (0 for random) (Default: `0`)
- `prompt` (string, **required**): Text to synthesize
- `cfg_weight` (number, optional): CFG/Pace weight (Default: `0.5`; Range: min: 0.2, max: 1)
- `audio_prompt` (string, optional): Path to the reference audio file (Optional)

## Example Request

```json
{
  "model": "resemble-ai/chatterbox",
  "input": {
    "temperature": 0.8,
    "exaggeration": 0.5,
    "seed": 0,
    "prompt": "We're excited to introduce Chatterbox, our first production-grade open source TTS model. Licensed under MIT, Chatterbox has been benchmarked against leading closed-source systems like ElevenLabs, and is consistently preferred in side-by-side evaluations.\n\nWhether you're working on memes, videos, games, or AI agents, Chatterbox brings your content to life. It's also the first open source TTS model to support emotion exaggeration control, a powerful feature that makes your voices stand out. Try it now on our Hugging Face Gradio app.\n\nIf you like the model but need to scale or finetune it for higher accuracy, check out our competitively priced TTS service (link). It delivers reliable performance with ultra-low latency of sub 200ms\u2014ideal for production use in agents, applications, or interactive media.",
    "cfg_weight": 0.5
  }
}
```

## 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-synthesis, voice-cloning, emotion-control, resemble-ai, open-source

## Documentation

https://replicate.com/resemble-ai/chatterbox


## Token Pricing

- Input: 0.058125 credits/token
- Output: 0.058125 credits/token