Camb AI Node.js SDK 🎙️

The official Node.js 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 JavaScript.

---

✨ 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

Install the SDK using npm:

npm install cambai

Or directly from GitHub:

npm install git+https://github.com/Camb-ai/cambai-node-sdk

---

🔑 Authentication

To use the Camb AI SDK, you'll need an API key. You can authenticate by explicitly setting the API key:

const { CambAI, ApiKey } = require('cambai');

// Initialize the client with your API key
const client = new CambAI();
client.setApiKey(ApiKey.APIKeyHeader, "YOUR_CAMB_AI_API_KEY");

You can also use an environment variable to avoid hardcoding your API key:

const { CambAI, ApiKey } = require('cambai');

// Get API key from environment variable
const API_KEY = process.env.CAMB_API_KEY || "YOUR_CAMB_AI_API_KEY";
const client = new CambAI();
client.setApiKey(ApiKey.APIKeyHeader, API_KEY);

Set your API key as an environment variable named CAMB_API_KEY:

export CAMB_API_KEY="your_actual_api_key_here"

---

🚀 Getting Started: Examples

1. Text-to-Speech (TTS)

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

const { CambAI, ApiKey, OutputType, Languages } = require('cambai');

// Initialize client
const client = new CambAI();
client.setApiKey(ApiKey.APIKeyHeader, "YOUR_CAMB_AI_API_KEY");

async function generateSpeech() {
  try {
    console.log("Generating speech...");
    
    // Get audio URL (default output type)
    const audioUrl = await client.textToSpeech(
      "Hello from Camb AI! This is a test of our Text-to-Speech API.",
      20303,  // Example voice ID, find more with client.listVoices()
      Languages.NUMBER_1,  // English
      60,  // Timeout in seconds
      OutputType.FileUrl,  // Get a URL to the audio file
      undefined,  // No file path for saving
      true  // Verbose logging
    );
    
    console.log(`Success! Your audio is ready at: ${audioUrl}`);
    
    // Save to a file
    const filePath = "my_generated_speech.mp3";
    await client.textToSpeech(
      "This is another test, saving directly to a file.",
      20303,  // Example voice ID
      Languages.NUMBER_1,  // English
      60,  // Timeout in seconds
      OutputType.RawBytes,  // Get raw bytes for saving
      filePath,  // Save to this file
      true  // Verbose logging
    );
    
    console.log(`Success! Audio saved to ${filePath}`);
    
  } catch (error) {
    console.error("Error generating speech:", error);
  }
}

generateSpeech();

List Available Voices

You can list available voices to find a voiceId that suits your needs:

async function listVoices() {
  try {
    const response = await client.listVoices();
    const voices = response.body;
    console.log("Available voices:", voices);
    console.log(`Found ${voices.length} voices:`);
    
    // Print first 5 as an example
    voices.slice(0, 5).forEach(voice => {
      console.log(`  - ID: ${voice.id}, Name: ${voice.voiceName}, Gender: ${voice.gender}, Language: ${voice.language}`);
    });
  } catch (error) {
    console.error("Could not list voices:", error);
  }
}

listVoices();

List Available Source Languages

Use this function to fetch and view all available source languages.

async function listSource() {  
try {
    const response = await client.getSourceLanguages();
    const source = response.body;
    console.log("Available Source Languages:", source);
    console.log(`Found ${source.length} voices:`);

    // Print first 5 as an example
    source.slice(0, source.length).forEach((lang) => {
      console.log(
        `  - ID: ${lang.id}, Name: ${lang.shortName}, Language: ${lang.language}`
      );
    });
  } catch (error) {
    console.error("Could not list source languages:", error);
  }
}

listSource();

List Available Target Languages

Use this function to fetch and view all available target languages.

async function listTarget() {
  try {
    const response = await client.getTargetLanguages();
    const target = response.body;
    console.log("Available Target Languages:", target);
    console.log(`Found ${target.length} voices:`);

    // Print first 5 as an example
    target.slice(0, target.length).forEach((lang) => {
      console.log(
        `  - ID: ${lang.id}, Name: ${lang.shortName}, Language: ${lang.language}`
      );
    });
  } catch (error) {
    console.error("Could not list target languages:", error);
  }
}

