Voice Cloning

​

How It Works

1. Upload reference audio - Provide 10-30 seconds of clean speech
2. Processing - Our AI analyzes the voice characteristics
3. Voice created - Use your new voice in any TTS request

​

Requirements

​

Audio Quality

• Duration: 10-30 seconds of speech
• Format: WAV, MP3, or FLAC
• Sample rate: 16kHz or higher
• Channels: Mono preferred
• Quality: Clean, no background noise

​

Content Guidelines

• Clear speech with natural pacing
• Single speaker only
• Minimal background noise
• Natural emotional range

• Multiple speakers
• Background music
• Heavy reverb or echo
• Whispered or shouted speech
• Heavily compressed audio

​

Creating a Voice Clone

​

Via Dashboard

1. Go to Dashboard → Voices → Create Voice
2. Upload your reference audio
3. Enter a name and description
4. Click Create Voice
5. Wait for processing (usually 2-5 minutes)

​

Via API

import requests

# Upload audio file
with open("reference.wav", "rb") as f:
    response = requests.post(
        "https://api.kugelaudio.com/v1/voices/clone",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"audio": f},
        data={
            "name": "My Custom Voice",
            "description": "Cloned from reference audio",
        }
    )

voice = response.json()["data"]
print(f"Created voice: {voice['id']}")

​

Using Cloned Voices

from kugelaudio import KugelAudio

client = KugelAudio(api_key="YOUR_API_KEY")

# Use your cloned voice
audio = client.tts.generate(
    text="Hello, this is my cloned voice speaking!",
    model="kugel-1-turbo",
    voice_id=YOUR_CLONED_VOICE_ID,
)

audio.save("cloned_output.wav")

import { KugelAudio } from 'kugelaudio';

const client = new KugelAudio({ apiKey: 'YOUR_API_KEY' });

const audio = await client.tts.generate({
  text: 'Hello, this is my cloned voice speaking!',
  model: 'kugel-1-turbo',
  voiceId: YOUR_CLONED_VOICE_ID,
});

​

Best Practices

​

Optimizing Voice Quality

​

Troubleshooting

​

Managing Cloned Voices

​

List Your Voices

# Get all your cloned voices
voices = client.voices.list(category="cloned")

for voice in voices:
    print(f"{voice.id}: {voice.name}")

​

Update Voice

# Update voice metadata
response = requests.patch(
    f"https://api.kugelaudio.com/v1/voices/{voice_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "name": "Updated Name",
        "description": "Updated description",
    }
)

​

Delete Voice

# Delete a cloned voice
response = requests.delete(
    f"https://api.kugelaudio.com/v1/voices/{voice_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

​

Privacy & Ethics

​

Guidelines

1. Get consent - Always obtain permission before cloning someone’s voice
2. Disclose synthetic speech - Be transparent when using cloned voices
3. No impersonation - Don’t use cloned voices to deceive or defraud
4. Respect rights - Don’t clone voices of public figures without authorization

​

Verification

1. Upload proof of consent
2. Our team reviews the submission
3. Voice is marked as “verified”
4. Verified voices have no usage restrictions

​

Limits

​

Next Steps