Resources
Troubleshooting
Find solutions to common problems and get back on track quickly with our troubleshooting guides.
General
Training Video and Audio File Size Limit
Training Video and Audio File Size Limit
If you see an error about file size, it means your training video or audio file is larger than the 750 MB limit.Tavus supports training videos and audio files up to 750 MB. This limit helps maintain a balance between quality and processing speed.
To reduce file size:
Tavus requires the H.264 codec for all uploads.
- Compress the file using video compression tools.
- Lower the resolution — 1080p is usually enough.
- Trim any extra content to shorten the video.
- Reduce the frame rate to around 30 fps.
Conversational Video Interface (CVI)
Replica Responding to Background Noise
Replica Responding to Background Noise
If the replica starts responding to background sounds, such as people talking nearby, it may be due to the absence of noise filtering.To resolve this, enable noise cancellation using Daily’s
updateInputSettings() method. For example:Learn more in the Daily SDK documentation.
Replica Is Not Joining the Conversation
Replica Is Not Joining the Conversation
This is a rare issue caused by an internal server problem. When it happens, our team is automatically notified and works to resolve it as quickly as possible.You can check the system status at status.tavus.io. We recommend checking periodically for updates if you encounter this error.
Replica
Personal Replica Creation Failed
Personal Replica Creation Failed
This error usually means your training video is missing the required consent statement or the statement wasn’t clearly spoken.To generate a digital replica using the Phoenix model, your video must include this line at the beginning, spoken clearly:
“I, [FULL NAME], am currently speaking and give consent to Tavus to create an AI clone of me by using the audio and video samples I provide. I understand that this AI clone can be used to create videos that look and sound like me.”Make sure to replace [FULL NAME] with your actual name. The consent must be easy to hear and can be spoken in any supported language. You can view the list of supported languages here.If your video didn’t include this, re-record it with the consent statement at the beginning, then submit a new request through the Developer Portal or API.
Poor Replica Quality
Poor Replica Quality
If your replica’s lip movements are noticeably out of sync, it may be due to issues with the training video format. Even if the video appears clean, AI-generated content or videos that don’t follow the expected structure can affect training quality.Common causes:
- The video does not follow the required recording format, which includes:
- 1 minute of talking
- 1 minute of silence
- Lips do not fully close during the talking segment, which limits the model’s ability to learn realistic lip movements.
- Record a new video following the correct structure (one minute of talking followed by one minute of silence).
- Speak naturally, allowing full lip movement including closures.
- Avoid using AI-generated videos for training.
Video Generation
Poor Video Generation Quality
Poor Video Generation Quality
If your video looks unnatural or has repeated gestures, it may be due to the script length. Videos over 5 minutes can lead to reduced movement variety and a less natural feel.To improve quality:
- Keep videos short – under 5 minutes is ideal.
- Break long scripts into smaller, focused segments.
- Tighten the script – remove filler and keep pacing steady.
- Use multiple replicas for variety in longer content.
- Review and revise – check for repetition and adjust as needed.
If the issue persists after following the troubleshooting guide above, please don’t hesitate to contact our support team for further assistance.