> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatterbox-tts

> API usage guide for Chatterbox-tts.

{/* source_model_id: Chatterbox-tts */}

{/* source_updated_at: 1778524017 */}

**Model ID**

```bash theme={null}
Chatterbox-tts
```

**Calling method:** sync

# Resemble AI Chatterbox TTS API Usage Guide

## Overview

**Chatterbox TTS** is Resemble AI's premier text-to-speech model. It generates high-quality audio from text or SSML.

## Authentication

All API requests require authentication using your API key. Include it in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Text-to-Speech Request

### Base URL

```
https://console.gmicloud.ai
```

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Chatterbox-tts",
    "payload": {
      "voice_uuid": "your-voice-uuid",
      "data": "Hello, this is a test of the Resemble AI TTS system.",
      "output_format": "wav",
      "sample_rate": 48000
    }
  }'
```

### Request Parameters

| Parameter       | Type    | Required | Description                                                         | Default   |
| --------------- | ------- | -------- | ------------------------------------------------------------------- | --------- |
| `voice_uuid`    | string  | Yes      | Voice UUID to use for synthesis.                                    | -         |
| `data`          | string  | Yes      | Text or SSML to synthesize. Maximum 3,000 characters.               | -         |
| `title`         | string  | No       | Optional title for the generated clip.                              | -         |
| `output_format` | enum    | No       | Audio output format (wav, mp3).                                     | "wav"     |
| `sample_rate`   | enum    | No       | Audio sample rate in Hz.                                            | 48000     |
| `precision`     | enum    | No       | Audio precision for WAV output.                                     | "PCM\_32" |
| `use_hd`        | boolean | No       | Enables higher-definition synthesis with a small latency trade-off. | false     |

### Response

```json theme={null}
{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "Chatterbox-tts",
  "status": "queued",
  "created_at": 1772184500
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Response

```json theme={null}
{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "Chatterbox-tts",
  "status": "success",
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-generated-assets/.../resemble_output_0.wav"
      }
    ]
  }
}
```

## Request Status Values

| Status       | Description                                |
| ------------ | ------------------------------------------ |
| `queued`     | Request is waiting in the queue            |
| `processing` | Audio is currently being generated         |
| `success`    | Audio generation completed                 |
| `failed`     | Generation failed (check logs for details) |
| `cancelled`  | Request was manually cancelled             |

## Pricing

* **Pricing Type**: Per second