# Source: https://docs.tavus.io/sections/errors-and-status-details.md

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors and Status Details

> Identify errors and status details encountered when using the Tavus platform.

## Replica Training Errors

| Error Type                       | Error Message                                                                                                                                                                                                                                                                    | Additional Information                                                                                                                                                                                                                                                                                                       |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| download\_link                   | There was an issue downloading your video file. Please ensure that the link you provided is correct and try again                                                                                                                                                                | Tavus was not able to download the video from the provided link. Please ensure the link you provide is a hosted url download link                                                                                                                                                                                            |
| file\_size                       | The video file you provided exceeds the maximum file size allowed. Please ensure that the video is less than 750MB and try again.                                                                                                                                                | All video files must be smaller than 750mb                                                                                                                                                                                                                                                                                   |
| video\_format                    | There was an issue processing your training video. The video provided is not a .mp4 file. Please ensure that the training video is a .mp4 file encoded using h.264                                                                                                               | All Replica training and consent video files must be .mp4                                                                                                                                                                                                                                                                    |
| video\_codec                     | There was an issue processing your training video. The video provided is not encoded using h.264. Please ensure that the training video is a .mp4 file encoded using h.264                                                                                                       | All Replica training and consent video files must be encoded using h.264                                                                                                                                                                                                                                                     |
| video\_codec\_and\_format        | There was an issue processing your training video. Please ensure that the training video is a .mp4 file encoded using h.264                                                                                                                                                      | All Replica training and consent video files must be .mp4 and encoded using h.264                                                                                                                                                                                                                                            |
| video\_duration                  | There was an issue processing your training video. The video provided does not meet the minimum duration requirement for training                                                                                                                                                | All Replica training files must be at least 1 minute long. (Between 1.5 to 2 minutes is optimal.)                                                                                                                                                                                                                            |
| video\_fps                       | There was an issue processing your training video. The video provided does not meet the minimum frame rate requirement for a training video. Please ensure your training video has a frame rate of at least 25fps                                                                | All Replica training and consent video files must have a frame rate of at least 25fps                                                                                                                                                                                                                                        |
| consent\_phrase\_mismatch        | There was an issue processing your training file: Your consent phrase does not match our requirements. Please follow our specified format closely                                                                                                                                | There was an issue with the consent phrase provided. Please review our consent guidelines and resubmit a new training with the correct consent statement                                                                                                                                                                     |
| face\_or\_obstruction\_detected  | There was an issue processing your training file: More than one face detected or obstructions present. Please ensure only your face is visible and clear                                                                                                                         | Your face must be present in all frames of the video and may not be obstructed at anytime                                                                                                                                                                                                                                    |
| lighting\_change\_detected       | There was an issue processing your training file: Lighting changes detected. Ensure your face is evenly lit throughout the video                                                                                                                                                 | Please ensure that the lighting of your face is consistent throughout the entire video                                                                                                                                                                                                                                       |
| background\_noise\_detected      | There was an issue processing your training file: Background noise or other voices detected. Please record in a quiet environment with only your voice                                                                                                                           | The video must be recorded in a quiet environment with only your voice present                                                                                                                                                                                                                                               |
| video\_editing\_detected         | There was an issue processing your training file: Video appears edited or contains cuts. Please submit an unedited, continuous video                                                                                                                                             | The video must be unedited and recorded in one take                                                                                                                                                                                                                                                                          |
| community\_guidelines\_violation | There was an issue processing your training file: Video violates Community Guidelines. Please review our guidelines and resubmit your video                                                                                                                                      | Please ensure that your training video does not violate our community guidelines                                                                                                                                                                                                                                             |
| video\_processing                | There was an error processing your training video. Face not detected because it appeared too small in the frame or it was occluded. Please edit or record a new video and ensure your face is clearly visible and occupies a larger portion of the frame.                        | This error occurs when the face appears too small relative to the background or if a full body video is recorded in horizontal format instead of vertical. Please ensure your face is clearly visible and occupies a larger portion of the frame.                                                                            |
| video\_processing                | There was an error processing your training video file. Please check your video format and make sure it not damaged and could be played correctly.                                                                                                                               | This error indicates there may be an issue with the video file format or the file may be corrupted. Please verify the video can be played correctly and resubmit.                                                                                                                                                            |
| excessive\_movement\_detected    | There was an issue processing your training file: Excessive movement detected. Please ensure you are sitting still and centered in the frame                                                                                                                                     | This error indicates that the model is having difficulty tracking the face from frame to frame. Could be related to movement of the subject or the camera. In some cases, it may also be related to obstructions such as superimposed graphics.                                                                              |
| audio\_processing                | There was an error processing the audio in the provided training video file.                                                                                                                                                                                                     | This error indicates that the audio processing step was interrupted. In edge cases, may be related to the replica name's length or characters.                                                                                                                                                                               |
| quality\_issue\_detected         | Quality issue detected. For details and assistance, please reach out to Tavus support via [developer-support@tavus.io](mailto:developer-support@tavus.io)                                                                                                                        | This error indicates a quality problem with the input video that has resulted in poor test output. One example cause could be input video quality under 720p. Please review the quality checklist to make sure you have met all requirements and/or reach out to [support@tavus.io](mailto:support@tavus.io) for assistance. |
| hands\_obstructing\_face         | There was a quality issue with your replica. The user's hand obstructed the face during recording. Please edit your video or record a new training video and keep hands away from the face.                                                                                      | Please ensure that the user's face is visible throughout the entire video.                                                                                                                                                                                                                                                   |
| second\_person\_detected         | There was a quality issue with your replica. A second person or face was detected in the frame. Please edit your video or record a new video with no one else in the background.                                                                                                 | Please ensure that there is only a single user in the training video.                                                                                                                                                                                                                                                        |
| improper\_distance               | There was a quality issue with your replica. The user was either too close to or too far from the camera. Please review our documentation on proper framing and distance before editing your video or recording a new video.                                                     | Please ensure the user is centered in the training video.                                                                                                                                                                                                                                                                    |
| inconsistent\_distance           | There was a quality issue with your replica. The user's distance from the camera changed during the recording. Please edit or record a new training video and remain at a consistent distance from the camera for the entire video.                                              | Please ensure the user stays in the same spot throughout the training video.                                                                                                                                                                                                                                                 |
| face\_turned\_away               | There was a quality issue with your replica.  User's face turned away from the camera. Please edit or record a new video and ensure you are facing directly toward the camera for the entire duration.                                                                           | The face should be centered on the camera the entire duration of the training video.                                                                                                                                                                                                                                         |
| improper\_camera\_angle          | There was a quality issue with your replica. The camera angle was either too low or too high. Please record a new video with the camera angle at eye level.                                                                                                                      | Please ensure the camera is at eye level.                                                                                                                                                                                                                                                                                    |
| poor\_lighting                   | There was a quality issue with your replica. The user's face was not clearly visible due to poor lighting or heavy shadows. Please edit or record a new video with even lighting on your face, avoiding shadows or dim environments.                                             | Shadows and uneven lighting cause distortions during replica training. Please ensure the lighting is as even as possible.                                                                                                                                                                                                    |
| teeth\_not\_visible              | There was a quality issue with your replica. The top and bottom teeth were not clearly visible during recording, either due to poor lighting or obstruction. Please edit your video or record a new training video with better lighting and ensure your teeth are fully visible. | A large smile at the beginning helps the training process capture your natural teeth.                                                                                                                                                                                                                                        |
| other\_quality\_issue            | Quality issue was detected. For details and assistance, please reach out to Tavus support via [support@tavus.io](mailto:support@tavus.io)                                                                                                                                        | Please reach out to support to better understand issues that occur during the training process.                                                                                                                                                                                                                              |

