Troubleshooting
API Errors and Status Details
Troubleshooting
API Errors and Status Details
This guide includes an overview of errors and status details you might see from the API
Replica Training Errors
| Error Type | Error Message | Description |
|---|---|---|
| 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. |
Video Errors
| Error Type | Error Message | Description | |
|---|---|---|---|
| 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. |
Lipsync Errors
| Error Type | Error Message | Description |
|---|---|---|
| download_link | There was an issue downloading your file. Please ensure that the link you provided is correct and try again | Tavus was not able to download the file from the provided link. Please ensure the link you provide is a hosted url download link that is publicly accessible. |
| media_duration_too_short | There was an issue generating your video. The duration of the media file does not reach the minimum duration requirement of 3 seconds. | The media file provided is too short. Please ensure that the file meets the minimum duration requirement. |
| media_duration_too_long | There was an issue generating your video. The duration of the media file exceeds the maximum duration of 5 minutes. | The media file provided is too long. Please ensure that the file does not exceed the maximum duration. |
| video_format | There was an issue processing your video. Please ensure that the video format is supported and is listed in our documentation | The video format is not supported. Please refer to our documentation for a list of supported video formats. |
| audio_format | There was an issue processing your audio. Please ensure that the audio format is supported and is listed in our documentation | The audio format is not supported. Please refer to our documentation for a list of supported audio formats. |
| 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 lipsync video. Please ensure that your inputs are valid and try again. If this issue persists, please reach out to support for assistance. |
Video Status Details
| Status Type | Status Details | Description |
|---|---|---|
| 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 |