Camb.ai Rust SDK

Camb AI Website

The official Rust SDK for interacting with Camb AI's powerful voice and audio generation APIs. Create expressive speech, unique voices, and rich soundscapes with just a few lines of Rust.

✨ Features

• Dubbing: Dub your videos into multiple languages with voice cloning!
• Expressive Text-to-Speech: Convert text into natural-sounding speech using a wide range of pre-existing voices.
• Generative Voices: Create entirely new, unique voices from text prompts and descriptions.
• Soundscapes from Text: Generate ambient audio and sound effects from textual descriptions.
• Access to voice cloning, translation, and more (refer to full API documentation).

📦 Installation

Add this to your Cargo.toml:

[dependencies]
camb_api = { git = "https://github.com/Camb-ai/cambai-rust-sdk" }
tokio = { version = "1.0", features = ["full"] }

🔑 Authentication & Accessing Clients

To use the Camb AI SDK, you'll need an API key.

use camb_api::prelude::*;

#[tokio::main]
async fn main() {
    let config = ClientConfig {
        api_key: Some("YOUR_CAMB_API_KEY".to_string()),
        ..Default::default()
    };
    let client = APIClient::new(config).expect("Failed to build client");
}

Client with Specific MARS Pro Provider (e.g. Baseten)

You can use the TtsProvider pattern to switch between the default Camb.ai provider and custom providers like Baseten.

use camb_api::provider::{BasetenProvider, TtsProvider};

// Initialize custom provider
let tts_provider = BasetenProvider::new(
    "YOUR_BASETEN_API_KEY".to_string(),
    None, // Uses default production URL
);

// Unified interface call using the custom provider
// (See examples/baseten_provider.rs for full implementation)

🚀 Getting Started: Examples

NOTE: For more examples and full runnable files refer to the examples/ directory.

1. Text-to-Speech (TTS)

Convert text into spoken audio using one of Camb AI's high-quality voices.

use camb_api::prelude::*;
use std::io::Write;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = APIClient::new(ClientConfig {
        api_key: Some("YOUR_API_KEY".to_string()),
        ..Default::default()
    })?;

    let mut stream = client.text_to_speech.tts(&CreateStreamTtsRequestPayload {
        text: "Hello from Camb AI!".to_string(),
        voice_id: 20303,
        language: Some(Languages::EN_US),
        speech_model: Some(CreateStreamTtsRequestPayloadSpeechModel::MarsPro),
        ..Default::default()
    }, None).await?;

    let mut file = std::fs::File::create("output.mp3")?;
    while let Some(chunk) = stream.try_next().await? {
        file.write_all(&chunk)?;
    }

    Ok(())
}

2. Text-to-Voice (Generative Voice)

Create completely new and unique voices from a textual description.

let result = client.text_to_voice.create_text_to_voice(&CreateTextToVoiceRequestPayload {
    text: "A smooth, rich baritone voice.".to_string(),
    voice_description: Some("Ideal for storytelling.".to_string()),
    ..Default::default()
}, None).await?;

License

This project is licensed under the MIT License.