Create a Custom Voice

Documentation Index

Fetch the complete documentation index at: https://docs.camb.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Understanding Voice Cloning Technology

​

The Voice Cloning Process

1. Audio Analysis: Our system processes your audio file, identifying the core vocal characteristics that make the voice unique.
2. Feature Extraction: The system extracts key vocal features, including pitch range, tonal qualities, speech cadence, and articulation patterns.
3. Voice Model Creation: These extracted features are used to build a voice model that can synthesize new speech matching the original voice’s characteristics.
4. Voice Registration: The newly created voice is registered in your account and assigned a unique identifier for future use in text-to-speech operations.

​

Audio Sample Recommendations

1. Content Quality:
   • Record in a quiet environment with minimal background noise or echo
   • Use a good quality microphone positioned at an appropriate distance
   • Maintain consistent volume and speaking pace throughout the recording
   • Avoid vocal strains, forced expressions, or unnatural speech patterns
2. Content Selection:
   • Choose text with diverse phonetic content that exercises different sounds
   • Include a variety of sentence structures and intonation patterns
   • Select content similar to what you’ll ultimately want the voice to produce
   • Avoid highly technical terms unless they’re essential to your use case
3. Sample Duration:
   • Aim for 30-60 seconds of clean audio at minimum
   • Longer samples (2-3 minutes) can provide better results for more complex use cases
   • Very short samples (15 seconds) may produce less consistent voice clones

​

Implementation Example

import requests
import os
import time

def create_custom_voice(file_path, voice_name, gender, age, description=None, language=None):
    """
    Creates a custom voice clone from an audio sample

    Parameters:
        file_path (str): Path to the audio file containing the voice sample
        voice_name (str): Name to assign to the custom voice
        gender (int): Gender identifier (1=male, 2=female, etc.)
        age (int): Approximate age of the speaker
        description (str, optional): Detailed description of the voice
        language (str, optional): Language code of the voice (e.g., "en-US")

    Returns:
        dict: Response from the API containing voice details
    """
    # Validate file exists
    if not os.path.exists(file_path):
        raise FileNotFoundError(f"Audio file not found at: {file_path}")

    # Prepare file for upload
    files = {'file': open(file_path, 'rb')}

    # Prepare metadata
    data = {
        'voice_name': voice_name,
        'gender': gender,
        'age': age
    }

    # Add optional parameters if provided
    if description:
        data['description'] = description
    if language:
        data['language'] = language

    try:
        # Make API request
        response = requests.post(
            "https://client.camb.ai/apis/create-custom-voice",
            files=files,
            data=data,
            headers={
                "x-api-key": os.environ.get("API_KEY")  # Get API key from environment variable
            }
        )

        # Close file handle
        files['file'].close()

        # Check for errors
        response.raise_for_status()

        # Return response data
        return response.json()

    except requests.exceptions.HTTPError as http_err:
        print(f"HTTP error occurred: {http_err}")
        if response.text:
            print(f"Response details: {response.text}")
        return None
    except Exception as err:
        print(f"Error creating custom voice: {err}")
        return None
    finally:
        # Ensure file is closed even if an error occurs
        if 'file' in files and not files['file'].closed:
            files['file'].close()

# Example usage
if __name__ == "__main__":
    result = create_custom_voice(
        file_path="narrator_sample.wav",
        voice_name="Professional Narrator",
        gender=1,
        age=45,
        description="Clear, articulate voice with professional tone. Ideal for documentary narration.",
        language="1"
    )

    if result:
        print(f"Custom voice created successfully with ID: {result['voice_id']}")

​

Working with Your Custom Voice

1. Text-to-Speech Conversion: Use the voice ID with the /tts endpoint to convert text to speech in your custom voice.
2. Voice Management: Find your custom voice in the list returned by the /list-voices endpoint, alongside public and shared voices.
3. Voice Updates: If needed, you can create a new version of the voice by submitting a new request with the same voice name but a different audio sample.
4. Voice Publishing: If you initially created a private voice but later wish to share it, you can use our voice update endpoints to change its publication status.

​

Use Cases for Custom Voices

• Brand Consistency: Create a consistent voice identity across all your digital touchpoints
• Character Development: Build unique voices for characters in games, animations, or interactive experiences
• Personalized Communication: Generate content that sounds like a specific individual (with appropriate permissions)
• Accessibility Solutions: Create synthetic versions of a person’s voice for use in assistive technology
• Multilingual Content: Clone a voice and use it to speak multiple languages while maintaining the same vocal identity

​

Ethical Considerations

1. Always obtain proper consent from the person whose voice you are cloning
2. Use voice clones respectfully and avoid creating misleading content
3. Clearly identify synthesized speech when there might be confusion about its origin
4. Follow applicable laws and regulations regarding biometric data and privacy