soniox 2.3.0__tar.gz → 2.3.2__tar.gz

{soniox-2.3.0 → soniox-2.3.2}/CHANGELOG.md

@@ -77,11 +77,34 @@ Examples:
 
 ---
 
-## [3.0.0] - 22 apr 2026
+## [2.3.2] - 4 may 2026
 
 ### Added
 
-- Added TTS support for REST and websocket APIs.
+- `single_use` and `max_session_duration_seconds` parameters on `client.auth.create_temporary_api_key()` (and the async variant).
+- `tts_rt` value for `TemporaryApiKeyUsageType`, allowing temporary API keys to be scoped to realtime TTS.
+
+---
+
+## [2.3.1] - 29 apr 2026
+
+### Changed
+
+- Default TTS model is now `tts-rt-v1` (previously `tts-rt-v1-preview`).
+
+---
+
+## [2.3.0] - 22 apr 2026
+
+### Added
+
+- Text-to-Speech (TTS) support, available on both `SonioxClient` and `AsyncSonioxClient`.
+- REST TTS API via `client.tts`: `generate()` returns audio bytes, `generate_to_file()` writes audio to a path or file-like object. Configurable `voice`, `model`, `language`, `audio_format`, `sample_rate`, and `bitrate`.
+- TTS model listing via `client.tts_models.list()`.
+- Realtime TTS over websocket via `client.realtime.tts.connect(...)`: stream text in with `send_text_chunk` / `send_text_chunks` / `finish`, receive audio with `receive_audio_chunks` or raw events with `receive_events`, plus `cancel`, `pause`, `resume`, and `keep_alive`.
+- Multiplexed realtime TTS via `client.realtime.tts.connect_multi_stream()`: run multiple concurrent TTS streams over a single websocket connection using `open_stream`.
+- New TTS examples for sync and async clients (REST, realtime, and multiplexed realtime).
+- `tts_api_base_url` and `tts_websocket_base_url` client options for overriding TTS endpoints.
 
 ---
 

