Developers Support Customer login
+1 800.513.1740
Media API Documentation   |   Sub Account API Documentation   |   Supported Source Media Formats   |   Sample Scripts    |   Recent Changes    |   Common Errors    |   Brightcove

The most common errors


When a media of a task got Error status, the description of the error is added.
The most common error messages are explained below.

Download/Upload Errors


Those errors may occur when the system tries to download a source file or to upload an encoded result (either by HTTP of FTP).

Couldn't resolve host - The system could not resolve DNS name of the host specified in source of destination URL.

The requested URL returned error: 404 - For the HTTP source – the server returns 404 not found error

The requested URL returned error: 401 - For the HTTP source – the server returns 401 not authorized error. May be wrong username/password are specified.

Failed to connect to host - The host is unreachable at the moment.

"Aborted" error


Aborted: Overtime limit (n) exceeded.
The error occurs when the task hangs at the encoding stage, and its execution time tops the estimated time by n seconds (the value can vary).

"Encoding was not completed" errors


Could not write header for output file (incorrect codec parameters ?) - The specified codec are not supported for this format, or need special parameters to be specified. For example: 3GP format require libamr_nb audio codec for correct encoding.

No audio or video streams available - You try to decode a video format that encoder does not understand. Just try again with another format.

Error while opening file - File may be corrupted or have an unsupported format.

Incorrect frame size - Error specifying size, e.g. 0x240

Frame size must be a multiple of 2 - When specifying size as WxH, both width and height must be multiple of 2.

Left (Right, Top, Bottom) crop size must be a multiple of 2

Error while opening codec for output stream - maybe incorrect parameters such as bit_rate, rate, width or height - The specified parameters such as bitrate, audio sampling rate or audio channels number are not allowed for the specified codec. Also, ofter this error appears when specified bitrate is too low.

Unknown encoder - Unknown or unsupported video/audio codec specified

Cannot allocate temp picture, check pix fmt - The frame size you specified is too large

Incorrect audio parameters such as bitrate, sample rate or channels - Some audio codecs (e.g. AAC or MPEG Layer 3) have their own limitation for options values. When you leave these options blank in your API request, encoding.com will get them from the source file, and not always their set will be correct for particular codec. So, it's better to always set audio codec parameters explicitly.