soniox 2.3.1__tar.gz → 2.3.2__tar.gz

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

@@ -77,6 +77,15 @@ Examples:
 
 ---
 
+## [2.3.2] - 4 may 2026
+
+### Added
+
+- `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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soniox
-Version: 2.3.1
+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

{soniox-2.3.1 → 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.1 → 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.1 → soniox-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "soniox"
-version = "2.3.1"
+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.1 → 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.1 → 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.1 → 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."""