Skip to content
  • There are no suggestions because the search field is empty.

Common Issues and Solutions

Troubleshoot common problems and find effective solutions for smoother workflows.

Media Issues
Vub Issues
Other Issues


Media Issues

Most of the errors during media upload and processing are due to unsupported media formats. 

To get more information about the error, hover over “Error” in the Status column.

Screenshot 2025-03-27 at 15.40.57

Here are some of the most common errors and how to deal with them:

Error/Issue

Solution

Unsupported Frame Rate

Check the supported media formats page for details of the supported frame rates and ensure your media adheres to them.

Unsupported Color Space

Review the supported media formats to find the supported color spaces and make sure your media adheres to them.

Unsupported Aspect Ratio

The media aspect ratio is not supported currently. Check the supported media formats for details of the supported aspect ratios.

Too Long

Media exceeds the currently supported length. The currently supported maximum per media file is 1,440 frames.

NOTE: For Training Data files, the combined maximum is 5,000 frames.

Mismatched Frame Count

Make sure the Source file and Driving Data file have the exact same frame count and/or duration.

Mismatched Frame Rate

Make sure the Source file, Driving Data file and Training Data files have the same frame rate.

Invalid Container

The Media file is corrupted or cannot be read. You may need to recreate or re-export your media. Make sure it still meets the DeepEditor supported media formats.

Unable to upload Training data

You can only upload Training data for Standard, Professional and Theatrical quality vubs. Draft vubs use the Source file for training.

No Content Detected

The media file is missing its primary content (e.g. video file has no video). You may need to recreate or re-export your media. Make sure it still meets the media formats supported by DeepEditor .

No Performance Detected

Video does not have any faces in it. Check your media and make sure the media you upload has a face in it.

Failed Upload

Failed to upload media to storage. Please refresh and try again.

Failed Linking To Shot

Failed to link media to shot. Please refresh and try again.

Failed Authorize Upload

Failed to authorize upload for media. Please refresh and try again.

Failed Media Registration

Failed to register media. Please refresh and try again.

 

Vub issues

Error/Issue

Solution

No Token Error

This can happen if two vubs are kicked off at the same time for the same tenant (i.e. shared account) and compete for the last token.

Refinement page: the face mask is jumping between faces

DeepEditor can currently vub one face at a time, so your source media needs to have additional faces masked.

See How to Prepare Your Media for a Vub.

Render quality of vub is poor

Draft quality vub: no solution 

Standard quality vub and above: upload training data with the same lighting conditions + visible mouth interior

Vub failed

Check that the media you uploaded meets the DeepEditor Supported Media Formats, e.g.

  • Frame count and frame rate of Source and Driving Data are the same
  • Media is less than 1,440 frames

Vub result is poor

Check that the dialogue in your Driving Data file is clear and there is no music and sound effects in the audio.

Upload Training Data. This really helps DeepEditor createa better model of the character.

If there were Refinement changes made to the vub, review the applied keyframe overrides. Using fewer keyframes and lower blendshape values can often improve the results significantly.

Review the interpolation values to make sure that you use the original performance in sections where it does not need to be changed.

Other Issues

Cause

Solution

Unsupported Browser

DeepEditor only supports the Chrome Browser at the moment. We are working on supporting more browsers soon.

Unsupported audio file specifications

Make sure that the Audio Driving Data file you are uploading meets the following requirements:

Format: WAV

Codec: Uncompressed (Linear PCM)

Bit rate: 24-bit

Sampling: 48khz

Channels: Mono or Stereo