listTarget();

---

2. Text-to-Voice (Generative Voice)

Create completely new and unique voices from a textual description of the desired voice characteristics.

const { CambAI, ApiKey } = require('cambai');

// Initialize client
const client = new CambAI();
client.setApiKey(ApiKey.APIKeyHeader, "YOUR_CAMB_AI_API_KEY");

async function generateVoice() {
  try {
    console.log("Generating a new voice and speech...");
    
    // Generate a voice from description
    const result = await client.textToVoice(
      "Crafting a truly unique and captivating voice that carries a subtle air of mystery, depth, and gentle warmth.", // Minimum length of text is 100 characters
      "A smooth, rich baritone voice layered with a soft echo, ideal for immersive storytelling and emotional depth.",
      60,  // Timeout in seconds
      true  // Verbose logging
    );
    
    console.log("Voice generation complete!");
    console.log("Sample URLs:", result.previews);
    
  } catch (error) {
    console.error("Error generating voice:", error);
  }
}

generateVoice();

---

3. Text-to-Audio (Sound Generation)

Generate sound effects or ambient audio from a descriptive prompt.

const { CambAI, ApiKey } = require('cambai');

// Initialize client
const client = new CambAI();
client.setApiKey(ApiKey.APIKeyHeader, "YOUR_CAMB_AI_API_KEY");

async function generateSoundEffect() {
  const outputFile = "generated_sound_effect.mp3";
  
  try {
    console.log(`Generating sound effect and saving to ${outputFile}...`);
    
    const result = await client.textToAudio(
      "A gentle breeze rustling through autumn leaves in a quiet forest.",
      10,  // Duration in seconds
      60,  // Timeout in seconds
      true,  // Verbose logging
      outputFile  // Save to this file
    );
    
    console.log(`Success! Sound effect saved to ${outputFile}`);
    
  } catch (error) {
    console.error("Error generating sound effect:", error);
  }
}

generateSoundEffect();

---

4. End-to-End Dubbing

Dub your videos into multiple languages with voice cloning. This is a convenience method that handles the entire dubbing workflow automatically.

const { CambAI, ApiKey, Languages } = require('cambai');

// Initialize client
const client = new CambAI();
client.setApiKey(ApiKey.APIKeyHeader, "YOUR_CAMB_AI_API_KEY");

async function dubVideo() {
  try {
    console.log("Starting end-to-end dubbing...");
    
    const result = await client.endToEndDubbing(
      "https://youtube.com/example-url",  // Video URL
      Languages.NUMBER_1,  // Source language (English)
      [Languages.NUMBER_81],  // Target languages (Hindi)
      300,  // Timeout in seconds
      true  // Verbose logging
    );
    
    console.log("Dubbing complete!");
    console.log("Result:", result);
    
    // The result typically contains URLs to the dubbed audio/video files
    if (result.outputVideoUrl) {
      console.log("Dubbed video URL:", result.outputVideoUrl);
    }
    if (result.outputAudioUrl) {
      console.log("Dubbed audio URL:", result.outputAudioUrl);
    }
    
  } catch (error) {
    console.error("Error during dubbing:", error);
  }
}

dubVideo();

Parameters

• videoUrl (string, required): The URL of the media file to be dubbed
• sourceLanguage (Languages, required): The original language of the media file
• targetLanguages (Array, optional): The list of desired languages for dubbing
• timeout (number, optional): Maximum wait time in seconds (default: 300)
• verbose (boolean, optional): Enable status logging (default: false)

---

⚙️ Advanced Usage & Other Features

The Camb AI SDK offers a wide range of capabilities beyond these examples, including:

• Voice Cloning
• Translated TTS
• Audio Dubbing
• Transcription
• And more!

Please refer to the Official Camb AI API Documentation for a comprehensive list of features and advanced usage patterns.

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

---