What causes a "read operation timed out" error?

Last updated: October 23, 2025

This error is a byproduct of a request taking longer than the default timeout value built into the Python SDK, which is 15 seconds.

This shouldn't be a common occurrence but to allow for the occasional slowdown this setting can be changed like this:

import assemblyai as aai

aai.settings.api_key = f"{ASSEMBLYAI_API_KEY}"
aai.settings.http_timeout = 30.0