Camb AI

Text-to-speech service using Camb AI’s MARS models for high-quality speech synthesis

Overview

CambTTSService provides high-quality text-to-speech synthesis using Camb AI’s MARS model family with streaming capabilities. The service offers multiple model options optimized for different use cases: mars-flash for fast inference and mars-pro for high-quality output.

Camb AI TTS API Reference

Pipecat’s API methods for Camb AI TTS integration

Example Implementation

Complete example with interruption handling

Camb AI Documentation

Official Camb AI API documentation

Camb AI Platform

Access the Camb AI studio platform

Installation

To use Camb AI services, install the required dependencies:

pip install "pipecat-ai[camb]"

Prerequisites

Camb AI Account Setup

Before using Camb AI TTS services, you need:

1. Camb AI Account: Sign up at Camb AI
2. API Key: Generate an API key from your account dashboard
3. Voice Selection: Choose voice IDs from the platform

Required Environment Variables

• CAMB_API_KEY: Your Camb AI API key for authentication

Configuration

CambTTSService

api_key · str · required

Camb.ai API key for authentication.

voice_id · int · default: "147320" · deprecated

Voice ID to use for synthesis.

Deprecated in v0.0.105. Use settings=CambTTSService.Settings(...) instead.

model · str · default: "mars-flash" · deprecated

TTS model to use. Options: "mars-flash" (fast, 22.05kHz), "mars-pro" (high quality, 48kHz), "mars-instruct" (instruction-following, 22.05kHz).

Deprecated in v0.0.105. Use settings=CambTTSService.Settings(...) instead.

timeout · float · default: "60.0"

Request timeout in seconds. 60 seconds is the minimum recommended by Camb.ai.

sample_rate · int · default: "None"

Output audio sample rate in Hz. If None, uses the model-specific default (22050 for mars-flash, 48000 for mars-pro).

params · InputParams · default: "None" · deprecated

Runtime-configurable voice settings. See InputParams below.

Deprecated in v0.0.105. Use settings=CambTTSService.Settings(...) instead.

settings · CambTTSService.Settings · default: "None"

Runtime-configurable settings. See Settings below.

Settings

Runtime-configurable settings passed via the settings constructor argument using CambTTSService.Settings(...). These can be updated mid-conversation with TTSUpdateSettingsFrame. See Service Settings for details.

Parameter	Type	Default	Description
model	str	None	Model identifier. (Inherited.)
voice	str	None	Voice identifier. (Inherited.)
language	Language | str	None	Language for synthesis. (Inherited.)
user_instructions	str	NOT_GIVEN	Instructions to guide voice synthesis style.

Usage

Basic Setup

from pipecat.services.camb import CambTTSService

tts = CambTTSService(
    api_key=os.getenv("CAMB_API_KEY"),
    settings=CambTTSService.Settings(
        model="mars-flash",
    ),
)

High Quality with mars-pro

tts = CambTTSService(
    api_key=os.getenv("CAMB_API_KEY"),
    settings=CambTTSService.Settings(
        voice="12345",
        model="mars-pro",
    ),
)

With Language Customization

from pipecat.transcriptions.language import Language

tts = CambTTSService(
    api_key=os.getenv("CAMB_API_KEY"),
    settings=CambTTSService.Settings(
        model="mars-flash",
        language=Language.FR,
    ),
)

The InputParams / params= pattern is deprecated as of v0.0.105. Use Settings / settings= instead. See the Service Settings guide for migration details.

Notes

Set the audio_out_sample_rate in PipelineParams to match the model’s sample rate (22050 for mars-flash, 48000 for mars-pro) for optimal quality. See the example implementation for usage.

• Model-specific sample rates: Each model has a fixed output sample rate. Setting a mismatched sample_rate will produce a warning and may cause audio issues.
• Text length limit: Input text is limited to 3000 characters per request. Longer text is automatically truncated with a warning.
• 140+ languages: Camb.ai supports a wide range of languages through BCP-47 codes.