Rate Limits

Every project has some rate limit defining how quickly you can submits API requests. This is configured per project, and you can reach out to your account manager to understand or increase this rate limit.

When you are past the rate limit, your API requests will get a HTTP 429 response.

{ return_code: 429, message: 'Project has been rate limited' }

When this happens, please slow down and submit at a slower rate.

Other Error Codes

Task responses will provide an error_code field. This field will give some more description as to what happened with the task.

Error Code

Error Name

Details

1000

GENERIC_ERROR

default error code

2000

DOWNLOAD_ERROR

default error code while downloading a file

2100

HTTP_ERROR

Usually incorrectly formatted url, expired signed url, or rate limiting by download server.

Can usually be resolved with resubmitting, or re-hosting or resolving download server issues then resubmitting.

This applies to most 21XX HTTP errors below

2101

HTTP_ERROR_MALFORMED_URL

2201

HTTP_CONNECTION_ERROR_ENOTFOUND

2202

HTTP_CONNECTION_ERROR_EAI_AGAIN

2203

HTTP_CONNECTION_ERROR_ECONNREFUSED

2204

HTTP_CONNECTION_ERROR_UNABLE_TO_VERIFY_LEAF_SIGNATURE

2205

HTTP_CONNECTION_ERROR_DEPTH_ZERO_SELF_SIGNED_CERT

2206

HTTP_CONNECTION_ERROR_HPE_INVALID_CONSTANT

2207

HTTP_CONNECTION_ERROR_HPE_UNEXPECTED_CONTENT_LENGTH

2208

HTTP_CONNECTION_ERROR_EHOSTUNREACH

2209

HTTP_CONNECTION_ERROR_CERT_HAS_EXPIRED

2210

HTTP_CONNECTION_ERROR_SELF_SIGNED_CERT_IN_CHAIN

2211

HTTP_CONNECTION_ERROR_ERR_SOCKET_BAD_PORT

2212

HTTP_CONNECTION_ERROR_MAX_REDIRECTS_EXCEEDED

2213

HTTP_CONNECTION_ERROR_ETIMEDOUT

3000

CLASSIFIER_ERROR

Usually infrequent. These are internal Hive errors that aren’t recommended to be fixed with resubmitting. Contact [email protected] if this happens frequently.

This applies to other errors in 3XXX and 4XXX category.

3100

CLASSIFIER_ERROR_UNSUPPORTED_MEDIA_TYPE

3200

CLASSIFIER_ERROR_INVALID_INPUT

3300

CLASSIFIER_ERROR_CORRUPT_FILE

3401

CLASSIFIER_ERROR_TIMEOUT

Classifier was not able to respond in time.Please try again later.

3500

CLASSIFIER_ERROR_SERVICE_UNAVAILABLE

Service temporarily overloaded or otherwise unavailable. Please try again later.

3501

CLASSIFIER_ERROR_RATE_LIMIT

Service is getting rate limited. Please slow down or try again later.

4000

PROJECT_SUBTASK_ERROR

4100

PROJECT_SUBTASK_FRAME_ERROR

These are internal Hive errors that aren’t recommended to be fixed with resubmitting. Contact [email protected] if this happens frequently.

5000

VIDEO_PROCESSING_ERROR

FFMPEG related media processor error. This may be fixed by transcoding and resubmitting the media.

5100

VIDEO_SPLIT_ERROR

Error while splitting video.
Can try transcoding and resubmitting, usually indicative of corrupt metadata with respect to number of available frames.

5101

SEGMENT_SPLIT_ERROR

Error while attempting to split audio

6000

INVALID_FILE_ERROR

General bad file error. This may be fixed from transcoding and resubmitting the media.

6100

INVALID_FILE_ERROR_UNSUPPORTED_MEDIA_TYPE

6200

INVALID_FILE_ERROR_INVALID_DIMENSIONS

6201

INVALID_FILE_ERROR_INVALID_WIDTH

Only applicable for APIs with max width constraint.

6202

INVALID_FILE_ERROR_INVALID_HEIGHT

Only applicable for APIs with max height constraint.

6400

INVALID_FILE_ERROR_INVALID_FILESIZE

Only applicable for APIs with max file size constraint.

6500

INVALID_FILE_ERROR_INVALID_DURATION

Shorten or fix file duration metadata and resubmit.

6600

INVALID_FILE_ERROR_INVALID_FPS

Transcode with corrected FPS metadata

6700

INVALID_FILE_ERROR_MISSING_AUDIO_STREAM

Can try transcoding and resubmitting with corrected audio stream.

6800

INVALID_FILE_ERROR_CLIENT_LOADING_FAILURE

For human-in-the-loop jobs using manual data labeling, the task could not be loaded on the client. Try using a browser friendly media format.

Examples:

{
  "id": "2605bbb0-55df-11eb-ab65-19b762122597",
  "project_id": 273259,
  "metadata": null,
  "error": "FileError: Unsupported File: video/x-flv is not supported",
  "error_code": 6100,
  "resent_on": "2021-01-13T20:38:09.760Z",
}
{
  "id": "c24af4e0-54b8-11eb-aad3-b9cbe32a1430",
  "project_id": 273259,
  "metadata": null,
  "error": "HttpConnectionError: Unable to access URL ECONNREFUSED | https:/invalid.url.example.com/",
  "error_code": 2203,
  "resent_on": "2021-01-13T20:46:54.710Z",
}