Streaming API: Error Codes

Configuration Errors

Configuration errors indicate that something about the API call was not configured correctly.

Error CodeDescription
E0100The WebSocket request could not be parsed as valid JSON. The Hume API requires JSON serializable payloads.
E0101You may be missing or improperly formatting a required field. This generic error indicates that the structure of your WebSocket request was invalid. Please see the error message you received in the API response for more details.
E0102The requested model was incompatible with the file format received. Some models are not compatible with every file type. For example, no facial expressions will be detected in a text file. Audio can be extracted out of some video files, but if the video has no audio, then models like Speech Prosody and Vocal Burst will not be available.
E0200Media provided could not be parsed into a known file format. The streaming API supports a wide range of file formats and media types including audio, video, image, text, but not all formats are supported. If you receive this error and believe your file type should be supported please visit dev.hume.ai/docs/support.
E0201Media could not be decoded as a Base64 encoded string. The data field in the streaming request payload should be Base64 encoded bytes. If you want to pass raw text without encoding it you can do so with the raw_text parameter.
E0202No audio signal could be inferred from the media provided. This error indicates that audio models were configured, but the media provided could not be parsed into a valid audio file.
E0203Your audio file was too long. The limit is 5000 milliseconds. The streaming API is intended for near real-time processing of data streams. For larger files considering using the Hume batch API.
E0204Your video file was too long. For best performance we recommend passing individual frames of video as images rather than full video files.
E0205Your image file was too large. The limit is 3,000 x 3,000 pixels. The streaming API is intended for near real-time processing of data streams. For larger files considering using the Hume batch API.
E0206Your text file was too long. The limit is 10,000 characters. The streaming API is intended for near real-time processing of data streams. For larger files considering using the Hume batch API.
E0300You've run out of credits. Go to beta.hume.ai to purchase more.

📘

The connection will be closed automatically after ten identical configuration errors to avoid unintended looping.

Service Errors

Service errors indicate that there was an unexpected failure in a Hume service. There may be an outage or you may have come across a bug. If you receive any of these error codes, please visit dev.hume.ai/docs/support.

Error CodeDescription
I0100Unexpected service error
I0101Unexpected service error
I0102Unexpected service error
I0103Unexpected service error
I0104Unexpected service error
I0105Unexpected service error

Warnings

Warnings indicate that the streaming payload was configured correctly, but no results could be returned.

Error CodeDescription
W0101No vocal bursts could be detected in the streamed media.
W0102No face meshes could be detected in the streamed media.
W0103No faces could be detected in the streamed media.
W0104No emotional language could be detected in the streamed media.
W0105No speech could be detected in the streamed media.