> ## Documentation Index
> Fetch the complete documentation index at: https://hanabiaiinc-auto-go-api-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Voice Cloning Best Practices
> Simple tips to get the best voice cloning results with Fish Audio
export const AudioTranscript = ({voices = []}) => {
const [selectedVoice, setSelectedVoice] = useState(0);
const [isPlaying, setIsPlaying] = useState(false);
const [currentTime, setCurrentTime] = useState(0);
const [duration, setDuration] = useState(0);
const [isDropdownOpen, setIsDropdownOpen] = useState(false);
const audioRef = useRef(null);
const dropdownRef = useRef(null);
useEffect(() => {
const audio = audioRef.current;
if (!audio) return;
const updateTime = () => setCurrentTime(audio.currentTime);
const updateDuration = () => setDuration(audio.duration);
const handleEnded = () => setIsPlaying(false);
audio.addEventListener('timeupdate', updateTime);
audio.addEventListener('loadedmetadata', updateDuration);
audio.addEventListener('ended', handleEnded);
return () => {
audio.removeEventListener('timeupdate', updateTime);
audio.removeEventListener('loadedmetadata', updateDuration);
audio.removeEventListener('ended', handleEnded);
};
}, []);
useEffect(() => {
const handleClickOutside = event => {
if (dropdownRef.current && !dropdownRef.current.contains(event.target)) {
setIsDropdownOpen(false);
}
};
if (isDropdownOpen) {
document.addEventListener('mousedown', handleClickOutside);
}
return () => {
document.removeEventListener('mousedown', handleClickOutside);
};
}, [isDropdownOpen]);
useEffect(() => {
if (audioRef.current) {
audioRef.current.pause();
audioRef.current.load();
setIsPlaying(false);
setCurrentTime(0);
}
}, [selectedVoice]);
const togglePlay = () => {
if (isPlaying) {
audioRef.current.pause();
} else {
audioRef.current.play();
}
setIsPlaying(!isPlaying);
};
const handleProgressChange = e => {
const newTime = parseFloat(e.target.value);
audioRef.current.currentTime = newTime;
setCurrentTime(newTime);
};
const formatTime = time => {
if (isNaN(time)) return '0:00';
const minutes = Math.floor(time / 60);
const seconds = Math.floor(time % 60);
return `${minutes}:${seconds.toString().padStart(2, '0')}`;
};
const currentVoice = voices[selectedVoice];
return
{}
Listen to PagePowered by Fish Audio S1
{voices.length > 1 ?
{isDropdownOpen &&
{voices.map((voice, index) => )}
}
: }
{}
{}
{}
{formatTime(currentTime)}
{formatTime(duration)}
;
};
## Getting Started
Voice cloning lets you create a digital version of any voice. Use at least 10 seconds of audio recording for studio-quality results right in the Playground or via the API.
## Recording Your Voice
### Find a Quiet Space
**Good places to record:**
* A bedroom with curtains and carpet
* Inside a parked car
* A quiet office or study room
* Any room with soft furniture
**Avoid recording near:**
* Open windows with traffic noise
* Running appliances (AC, fans, refrigerators)
* Other people talking
* TVs or music playing
### Use What You Have
**Best options:**
* USB microphone or gaming headset
* Phone voice recorder app (place it on a stable surface)
* Earbuds with microphone (hold them steady)
**Quick tip:** Keep the microphone about a hand's width from your mouth and speak normally.
## What to Say
**Best approach:** Record 2-3 clips of 15-20 seconds each that form a complete paragraph.
Here's a sample script you can read naturally:
```
"Hello, my name is Alex, and I enjoy reading books about technology
and science. Yesterday, I walked through the park, observing the
beautiful autumn leaves. The weather was quite pleasant, with a
gentle breeze and warm sunshine. I often think about how amazing
our world is, full of interesting discoveries waiting to be made."
```
### Recording Tips
**Must Have:**
* Only one person speaking
* Steady volume throughout
* Consistent tone and emotion
* Small pauses between sentences (about half a second)
**Nice to Have:**
* No background noise
* No room echo
* Professional mic (but phone is fine too!)
**Avoid:**
* Multiple speakers in one recording
* Big changes in volume or emotion
* Background music or TV
* Rushing through without pauses
## Troubleshooting
### Common Problems
**Voice sounds robotic?**
* Try recording for longer, 30-60 seconds
* Speak more naturally and add pauses
**Voice doesn't sound like you?**
* Make sure you're the only person speaking in the recording
* Check that there's no background music or TV
**Poor audio quality?**
* Find a quieter room to record
* Move closer to your microphone
* Try using a different recording device
## Important: Getting Permission
Only clone voices you have permission to use:
* Your own voice
* Someone who gave you written permission
* Never use voices from the internet without permission
* Never use celebrity or public figure voices without permission
## How to Upload Your Recording
Visit [fish.audio](https://fish.audio) and log in
Find the voice creation button in your dashboard
Select your recorded file and give your voice a name
It usually takes just a few seconds
Type some text and hear your cloned voice speak!
## Making Different Voices
Want to create character voices or different styles? Try these:
### Different Emotions
Record the same text with different feelings:
* Happy and energetic
* Calm and relaxed
* Serious and professional
### Different Characters
Create unique voices for:
* Storytelling and audiobooks
* Game characters
* Educational content
* Podcast intros
## Get Help
Need assistance? We're here to help:
* **Community Forum**: [Join our Discord](https://discord.gg/fish-audio)
* **Email Support**: [support@fish.audio](mailto:support@fish.audio)
* **Video Tutorials**: Coming soon!