Skip to main content
Model ID 
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: 
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

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

ParameterTypeRequiredDescriptionDefault
voice_uuidstringYesVoice UUID to use for synthesis.-
datastringYesText or SSML to synthesize. Maximum 3,000 characters.-
titlestringNoOptional title for the generated clip.-
output_formatenumNoAudio output format (wav, mp3).“wav”
sample_rateenumNoAudio sample rate in Hz.48000
precisionenumNoAudio precision for WAV output.”PCM_32”
use_hdbooleanNoEnables higher-definition synthesis with a small latency trade-off.false

​
Response

{
  "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

{
  "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

StatusDescription
queuedRequest is waiting in the queue
processingAudio is currently being generated
successAudio generation completed
failedGeneration failed (check logs for details)
cancelledRequest was manually cancelled

​
Pricing

  • Pricing Type: Per second