fix: set default polling interval to 3s

GitOrigin-RevId: 792a210f83e055f49b2404e40d902925aadf5a5b

Author: s0h3yl

README.md

@@ -222,7 +222,7 @@ questions = [
 
 results = transcript.lemur.question(questions)
 
-for result in result:
+for result in results:
     print(f"Question: {result.question}")
     print(f"Answer: {result.answer}")
 ```
@@ -531,3 +531,13 @@ The synchronous approach halts the application's flow until the transcription ha
 The asynchronous approach allows the application to continue running while the transcription is being processed. The caller receives a [`concurrent.futures.Future`](https://docs.python.org/3/library/concurrent.futures.html) object which can be used to check the status of the transcription at a later time.
 
 You can identify those two approaches by the `_async` suffix in the `Transcriber`'s method name (e.g. `transcribe` vs `transcribe_async`).
+
+## Polling Intervals
+
+By default we poll the `Transcript`'s status each `3s`. In case you would like to adjust that interval:
+
+```python
+import assemblyai as aai
+
+aai.settings.polling_interval = 1.0
+```

assemblyai/transcriber.py

@@ -77,7 +77,7 @@ def wait_for_completion(self) -> Self:
             ):
                 break
 
-            time.sleep(3)
+            time.sleep(self._client.settings.polling_interval)
 
         return self
 

assemblyai/types.py

@@ -1,7 +1,7 @@
 from enum import Enum
 from typing import Any, Dict, List, Optional, Sequence, Tuple, Union
 
-from pydantic import BaseModel, BaseSettings, Extra
+from pydantic import BaseModel, BaseSettings, Extra, Field
 from typing_extensions import Self
 
 
@@ -37,6 +37,9 @@ class Settings(BaseSettings):
     base_url: str = "https://api.assemblyai.com/v2"
     "The base URL for the AssemblyAI API"
 
+    polling_interval: float = Field(default=3.0, gte=0.1)
+    "The default polling interval for long-running requests (e.g. polling the `Transcript`'s status)"
+
     class Config:
         env_prefix = "assemblyai_"