Streaming API Error Codes

Configuration Errors

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

Error Code	Description
E0100	The WebSocket request could not be parsed as valid JSON. The Hume API requires JSON serializable payloads.
E0101	You 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.
E0102	The 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.
E0200	Media 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 reach out to [email protected]
E0201	Media 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.
E0202	No 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.
E0203	Your 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.
E0204	Your video file was too long. For best performance we recommend passing individual frames of video as images rather than full video files.
E0205	Your 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.
E0206	Your 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.
E0300	You've run out of credits. Go to beta.hume.ai to purchase more.

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 you can reach out to [email protected].

Error Code	Description
I0100	Unexpected service error
I0101	Unexpected service error
I0102	Unexpected service error
I0103	Unexpected service error

Warnings

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

Error Code	Description
W0101	No vocal bursts could be detected in the streamed media.
W0102	No face meshes could be detected in the streamed media.
W0103	No faces could be detected in the streamed media.
W0104	No emotional language could be detected in the streamed media.
W0105	No speech could be detected in the streamed media.