Video Application Status Messages

Status messages returned by the video API.

Status Message

Code Type

Description

INITIATED

Status

Once Verity has checked that the URL is properly formed and does not already exist in the cache, the request is passed to the Verity classification systems and the status updates to INITIATED.

DOWNLOADING

Status

The Verity classification system is downloading the video for processing.

ANALYZING

Status

The Verity classification system is analyzing text and images extracted from the video to identify the following:

  • IAB categories

  • Keywords

  • Threats

  • Sentiments

PROCESSED

Status

The video has been processed and the Verity analysis JSON is available.

VIDEO_DOWNLOAD_FAILED

Application Error

The video could not be downloaded. Please reach out to Verity support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

{ "uuid": "486b4a12-e2a3-5eef-8310-68bb38f6379e", "url": "https://host.com/some/video.mp4", "errors": [ { "reason": "VIDEO_DOWNLOAD_FAILED" } ] }

 

VIDEO_TRANSCRIPTION_FAILED

Application Error

Generating a video transcription failed. In such cases, Verity may rely on just the visual component to provide classification results. Please reach out to Verity support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

{ "uuid": "486b4a12-e2a3-5eef-8310-68bb38f6379e", "url": "https://host.com/some/video.mp4", "errors": [ { "reason": "VIDEO_TRANSCRIPTION_FAILED" } ] }

 

VIDEO_OCR_FAILED

Application Error

Optical Character Recognition failed for the provided video. Note that OCR is an optional step in our process. Receiving this code is rare, but if encountered, please reach out to Verity support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

{ "uuid": "486b4a12-e2a3-5eef-8310-68bb38f6379e", "url": "https://host.com/some/video.mp4", "errors": [ { "reason": "VIDEO_OCR_FAILED" } ] }

 

VIDEO_NOT_FOUND

Application Error

The provided uuid is not associated with a video. Please verify that the correct uuid provided by Verity is used.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

LANGUAGE_NOT_SUPPORTED

Application Error

The inferred language of a transcription is not supported by Verity. In such cases, Verity may rely on just the visual component to provide classification results.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

LANGUAGE_DETECTION_FAILED

Application Error

There was an error inferring the language of a transcription. In such cases, Verity may rely on just the visual component to provide classification results.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

VIDEO_CLASSIFICATION_FAILED

Application Error

There was a problem processing a video. Please reach out to Verity support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

URL_MUST_NOT_BE_EMPTY

Validation Error

The provided url was empty. This can apply to a callbackUrl or url field.

Response HTTP Code
HTTP/1.1: 400
Example Invalid Request

 

URL_MALFORMED

Validation Error

The provided url was malformed. This can apply to a callbackUrl or url field.

Response HTTP Code
HTTP/1.1: 400
Example Invalid Request

 

URL_MISSING_HTTP_PROTOCOL

Validation Error

The provided url did not include an HTTP schema. This can apply to a callbackUrl or url.

Response HTTP Code
HTTP/1.1: 400
Example Invalid Request

 

 


The contents of these documents and any attachments contain GumGum, Inc. confidential information and are legally protected from disclosure.