{soniox-2.3.0 → soniox-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soniox
-Version: 2.3.0
+Version: 2.3.2
 Summary: The official Python SDK for the Soniox API (STT, REST)
 Project-URL: Homepage, https://sonoix.com
 Project-URL: Documentation, https://soniox.com/docs
@@ -80,7 +80,7 @@ output_file = output_file_for_audio_format("wav", "tts_sync_output")
 written = client.tts.generate_to_file(
     output_file,
     text="Hello from Soniox Python SDK Text-to-Speech.",
-    model="tts-rt-v1-preview",
+    model="tts-rt-v1",
     language="en",
     voice="Adrian",
     audio_format="wav",
@@ -133,7 +133,7 @@ from soniox.types import RealtimeTTSConfig
 client = SonioxClient()
 config = RealtimeTTSConfig(
     stream_id=f"sync-{uuid4()}",
-    model="tts-rt-v1-preview",
+    model="tts-rt-v1",
     language="en",
     voice="Adrian",
     audio_format="wav",

{soniox-2.3.0 → soniox-2.3.2}/README.md

@@ -43,7 +43,7 @@ output_file = output_file_for_audio_format("wav", "tts_sync_output")
 written = client.tts.generate_to_file(
     output_file,
     text="Hello from Soniox Python SDK Text-to-Speech.",
-    model="tts-rt-v1-preview",
+    model="tts-rt-v1",
     language="en",
     voice="Adrian",
     audio_format="wav",
@@ -96,7 +96,7 @@ from soniox.types import RealtimeTTSConfig
 client = SonioxClient()
 config = RealtimeTTSConfig(
     stream_id=f"sync-{uuid4()}",
-    model="tts-rt-v1-preview",
+    model="tts-rt-v1",
     language="en",
     voice="Adrian",
     audio_format="wav",

{soniox-2.3.0 → soniox-2.3.2}/docs/async_client.md

@@ -1129,7 +1129,7 @@ AsyncAuthAPI(client: AsyncSonioxClient)
 ### create_temporary_api_key()
 
 ```python
-create_temporary_api_key(*, usage_type: TemporaryApiKeyUsageType = 'transcribe_websocket', expires_in_seconds: int = 5 * 60, client_reference_id: str | None = None) -> CreateTemporaryApiKeyResponse
+create_temporary_api_key(*, usage_type: TemporaryApiKeyUsageType = 'transcribe_websocket', expires_in_seconds: int = 5 * 60, client_reference_id: str | None = None, single_use: bool | None = None, max_session_duration_seconds: int | None = None) -> CreateTemporaryApiKeyResponse
 ```
 
 Create a temporary API key.
@@ -1143,6 +1143,8 @@ Performs a POST request to ``/auth/temporary-api-key``.
 | `usage_type` | `TemporaryApiKeyUsageType` | Intended usage of the temporary API key. |
 | `expires_in_seconds` | `int` | Duration in seconds until the temporary API key expires |
 | `client_reference_id` | `str \| None` | Optional tracking identifier string. Does not need to be unique |
+| `single_use` | `bool \| None` | When true, restricts the temporary API key to a single use. |
+| `max_session_duration_seconds` | `int \| None` | Maximum connection duration in seconds for WebSocket and TTS HTTP streaming endpoints. |
 
 **Returns**
 

{soniox-2.3.0 → soniox-2.3.2}/docs/types.md

@@ -75,6 +75,8 @@ Payload for requesting a temporary API key (e.g., websocket).
 | `usage_type` | `TemporaryApiKeyUsageType` | Intended usage of the temporary API key. |
 | `expires_in_seconds` | `int` | Duration in seconds until the temporary API key expires |
 | `client_reference_id` | `str \| None` | Optional tracking identifier string. Does not need to be unique |
+| `single_use` | `bool \| None` | When true, restricts the temporary API key to a single use. |
+| `max_session_duration_seconds` | `int \| None` | Maximum connection duration in seconds for WebSocket and TTS HTTP streaming endpoints. |
 
 ---
 
@@ -557,7 +559,7 @@ Represents a Text-to-Speech voice.
 ## TemporaryApiKeyUsageType
 
 ```python
-TemporaryApiKeyUsageType = Literal["transcribe_websocket"]
+TemporaryApiKeyUsageType = Literal["transcribe_websocket", "tts_rt"]
 ```
 
 Intended usage for temporary API keys.

{soniox-2.3.0 → soniox-2.3.2}/examples/async_soniox_client/tts_api_example.py

@@ -5,7 +5,7 @@ from soniox.errors import SonioxAPIError
 from soniox.types import TtsAudioFormat
 from soniox.utils import output_file_for_audio_format
 
-MODEL = "tts-rt-v1-preview"
+MODEL = "tts-rt-v1"
 LANGUAGE = "en"
 VOICE = "Adrian"
 AUDIO_FORMAT: TtsAudioFormat = "wav"

{soniox-2.3.0 → soniox-2.3.2}/examples/async_soniox_client/tts_realtime_example.py

@@ -7,7 +7,7 @@ from soniox.errors import SonioxRealtimeError
 from soniox.types import RealtimeTTSConfig, TtsAudioFormat
 from soniox.utils import output_file_for_audio_format
 
-MODEL = "tts-rt-v1-preview"
+MODEL = "tts-rt-v1"
 LANGUAGE = "en"
 VOICE = "Maya"
 AUDIO_FORMAT: TtsAudioFormat = "wav"

{soniox-2.3.0 → soniox-2.3.2}/examples/async_soniox_client/tts_realtime_multiplexed_example.py

@@ -6,7 +6,7 @@ from soniox.client import AsyncSonioxClient
 from soniox.types import RealtimeTTSConfig, TtsAudioFormat
 from soniox.utils import output_file_for_audio_format
 
-MODEL = "tts-rt-v1-preview"
+MODEL = "tts-rt-v1"
 AUDIO_FORMAT: TtsAudioFormat = "wav"
 
 STREAM_SPECS = {

{soniox-2.3.0 → soniox-2.3.2}/examples/soniox_client/tts_api_example.py

@@ -3,7 +3,7 @@ from soniox.errors import SonioxAPIError
 from soniox.types import TtsAudioFormat
 from soniox.utils import output_file_for_audio_format
 
-MODEL = "tts-rt-v1-preview"
+MODEL = "tts-rt-v1"
 LANGUAGE = "en"
 VOICE = "Adrian"
 AUDIO_FORMAT: TtsAudioFormat = "wav"

{soniox-2.3.0 → soniox-2.3.2}/examples/soniox_client/tts_realtime_example.py

@@ -7,7 +7,7 @@ from soniox.errors import SonioxRealtimeError
 from soniox.types import RealtimeTTSConfig, TtsAudioFormat
 from soniox.utils import output_file_for_audio_format, start_text_thread
 
-MODEL = "tts-rt-v1-preview"
+MODEL = "tts-rt-v1"
 LANGUAGE = "en"
 VOICE = "Adrian"
 AUDIO_FORMAT: TtsAudioFormat = "wav"

{soniox-2.3.0 → soniox-2.3.2}/examples/soniox_client/tts_realtime_multiplexed_example.py

@@ -7,7 +7,7 @@ from soniox.client import SonioxClient
 from soniox.types import RealtimeTTSConfig, TtsAudioFormat
 from soniox.utils import output_file_for_audio_format, start_text_thread
 
-MODEL = "tts-rt-v1-preview"
+MODEL = "tts-rt-v1"
 AUDIO_FORMAT: TtsAudioFormat = "wav"
 
 STREAM_SPECS = {

{soniox-2.3.0 → soniox-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "soniox"
-version = "2.3.0"
+version = "2.3.2"
 dependencies = ["httpx>0.25.0", "websockets>11.0", "pydantic>2"]
 requires-python = ">=3.10"
 authors = [{ name = "Soniox", email = "support@soniox.com" }]

{soniox-2.3.0 → soniox-2.3.2}/src/soniox/api/async_auth.py

@@ -23,6 +23,8 @@ class AsyncAuthAPI:
         usage_type: TemporaryApiKeyUsageType = "transcribe_websocket",
         expires_in_seconds: int = 5 * 60,
         client_reference_id: str | None = None,
+        single_use: bool | None = None,
+        max_session_duration_seconds: int | None = None,
     ) -> CreateTemporaryApiKeyResponse:
         """
         Create a temporary API key.
@@ -36,6 +38,8 @@ class AsyncAuthAPI:
             usage_type=usage_type,
             expires_in_seconds=expires_in_seconds,
             client_reference_id=client_reference_id,
+            single_use=single_use,
+            max_session_duration_seconds=max_session_duration_seconds,
         )
         response = await self._client.request(
             "POST", "/auth/temporary-api-key", json=payload.model_dump(exclude_none=True)

{soniox-2.3.0 → soniox-2.3.2}/src/soniox/api/async_tts.py

@@ -10,7 +10,7 @@ if TYPE_CHECKING:
     from ..client import AsyncSonioxClient
 
 
-DEFAULT_MODEL = "tts-rt-v1-preview"
+DEFAULT_MODEL = "tts-rt-v1"
 DEFAULT_VOICE = "Adrian"
 DEFAULT_LANGUAGE = "en"
 DEFAULT_AUDIO_FORMAT: TtsAudioFormat = "wav"

{soniox-2.3.0 → soniox-2.3.2}/src/soniox/api/auth.py

@@ -23,6 +23,8 @@ class AuthAPI:
         usage_type: TemporaryApiKeyUsageType = "transcribe_websocket",
         expires_in_seconds: int = 5 * 60,
         client_reference_id: str | None = None,
+        single_use: bool | None = None,
+        max_session_duration_seconds: int | None = None,
     ) -> CreateTemporaryApiKeyResponse:
         """
         Create a temporary API key.
@@ -36,6 +38,8 @@ class AuthAPI:
             usage_type=usage_type,
             expires_in_seconds=expires_in_seconds,
             client_reference_id=client_reference_id,
+            single_use=single_use,
+            max_session_duration_seconds=max_session_duration_seconds,
         )
         response = self._client.request(
             "POST", "/auth/temporary-api-key", json=payload.model_dump(exclude_none=True)

{soniox-2.3.0 → soniox-2.3.2}/src/soniox/api/tts.py

@@ -10,7 +10,7 @@ if TYPE_CHECKING:
     from ..client import SonioxClient
 
 
-DEFAULT_MODEL = "tts-rt-v1-preview"
+DEFAULT_MODEL = "tts-rt-v1"
 DEFAULT_VOICE = "Adrian"
 DEFAULT_LANGUAGE = "en"
 DEFAULT_AUDIO_FORMAT: TtsAudioFormat = "wav"

{soniox-2.3.0 → soniox-2.3.2}/src/soniox/types/api.py

@@ -17,7 +17,7 @@ TranscriptionMode = Literal["real_time", "async"]
 TranslationType = Literal["one_way", "two_way"]
 """Supported translation configuration types."""
 
-TemporaryApiKeyUsageType = Literal["transcribe_websocket"]
+TemporaryApiKeyUsageType = Literal["transcribe_websocket", "tts_rt"]
 """Intended usage for temporary API keys."""
 
 TtsAudioFormat = Literal[
@@ -346,6 +346,12 @@ class CreateTemporaryApiKeyPayload(BaseModel):
     client_reference_id: str | None = Field(default=None, max_length=256)
     """Optional tracking identifier string. Does not need to be unique"""
 
+    single_use: bool | None = None
+    """When true, restricts the temporary API key to a single use."""
+
+    max_session_duration_seconds: int | None = Field(default=None, ge=1, le=18000)
+    """Maximum connection duration in seconds for WebSocket and TTS HTTP streaming endpoints."""
+
 
 class CreateTemporaryApiKeyResponse(BaseModel):
     """Response data for a temp API key request."""