---
title: Troubleshooting Common Issues
description: "Fix common AKOOL Avatar issues: failed generations, custom avatars that don't look lifelike, audio upload and voice problems, and Motion Avatar gestures."
---

[![akool logo](https://help.akool.com/hubfs/akool-logo-1.svg)](https://akool.com/?hsLang=en)

en

- [English](https://help.akool.com/avatar/troubleshooting)
- [Español](https://help.akool.com/es/avatar/troubleshooting)
- [Français](https://help.akool.com/fr/avatar/troubleshooting)
- [简体中文](https://help.akool.com/zh-cn/avatar/troubleshooting)

## AKOOL Help Center

[All topics](https://help.akool.com/?hsLang=en)   ·   [Knowledge Base](https://akool.com/knowledge-base?hsLang=en)   ·   [API Docs](https://docs.akool.com/)   ·   [Contact support](https://help.akool.com/account-billing/help?hsLang=en)

[Home](https://help.akool.com/?hsLang=en) [Avatar](https://help.akool.com/avatar?hsLang=en)

Troubleshooting Common Issues

English

- [简体中文](https://help.akool.com/zh-cn/avatar/troubleshooting)
- [Español](https://help.akool.com/es/avatar/troubleshooting)
- [Français](https://help.akool.com/fr/avatar/troubleshooting)
- [English](https://help.akool.com/avatar/troubleshooting)

# **Troubleshooting Common Issues**

Use these tips to fix common issues with AKOOL Avatars, including the Talking Avatar tool and Motion Avatars (Beta).

## **Avatar Generation Fails**

- Note the task ID and any error message shown.
- Check that the avatar option you chose is available in your workspace. Custom-avatar options and limits vary by plan; see the [current plan comparison](https://akool.com/pricing?hsLang=en).
- If it still fails, email [support@akool.com](mailto:support@akool.com) with the task ID and error message.

## **Custom Avatar Doesn’t Look Lifelike**

**Likely cause:** a low-quality source video.

- Upload a high-quality video when creating a custom avatar.
- Or pick one of the pre-designed Studio Quality Avatars instead.

## **Uploaded Audio Is Rejected or Sounds Unclear**

**Likely cause:** an unsupported file format or an unclear recording.

- Use a supported format (e.g., MP3, WAV) and the accepted formats and limits shown in the audio uploader.
- Start with a clear recording for the best input quality.
- Alternatively, type your script and use Text-to-Speech instead of an audio file.

## **The Voice Doesn’t Fit Your Message**

- Explore the different provided Text-to-Speech voices to find the right tone.
- Upload your voice to create a voice clone for the avatar.

## **Motion Gestures Aren’t Available**

**Likely cause:** the selected avatar isn’t motion-enabled. Motion Avatars are in Beta, and only studio avatars with the motion icon support motion.

- Choose a studio avatar that shows the motion icon.
- Type your script, decide where the avatar should perform a motion, then choose a gesture such as Hand wave, Thumbs up, or Pump Fists.

---

## Related resources

- [Avatar FAQs](https://help.akool.com/avatar/faq?hsLang=en)
- [Talking Avatar Tool](https://help.akool.com/avatar/talking-avatar-tool?hsLang=en)
- [Motion Avatars (Beta) – Bring Your Avatar to Life!](https://help.akool.com/avatar/motion-avatar?hsLang=en)
- [Explore the AKOOL Knowledge Base](https://akool.com/knowledge-base?hsLang=en)
- [Contact support](https://help.akool.com/account-billing/help?hsLang=en)

[![akool\_logo\_grey](https://help.akool.com/hubfs/akool_logo_grey.png)](https://akool.com?hsLang=en)

en

- [English](https://help.akool.com/avatar/troubleshooting)
- [Español](https://help.akool.com/es/avatar/troubleshooting)
- [Français](https://help.akool.com/fr/avatar/troubleshooting)
- [简体中文](https://help.akool.com/zh-cn/avatar/troubleshooting)

[Privacy Policy](https://akool.com/privacy-policy?hsLang=en) [Terms of Service](https://akool.com/terms-of-service?hsLang=en)

© 2023-2026 AKOOL. All rights reserved.