## Video Errors

| Error Type                    | Error Message                                                                                                                                                                                                               | Additional Information                                                                                                                                                               |   |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | - |
| video\_error                  | An error occurred while generating this request. Please check your inputs or try your request again                                                                                                                         | Tavus ran into an issue generating the video. Please ensure that the your inputs are valid and try again. If this issue PermissionStatus, please reach out to support for assistance |   |
| replica\_in\_error\_state     | Request Failed: The replica {} is currently in an 'error' state and cannot process requests. For details on the cause of the error and how to resolve it, please review the specific information provided for this replica. | Please ensure that the Replica being used to generate videos is in a 'ready' state                                                                                                   |   |
| audio\_file\_max\_size        | There was an issue generating your video. The audio file exceeds the maximum file size of 750MB.                                                                                                                            | The audio file provided is too large. Please ensure that the audio file is less than 750MB and try again.                                                                            |   |
| audio\_file\_type             | There was an issue generating your video. The audio file provided is not a .wav                                                                                                                                             | Currently, we only support .wav audio files for generating videos. Please ensure that the audio file is a .wav file and try again.                                                   |   |
| audio\_file\_min\_duration    | There was an issue generating your video. The duration of the audio file does not reach the minimum duration requirement of 3 seconds.                                                                                      | The audio file provided is too short.                                                                                                                                                |   |
| audio\_file\_max\_duration    | There was an issue generating your video. The duration of the audio file exceeds the maximum duration of 10 minutes.                                                                                                        | The audio file is too long.                                                                                                                                                          |   |
| audio\_file\_ download\_link  | There was an issue generating your video. We were unable to download your audio file. Please ensure that the link you provided is correct and try again.                                                                    | Please ensure that the link you provide is a hosted url download link that is publicly accessible.                                                                                   |   |
| script\_community\_guidelines | Request has failed as the script violates community guidelines.                                                                                                                                                             | Please ensure that the script's contents do not violate our community guidelines.                                                                                                    |   |

## Video Status Details

| Status Type           | Status Details                                                                                                                                                                                                                                                                                  | Additional Information                                                                                         |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| video\_success        | Your request has processed successfully!                                                                                                                                                                                                                                                        | The video has been generated successfully and is ready for use                                                 |
| video\_queued         | This request is currently queued. It should begin processing in a few minutes.                                                                                                                                                                                                                  | Immediately upon submitting a request for video generation, the video will be added to a queue to be processed |
| replica\_in\_training | The training process for replica {} is still ongoing. Your request has been placed in the 'queued' status and will automatically proceed to the generation phase once training is complete. To monitor the current progress of the training, please review the detailed status of this replica. | Videos will not start generating until the Replica being used has finished training                            |