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 file | This error indicates that there was an internal issue training your Replica. Please reach out to support for assitance |
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 | 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 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 | here 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 | Please reach out to support to better understand issues that occur during the training process. |