LightFlow
LightFlow
Breadcrumbs

API Errors

The LightFlow API uses standard HTTP status codes to indicate the success or failure of an API call. The body of the response is in JSON with a format similar to the following:


Bash
{
  "message": "asset not found"
}

Asset processing errors

The asset object provides information on processing errors, for example:


Bash
{
  ...
  "assetError": {
    "code": 2404,
    "message": "Error downloading input file: remote server returned HTTP 404"
  }
  ...
}

Error Codes

General Errors

  • 1001: Unknown error

  • 1002: Error on asset creation

  • 1003: Error on asset processing

Storage Errors

  • 2001: Error downloading input file

  • 2002: Error downloading input file: could not connect to remote server

  • 2003: Input file is invalid or corrupt

  • 2004: Input file bitrate exceeds the allowed limit for trial accounts

  • 2005: Input file duration exceeds the allowed limit for trial accounts

  • 2006: Input file format is not valid for 4K: asset has a width below 2560 pixels

  • 2007: Storage credentials error

  • 24XX: Range (2400-24XX). Represents 

    HTTP 4XX error

     returned by remote server while attempting to download the input file:

    • 2401: Unauthorized (please review your bucket credentials)

    • 2403: Forbidden (your user does have not access to the resource)

    • 2404: Not found (the resource does not exist)

    • 2429: Too many requests (the external service is overloaded, try again later)

  • 25XX: Range (2500-25XX). Represents 

    HTTP 5XX error

     returned by remote server while attempting to download the input file:

    • 2500: Remote server problem (the external service is not responding, try again later or contact support)

    • 2503: Service unavailable (the external service is not responding, try again later or contact support)

    • 2504: Gateway timeout (the external service is not responding, try again later or contact support)

  • 2070: Error downloading subtitles

Brightcove Errors

  • 3001: Error connecting to Brightcove

  • 3002: Brightcove encoder: input file is invalid or corrupt

  • 3003: Reference Id assigned to this asset is already in use and could not be published in Brightcove

  • 3004: Brightcove encoder: Error creating the encoding profile for this asset

  • 3005: Error publishing asset on Brightcove

Packaging/Uploading Errors

  • 4001: Error uploading MP4 result files

  • 4002: Error uploading DASH result files

  • 4003: Error uploading HLS result files

  • 4004: Error connecting to upload server

  • 4013: Error uploading thumbnails

  • 4014: Error stitching video chunks

  • 4005: Unknown error preparing/uploading output files

Protection Errors

  • 2050: EZDRM response is not as expected

  • 2051: EZDRM request timed out

  • 2052: EZDRM request has too many redirects

  • 2053: EZDRM returned a general http error

  • 2054: EZDRM general request error

  • 2055: EZDRM request returned internal server error

  • 2060: Irdeto response is not as expected

  • 2061: Irdeto request timed out

  • 2062: Irdeto request has too many redirects

  • 2063: Irdeto returned a general http error

  • 2064: Irdeto general request error

  • 2065: Irdeto request returned internal server error

  • 2066: DRM protection not selected

Inference Errors

  • 6001: Error uploading inference results

LightFlow Encoder Errors

  • 7001: Error encoding input