Voice Cloning

Voice cloning lets you create a synthetic voice from reference audio.

How It Works

Upload reference audio - Provide clean, representative speech
Processing - Our AI analyzes the voice characteristics
Voice created - Use your new voice in any TTS request

Requirements

Audio Quality

For best results, your reference audio should be:

Format: WAV, MP3, OGG, M4A, or FLAC
File size: At most 50 MiB per reference
Channels: Mono preferred
Quality: Clean, no background noise

Content Guidelines

✅ Good audio:

Clear speech with natural pacing
Single speaker only
Minimal background noise
Natural emotional range
Free of filler words (um, uh, ah, hmm) unless you want them in the output

❌ Avoid:

Multiple speakers
Background music
Heavy reverb or echo
Whispered or shouted speech
Heavily compressed audio
Recordings with frequent filler sounds or hesitations
Long gaps or extended silence between sentences, unless you want the cloned voice to reproduce those pauses

Your samples define the voice. The cloned voice will reproduce everything present in your reference audio — including filler sounds like “um”, “ah”, “hmm”, long sentence gaps, breathing patterns, and any other speech habits. If your reference audio contains these sounds or pauses, they will appear in the generated output and cannot be removed after cloning.For the most controllable results, use clean recordings without fillers or long silences. You can then add natural-sounding hesitations through your text prompts when needed (e.g., writing “um” or ”…” in the input text).

Creating a Voice Clone

Via Dashboard

Go to Dashboard → Voices → Create Voice
Upload your reference audio
Enter a name and description
Click Create Voice
Wait for processing to finish

Via SDK

Python
JavaScript
cURL

from kugelaudio import KugelAudio

client = KugelAudio(api_key="YOUR_API_KEY")

# Create a voice with reference audio
voice = client.voices.create(
    name="My Custom Voice",
    sex="female",
    description="Cloned from reference audio",
    category="conversational",
    reference_files=["reference.wav"],
)

print(f"Created voice: {voice.id}")
print(f"Name: {voice.name}")

import { KugelAudio } from 'kugelaudio';

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

// Create a voice with reference audio (browser)
const fileInput = document.getElementById('audio-upload') as HTMLInputElement;
const file = fileInput.files![0];

const voice = await client.voices.create({
  name: 'My Custom Voice',
  sex: 'female',
  description: 'Cloned from reference audio',
  category: 'conversational',
  referenceFiles: [file],
});

console.log(`Created voice: ${voice.id}`);

curl -X POST https://api.kugelaudio.com/v1/voices \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -F 'metadata={"name":"My Custom Voice","sex":"female","description":"Cloned from reference audio","category":"conversational"};type=application/json' \
  -F "files=@reference.wav"

Voice creation skips empty, unsupported, or oversized reference files while still creating the voice. If you must confirm that a particular file was accepted, list the voice’s references after creation or add it through the dedicated reference-upload endpoint, which returns an error for invalid files.

Using Cloned Voices

Once created, use your cloned voice like any other:

Python
JavaScript
cURL

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_id="kugel-3",
    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!',
  modelId: 'kugel-3',
  voiceId: YOUR_CLONED_VOICE_ID,
});

curl -X POST https://api.kugelaudio.com/v1/tts/generate \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, this is my cloned voice speaking!",
    "model_id": "kugel-3",
    "voice_id": YOUR_CLONED_VOICE_ID
  }' \
  --output cloned_output.pcm

Best Practices

Optimizing Voice Quality

Use high-quality source audio

The quality of your cloned voice depends heavily on the source audio. Use professional recordings when possible.

Provide diverse samples

Include a range of intonations, emotions, and sentence types in your reference audio for a more natural clone.

Adjust CFG scale

Experiment within the supported cfg_scale range of 1.2 to 2.5.

Remove filler sounds from samples

If your output contains unwanted “um”s, “ah”s, or hesitations, re-record or edit your reference audio to remove them. The model faithfully reproduces what it hears in the samples — clean input produces clean, controllable output. You can always add fillers via your text prompts later.

Troubleshooting

Issue	Solution
Voice sounds robotic	Use higher quality source audio, try lower CFG scale
Voice sounds different	Ensure source audio is clean, try different text samples
Accent not preserved	Include more diverse samples, use longer reference audio
Inconsistent output	Try a different CFG value within `1.2`–`2.5`
Unwanted filler sounds (um, ah, hmm)	Re-record or edit reference audio to remove fillers — see Content Guidelines
Unexpected long pauses	Re-record or edit reference audio to remove long gaps between sentences — the model can learn and reproduce these pauses

