Skip to main content
Version: 1.0.x

Resemble AI TTS

The Resemble AI TTS provider enables your agent to use Resemble AI's high-quality text-to-speech models for generating natural-sounding voice output.

Installation

Install the Resemble AI-enabled VideoSDK Agents package:

pip install "videosdk-plugins-resemble"

Importing

from videosdk.agents.plugins import ResembleTTS

Authentication

The Resemble plugin requires an Resemble API key.

Set RESEMBLE_API_KEY in your .env file.

Example Usage

from videosdk.agents.plugins import ResembleTTS
from videosdk.agents import Pipeline

# Initialize the Resemble AI TTS model
tts = ResembleTTS(
# When RESEMBLE_API_KEY is set in .env - DON'T pass api_key parameter
api_key="your-resemble-api-key",
voice_uuid="55592656"
)

# Add tts to pipeline
pipeline = Pipeline(tts=tts)
note

When using .env file for credentials, don't pass them as arguments to model instances or context objects. The SDK automatically reads environment variables, so omit api_key and other credential parameters from your code.

Configuration Options

  • api_key: (str) Your Resemble AI API key. Can also be set via the RESEMBLE_API_KEY environment variable.
  • voice_uuid: (str) The UUID of the voice to use for synthesis (default: "55592656").
  • sample_rate: (int) The audio sample rate in Hz (default: 22050).
  • precision: (str) The audio precision to use for synthesis (default: "PCM_16").
  • model: (str, optional) Optional Resemble model name to override the account default (e.g. "chatterbox", "chatterbox-turbo"). When None, the server applies the account-level default model.

Additional Resources

The following resources provide more information about using Resemble with VideoSDK Agents SDK.

Got a Question? Ask us on discord