| 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 face training footage 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 face training footage 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 face training footage 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 face 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 face training footage 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 | Legacy error from older video-training flows that used a spoken consent phrase. Re-record your training footage following current video training requirements and ensure you have the necessary rights and permissions - see Platform Policies. |
| 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 any time |
| 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 face 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 face. 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 face. 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 face. 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 face. 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 face. 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 face. 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 face. 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 face training. Please ensure the lighting is as even as possible. |
| teeth_not_visible | There was a quality issue with your face. 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. |