Managing Cloned Voices

List Your Voices

Python
JavaScript
cURL

result = client.voices.list()

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

const result = await client.voices.list();

for (const voice of result.voices) {
  console.log(`${voice.id}: ${voice.name} (${voice.category})`);
}

curl "https://api.kugelaudio.com/v1/voices" \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

Update Voice

Python
JavaScript
cURL

voice = client.voices.update(
    voice_id=1071,
    name="Updated Name",
    description="Updated description",
)
print(f"Updated: {voice.name}")

const voice = await client.voices.update(1071, {
  name: 'Updated Name',
  description: 'Updated description',
});
console.log(`Updated: ${voice.name}`);

curl -X PATCH https://api.kugelaudio.com/v1/voices/1071 \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Name",
    "description": "Updated description"
  }'

Delete Voice

Python
JavaScript
cURL

client.voices.delete(voice_id=1071)

await client.voices.delete(1071);

curl -X DELETE https://api.kugelaudio.com/v1/voices/1071 \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

Managing Reference Audio

You can add and remove reference audio files after creating a voice.

List References

curl https://api.kugelaudio.com/v1/voices/1071/references \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

Add Reference

Python
JavaScript

ref = client.voices.add_reference(
    voice_id=1071,
    file="new_reference.wav",
    reference_text="Optional transcript of the audio.",
)
print(f"Added reference: {ref.id}")

const file = new File([audioBuffer], 'new_reference.wav', { type: 'audio/wav' });
const ref = await client.voices.addReference(1071, file, 'Optional transcript.');
console.log(`Added reference: ${ref.id}`);

Delete Reference

Python
JavaScript

client.voices.delete_reference(voice_id=1071, reference_id=456)

await client.voices.deleteReference(1071, 456);

Publishing Voices

Request that your voice be made public. It will be marked as pending verification until reviewed by an admin.

Python
JavaScript

voice = client.voices.publish(voice_id=1071)
print(f"Pending verification: {voice.pending_verification}")

const voice = await client.voices.publish(1071);
console.log(`Pending verification: ${voice.pendingVerification}`);

Generating Voice Samples

Trigger sample audio generation after uploading at least one reference:

curl -X POST https://api.kugelaudio.com/v1/voices/1071/generate-sample \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

The response contains sample_s3_path and a signed sample_url.

AI Transparency & Watermarking

Voice-cloned output uses the same in-band watermark and HTTP disclosure header as every other synthesis response. See AI-generated audio marking for the wire details, detector example, and limitations.

Privacy & Ethics

Only clone voices you have permission to use. Misuse of voice cloning technology may violate laws and our Terms of Service.

Guidelines

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

Next Steps

Using Voices

Browse and use available voices

Generate Speech

Generate audio with your cloned voice

Models

Learn about available models

Get started

Build a voice agent

Generate audio

Voices

Deploy

SDK Reference

API Reference

How It Works

Requirements

Audio Quality

Content Guidelines

Creating a Voice Clone

Via Dashboard

Via SDK

Using Cloned Voices

Best Practices

Optimizing Voice Quality

Troubleshooting

Managing Cloned Voices

List Your Voices

Update Voice

Delete Voice

Managing Reference Audio

List References

Add Reference

Delete Reference

Publishing Voices

Generating Voice Samples

AI Transparency & Watermarking

Privacy & Ethics

Guidelines

Next Steps

Using Voices

Generate Speech

Models

​How It Works

​Requirements

​Audio Quality

​Content Guidelines

​Creating a Voice Clone

​Via Dashboard

​Via SDK

​Using Cloned Voices

​Best Practices

​Optimizing Voice Quality

​Troubleshooting

​Managing Cloned Voices

​List Your Voices

​Update Voice

​Delete Voice

​Managing Reference Audio

​List References

​Add Reference

​Delete Reference

​Publishing Voices

​Generating Voice Samples

​AI Transparency & Watermarking

​Privacy & Ethics

​Guidelines

​Next Steps

Using Voices

Generate Speech

Models

How It Works

Requirements

Audio Quality

Content Guidelines

Creating a Voice Clone

Via Dashboard

Via SDK

Using Cloned Voices

Best Practices

Optimizing Voice Quality

Troubleshooting

Managing Cloned Voices

List Your Voices

Update Voice

Delete Voice

Managing Reference Audio

List References

Add Reference

Delete Reference

Publishing Voices

Generating Voice Samples

AI Transparency & Watermarking

Privacy & Ethics

Guidelines

Next Steps