murf 1.1.1__tar.gz → 1.2.1__tar.gz

{murf-1.1.1 → murf-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: murf
-Version: 1.1.1
+Version: 1.2.1
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers
@@ -48,7 +48,7 @@ Description-Content-Type: text/markdown
 
 ## Overview
 
-The Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 13+ languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.
+The Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 21 languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.
 
 ---
 
@@ -89,9 +89,9 @@ For more detailed information, refer to the [official documentation](https://mur
 ## Features
 
 - **Text-to-Speech Conversion:** Transform text into natural-sounding speech.
-- **Multilingual Support:** Access voices in over 13 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, and Polish.
+- **Multilingual Support:** Access voices in over 21 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, Polish, Japanese, Turkish, Indonesian, Croatian, Greek, Romanian, Slovak, and Bulgarian.
 
-![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Lang.png)
+![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Languages_21.jpg)
 
 - **Multiple Voice Styles:** Choose from 20+ speaking styles to suit your application's needs.
 - **Advanced Voice Customization:** Adjust parameters like pitch, speed, pauses, and pronunciation for optimal output. Fine-grained controls let you tailor the voice output to match your specific requirements.

{murf-1.1.1 → murf-1.2.1}/README.md

@@ -22,7 +22,7 @@
 
 ## Overview
 
-The Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 13+ languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.
+The Murf Python SDK offers seamless integration with the [Murf AI](https://murf.ai/) [text-to-speech software](https://murf.ai/text-to-speech), enabling developers and creators to convert text into lifelike speech effortlessly. With over 130 natural-sounding voices across 21 languages and 20+ speaking styles, Murf provides unparalleled speech customization for a wide range of applications. The SDK is designed for both synchronous and asynchronous workflows, featuring robust error handling, advanced configuration options, and support for real-time applications.
 
 ---
 
@@ -63,9 +63,9 @@ For more detailed information, refer to the [official documentation](https://mur
 ## Features
 
 - **Text-to-Speech Conversion:** Transform text into natural-sounding speech.
-- **Multilingual Support:** Access voices in over 13 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, and Polish.
+- **Multilingual Support:** Access voices in over 21 languages, including English, French, German, Spanish, Italian, Hindi, Portuguese, Dutch, Korean, Chinese (Mandarin), Bengali, Tamil, Polish, Japanese, Turkish, Indonesian, Croatian, Greek, Romanian, Slovak, and Bulgarian.
 
-![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Lang.png)
+![Murf AI Languages](https://murf.ai/public-assets/home/Murf_Languages_21.jpg)
 
 - **Multiple Voice Styles:** Choose from 20+ speaking styles to suit your application's needs.
 - **Advanced Voice Customization:** Adjust parameters like pitch, speed, pauses, and pronunciation for optimal output. Fine-grained controls let you tailor the voice output to match your specific requirements.

{murf-1.1.1 → murf-1.2.1}/pyproject.toml

@@ -3,7 +3,7 @@ name = "murf"
 
 [tool.poetry]
 name = "murf"
-version = "1.1.1"
+version = "1.2.1"
 description = ""
 readme = "README.md"
 authors = []

{murf-1.1.1 → murf-1.2.1}/src/murf/__init__.py

@@ -9,6 +9,7 @@ from .types import (
     ApiVoice,
     ApiVoiceGender,
     AuthTokenResponse,
+    CharacterCount,
     DubApiDetailResponse,
     DubJobStatusResponse,
     FormDataContentDisposition,
@@ -16,11 +17,16 @@ from .types import (
     GroupApiProjectResponse,
     LocaleResponse,
     LocaleResponseSupportsItem,
+    Metadata,
+    MurfApiTranslationRequest,
+    MurfApiTranslationResponse,
     PronunciationDetail,
     PronunciationDetailType,
     SourceLocaleResponse,
+    SpeechToSpeechResponse,
     StyleDetails,
-    WordDuration,
+    Translation,
+    WordDurationResponse,
 )
 from .errors import (
     BadRequestError,
@@ -48,6 +54,7 @@ __all__ = [
     "AsyncMurf",
     "AuthTokenResponse",
     "BadRequestError",
+    "CharacterCount",
     "DubApiDetailResponse",
     "DubJobStatusResponse",
     "ForbiddenError",
@@ -58,7 +65,10 @@ __all__ = [
     "InternalServerError",
     "LocaleResponse",
     "LocaleResponseSupportsItem",
+    "Metadata",
     "Murf",
+    "MurfApiTranslationRequest",
+    "MurfApiTranslationResponse",
     "MurfDub",
     "MurfEnvironment",
     "PaymentRequiredError",
@@ -66,9 +76,11 @@ __all__ = [
     "PronunciationDetailType",
     "ServiceUnavailableError",
     "SourceLocaleResponse",
+    "SpeechToSpeechResponse",
     "StyleDetails",
+    "Translation",
     "UnauthorizedError",
-    "WordDuration",
+    "WordDurationResponse",
     "__version__",
     "auth",
     "dubbing",

{murf-1.1.1 → murf-1.2.1}/src/murf/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "murf",
-            "X-Fern-SDK-Version": "1.1.1",
+            "X-Fern-SDK-Version": "1.2.1",
         }
         if self._api_key is not None:
             headers["api-key"] = self._api_key

{murf-1.1.1 → murf-1.2.1}/src/murf/dubbing/jobs/client.py

@@ -2,8 +2,8 @@
 
 import typing
 from ...core.client_wrapper import SyncClientWrapper
-from .types.jobs_create_request_priority import JobsCreateRequestPriority
 from ... import core
+from .types.jobs_create_request_priority import JobsCreateRequestPriority
 from ...core.request_options import RequestOptions
 from ...types.api_job_response import ApiJobResponse
 from ...core.pydantic_utilities import parse_obj_as
@@ -30,12 +30,13 @@ class JobsClient:
         self,
         *,
         target_locales: typing.List[str],
-        priority: JobsCreateRequestPriority,
         file: typing.Optional[core.File] = OMIT,
         file_url: typing.Optional[str] = OMIT,
         source_locale: typing.Optional[str] = OMIT,
         webhook_url: typing.Optional[str] = OMIT,
         file_name: typing.Optional[str] = OMIT,
+        priority: typing.Optional[JobsCreateRequestPriority] = OMIT,
+        webhook_secret: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ApiJobResponse:
         """
@@ -44,9 +45,6 @@ class JobsClient:
         target_locales : typing.List[str]
             List of target locales
 
-        priority : JobsCreateRequestPriority
-            Priority of the job. Allowed values: LOW, NORMAL, HIGH
-
         file : typing.Optional[core.File]
             See core.File for more documentation
 
@@ -59,6 +57,11 @@ class JobsClient:
 
         file_name : typing.Optional[str]
 
+        priority : typing.Optional[JobsCreateRequestPriority]
+            Priority of the job. Allowed values: LOW, NORMAL, HIGH
+
+        webhook_secret : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -76,7 +79,6 @@ class JobsClient:
         )
         client.dubbing.jobs.create(
             target_locales=["target_locales"],
-            priority="LOW",
         )
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -89,6 +91,7 @@ class JobsClient:
                 "webhook_url": webhook_url,
                 "file_name": file_name,
                 "priority": priority,
+                "webhook_secret": webhook_secret,
             },
             files={
                 "file": file,
@@ -159,6 +162,7 @@ class JobsClient:
         webhook_url: typing.Optional[str] = OMIT,
         file_name: typing.Optional[str] = OMIT,
         priority: typing.Optional[JobsCreateWithProjectIdRequestPriority] = OMIT,
+        webhook_secret: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ApiJobResponse:
         """
@@ -179,6 +183,8 @@ class JobsClient:
         priority : typing.Optional[JobsCreateWithProjectIdRequestPriority]
             Priority of the job. Allowed values: LOW, NORMAL, HIGH
 
+        webhook_secret : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -207,6 +213,7 @@ class JobsClient:
                 "webhook_url": webhook_url,
                 "file_name": file_name,
                 "priority": priority,
+                "webhook_secret": webhook_secret,
             },
             files={
                 "file": file,
@@ -363,12 +370,13 @@ class AsyncJobsClient:
         self,
         *,
         target_locales: typing.List[str],
-        priority: JobsCreateRequestPriority,
         file: typing.Optional[core.File] = OMIT,
         file_url: typing.Optional[str] = OMIT,
         source_locale: typing.Optional[str] = OMIT,
         webhook_url: typing.Optional[str] = OMIT,
         file_name: typing.Optional[str] = OMIT,
+        priority: typing.Optional[JobsCreateRequestPriority] = OMIT,
+        webhook_secret: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ApiJobResponse:
         """
@@ -377,9 +385,6 @@ class AsyncJobsClient:
         target_locales : typing.List[str]
             List of target locales
 
-        priority : JobsCreateRequestPriority
-            Priority of the job. Allowed values: LOW, NORMAL, HIGH
-
         file : typing.Optional[core.File]
             See core.File for more documentation
 
@@ -392,6 +397,11 @@ class AsyncJobsClient:
 
         file_name : typing.Optional[str]
 
+        priority : typing.Optional[JobsCreateRequestPriority]
+            Priority of the job. Allowed values: LOW, NORMAL, HIGH
+
+        webhook_secret : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -414,7 +424,6 @@ class AsyncJobsClient:
         async def main() -> None:
             await client.dubbing.jobs.create(
                 target_locales=["target_locales"],
-                priority="LOW",
             )
 
 
@@ -430,6 +439,7 @@ class AsyncJobsClient:
                 "webhook_url": webhook_url,
                 "file_name": file_name,
                 "priority": priority,
+                "webhook_secret": webhook_secret,
             },
             files={
                 "file": file,
@@ -500,6 +510,7 @@ class AsyncJobsClient:
         webhook_url: typing.Optional[str] = OMIT,
         file_name: typing.Optional[str] = OMIT,
         priority: typing.Optional[JobsCreateWithProjectIdRequestPriority] = OMIT,
+        webhook_secret: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ApiJobResponse:
         """
@@ -520,6 +531,8 @@ class AsyncJobsClient:
         priority : typing.Optional[JobsCreateWithProjectIdRequestPriority]
             Priority of the job. Allowed values: LOW, NORMAL, HIGH
 
+        webhook_secret : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -556,6 +569,7 @@ class AsyncJobsClient:
                 "webhook_url": webhook_url,
                 "file_name": file_name,
                 "priority": priority,
+                "webhook_secret": webhook_secret,
             },
             files={
                 "file": file,

{murf-1.1.1 → murf-1.2.1}/src/murf/text_to_speech/client.py

@@ -54,6 +54,7 @@ class TextToSpeechClient:
             The text that is to be synthesised. e.g. 'Hello there [pause 1s] friend'
 
         voice_id : str
+            Use the GET /v1/speech/voices api to find supported voiceIds.
 
         audio_duration : typing.Optional[float]
             This parameter allows specifying the duration (in seconds) for the generated audio. If the value is 0, this parameter will be ignored. Only available for Gen2 model.
@@ -72,7 +73,7 @@ class TextToSpeechClient:
 
         multi_native_locale : typing.Optional[str]
             Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model.
-            Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speed/voices endpoint to retrieve the list of available voices and languages.
+            Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speech/voices endpoint to retrieve the list of available voices and languages.
 
         pitch : typing.Optional[int]
             Pitch of the voiceover
@@ -209,6 +210,152 @@ class TextToSpeechClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def stream(
+        self,
+        *,
+        text: str,
+        voice_id: str,
+        token: typing.Optional[str] = None,
+        channel_type: typing.Optional[str] = OMIT,
+        format: typing.Optional[str] = OMIT,
+        multi_native_locale: typing.Optional[str] = OMIT,
+        pitch: typing.Optional[int] = OMIT,
+        rate: typing.Optional[int] = OMIT,
+        sample_rate: typing.Optional[float] = OMIT,
+        style: typing.Optional[str] = OMIT,
+        variation: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Iterator[bytes]:
+        """
+        Returns a streaming output of generated audio
+
+        Parameters
+        ----------
+        text : str
+            The text that is to be synthesised. e.g. 'Hello there [pause 1s] friend'
+
+        voice_id : str
+            Use the GET /v1/speech/voices api to find supported voiceIds.
+
+        token : typing.Optional[str]
+
+        channel_type : typing.Optional[str]
+            Valid values: STEREO, MONO
+
+        format : typing.Optional[str]
+            Format of the generated audio file. Valid values: MP3, WAV
+
+        multi_native_locale : typing.Optional[str]
+            Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model.
+            Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speech/voices endpoint to retrieve the list of available voices and languages.
+
+        pitch : typing.Optional[int]
+            Pitch of the voiceover
+
+        rate : typing.Optional[int]
+            Speed of the voiceover
+
+        sample_rate : typing.Optional[float]
+            Valid values are 8000, 24000, 44100, 48000
+
+        style : typing.Optional[str]
+            The voice style to be used for voiceover generation.
+
+        variation : typing.Optional[int]
+            Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
+
+        Yields
+        ------
+        typing.Iterator[bytes]
+            Ok
+        """
+        with self._client_wrapper.httpx_client.stream(
+            "v1/speech/stream",
+            method="POST",
+            json={
+                "channelType": channel_type,
+                "format": format,
+                "multiNativeLocale": multi_native_locale,
+                "pitch": pitch,
+                "rate": rate,
+                "sampleRate": sample_rate,
+                "style": style,
+                "text": text,
+                "variation": variation,
+                "voiceId": voice_id,
+            },
+            headers={
+                "content-type": "application/json",
+                "token": str(token) if token is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        ) as _response:
+            try:
+                if 200 <= _response.status_code < 300:
+                    _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
+                    for _chunk in _response.iter_bytes(chunk_size=_chunk_size):
+                        yield _chunk
+                    return
+                _response.read()
+                if _response.status_code == 400:
+                    raise BadRequestError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 402:
+                    raise PaymentRequiredError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 403:
+                    raise ForbiddenError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 500:
+                    raise InternalServerError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 503:
+                    raise ServiceUnavailableError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                _response_json = _response.json()
+            except JSONDecodeError:
+                raise ApiError(status_code=_response.status_code, body=_response.text)
+            raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def get_voices(
         self, *, token: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[ApiVoice]:
@@ -331,6 +478,7 @@ class AsyncTextToSpeechClient:
             The text that is to be synthesised. e.g. 'Hello there [pause 1s] friend'
 
         voice_id : str
+            Use the GET /v1/speech/voices api to find supported voiceIds.
 
         audio_duration : typing.Optional[float]
             This parameter allows specifying the duration (in seconds) for the generated audio. If the value is 0, this parameter will be ignored. Only available for Gen2 model.
@@ -349,7 +497,7 @@ class AsyncTextToSpeechClient:
 
         multi_native_locale : typing.Optional[str]
             Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model.
-            Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speed/voices endpoint to retrieve the list of available voices and languages.
+            Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speech/voices endpoint to retrieve the list of available voices and languages.
 
         pitch : typing.Optional[int]
             Pitch of the voiceover
@@ -494,6 +642,152 @@ class AsyncTextToSpeechClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def stream(
+        self,
+        *,
+        text: str,
+        voice_id: str,
+        token: typing.Optional[str] = None,
+        channel_type: typing.Optional[str] = OMIT,
+        format: typing.Optional[str] = OMIT,
+        multi_native_locale: typing.Optional[str] = OMIT,
+        pitch: typing.Optional[int] = OMIT,
+        rate: typing.Optional[int] = OMIT,
+        sample_rate: typing.Optional[float] = OMIT,
+        style: typing.Optional[str] = OMIT,
+        variation: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.AsyncIterator[bytes]:
+        """
+        Returns a streaming output of generated audio
+
+        Parameters
+        ----------
+        text : str
+            The text that is to be synthesised. e.g. 'Hello there [pause 1s] friend'
+
+        voice_id : str
+            Use the GET /v1/speech/voices api to find supported voiceIds.
+
+        token : typing.Optional[str]
+
+        channel_type : typing.Optional[str]
+            Valid values: STEREO, MONO
+
+        format : typing.Optional[str]
+            Format of the generated audio file. Valid values: MP3, WAV
+
+        multi_native_locale : typing.Optional[str]
+            Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model.
+            Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speech/voices endpoint to retrieve the list of available voices and languages.
+
+        pitch : typing.Optional[int]
+            Pitch of the voiceover
+
+        rate : typing.Optional[int]
+            Speed of the voiceover
+
+        sample_rate : typing.Optional[float]
+            Valid values are 8000, 24000, 44100, 48000
+
+        style : typing.Optional[str]
+            The voice style to be used for voiceover generation.
+
+        variation : typing.Optional[int]
+            Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
+
+        Yields
+        ------
+        typing.AsyncIterator[bytes]
+            Ok
+        """
+        async with self._client_wrapper.httpx_client.stream(
+            "v1/speech/stream",
+            method="POST",
+            json={
+                "channelType": channel_type,
+                "format": format,
+                "multiNativeLocale": multi_native_locale,
+                "pitch": pitch,
+                "rate": rate,
+                "sampleRate": sample_rate,
+                "style": style,
+                "text": text,
+                "variation": variation,
+                "voiceId": voice_id,
+            },
+            headers={
+                "content-type": "application/json",
+                "token": str(token) if token is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        ) as _response:
+            try:
+                if 200 <= _response.status_code < 300:
+                    _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
+                    async for _chunk in _response.aiter_bytes(chunk_size=_chunk_size):
+                        yield _chunk
+                    return
+                await _response.aread()
+                if _response.status_code == 400:
+                    raise BadRequestError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 402:
+                    raise PaymentRequiredError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 403:
+                    raise ForbiddenError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 500:
+                    raise InternalServerError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                if _response.status_code == 503:
+                    raise ServiceUnavailableError(
+                        typing.cast(
+                            typing.Optional[typing.Any],
+                            parse_obj_as(
+                                type_=typing.Optional[typing.Any],  # type: ignore
+                                object_=_response.json(),
+                            ),
+                        )
+                    )
+                _response_json = _response.json()
+            except JSONDecodeError:
+                raise ApiError(status_code=_response.status_code, body=_response.text)
+            raise ApiError(status_code=_response.status_code, body=_response_json)
+
     async def get_voices(
         self, *, token: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[ApiVoice]:

{murf-1.1.1 → murf-1.2.1}/src/murf/types/__init__.py

@@ -8,6 +8,7 @@ from .api_project_response_dubbing_type import ApiProjectResponseDubbingType
 from .api_voice import ApiVoice
 from .api_voice_gender import ApiVoiceGender
 from .auth_token_response import AuthTokenResponse
+from .character_count import CharacterCount
 from .dub_api_detail_response import DubApiDetailResponse
 from .dub_job_status_response import DubJobStatusResponse
 from .form_data_content_disposition import FormDataContentDisposition
@@ -15,11 +16,16 @@ from .generate_speech_response import GenerateSpeechResponse
 from .group_api_project_response import GroupApiProjectResponse
 from .locale_response import LocaleResponse
 from .locale_response_supports_item import LocaleResponseSupportsItem
+from .metadata import Metadata
+from .murf_api_translation_request import MurfApiTranslationRequest
+from .murf_api_translation_response import MurfApiTranslationResponse
 from .pronunciation_detail import PronunciationDetail
 from .pronunciation_detail_type import PronunciationDetailType
 from .source_locale_response import SourceLocaleResponse
+from .speech_to_speech_response import SpeechToSpeechResponse
 from .style_details import StyleDetails
-from .word_duration import WordDuration
+from .translation import Translation
+from .word_duration_response import WordDurationResponse
 
 __all__ = [
     "ApiJobResponse",
@@ -30,6 +36,7 @@ __all__ = [
     "ApiVoice",
     "ApiVoiceGender",
     "AuthTokenResponse",
+    "CharacterCount",
     "DubApiDetailResponse",
     "DubJobStatusResponse",
     "FormDataContentDisposition",
@@ -37,9 +44,14 @@ __all__ = [
     "GroupApiProjectResponse",
     "LocaleResponse",
     "LocaleResponseSupportsItem",
+    "Metadata",
+    "MurfApiTranslationRequest",
+    "MurfApiTranslationResponse",
     "PronunciationDetail",
     "PronunciationDetailType",
     "SourceLocaleResponse",
+    "SpeechToSpeechResponse",
     "StyleDetails",
-    "WordDuration",
+    "Translation",
+    "WordDurationResponse",
 ]

murf-1.2.1/src/murf/types/character_count.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class CharacterCount(UniversalBaseModel):
+    total_source_text_length: typing.Optional[int] = None
+    total_translated_text_length: typing.Optional[int] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

{murf-1.1.1 → murf-1.2.1}/src/murf/types/generate_speech_response.py

@@ -2,37 +2,33 @@
 
 from ..core.pydantic_utilities import UniversalBaseModel
 import typing_extensions
-import typing
 from ..core.serialization import FieldMetadata
 import pydantic
-from .word_duration import WordDuration
+import typing
+from .word_duration_response import WordDurationResponse
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
 class GenerateSpeechResponse(UniversalBaseModel):
-    audio_file: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="audioFile")] = None
-    audio_length_in_seconds: typing_extensions.Annotated[
-        typing.Optional[float], FieldMetadata(alias="audioLengthInSeconds")
-    ] = None
-    consumed_character_count: typing_extensions.Annotated[
-        typing.Optional[int], FieldMetadata(alias="consumedCharacterCount")
-    ] = pydantic.Field(default=None)
+    audio_file: typing_extensions.Annotated[str, FieldMetadata(alias="audioFile")]
+    audio_length_in_seconds: typing_extensions.Annotated[float, FieldMetadata(alias="audioLengthInSeconds")]
+    consumed_character_count: typing_extensions.Annotated[int, FieldMetadata(alias="consumedCharacterCount")] = (
+        pydantic.Field()
+    )
     """
     Number of characters consumed so far in the current billing cycle.
     """
 
     encoded_audio: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="encodedAudio")] = None
-    remaining_character_count: typing_extensions.Annotated[
-        typing.Optional[int], FieldMetadata(alias="remainingCharacterCount")
-    ] = pydantic.Field(default=None)
+    remaining_character_count: typing_extensions.Annotated[int, FieldMetadata(alias="remainingCharacterCount")] = (
+        pydantic.Field()
+    )
     """
     Remaining number of characters available for synthesis in the current billing cycle.
     """
 
     warning: typing.Optional[str] = None
-    word_durations: typing_extensions.Annotated[
-        typing.Optional[typing.List[WordDuration]], FieldMetadata(alias="wordDurations")
-    ] = None
+    word_durations: typing_extensions.Annotated[typing.List[WordDurationResponse], FieldMetadata(alias="wordDurations")]
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

murf-1.2.1/src/murf/types/metadata.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .character_count import CharacterCount
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class Metadata(UniversalBaseModel):
+    character_count: typing.Optional[CharacterCount] = None
+    credits_used: typing.Optional[float] = None
+    target_language: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-1.2.1/src/murf/types/murf_api_translation_request.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing_extensions
+from ..core.serialization import FieldMetadata
+import pydantic
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class MurfApiTranslationRequest(UniversalBaseModel):
+    target_language: typing_extensions.Annotated[str, FieldMetadata(alias="targetLanguage")] = pydantic.Field()
+    """
+    The language code for the target translation
+    """
+
+    texts: typing.List[str] = pydantic.Field()
+    """
+    List of texts to translate
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-1.2.1/src/murf/types/murf_api_translation_response.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .metadata import Metadata
+from .translation import Translation
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class MurfApiTranslationResponse(UniversalBaseModel):
+    metadata: typing.Optional[Metadata] = None
+    translations: typing.Optional[typing.List[Translation]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-1.2.1/src/murf/types/speech_to_speech_response.py

@@ -0,0 +1,47 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import pydantic
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class SpeechToSpeechResponse(UniversalBaseModel):
+    audio_file: str = pydantic.Field()
+    """
+    The URL or path of the generated audio file.
+    """
+
+    audio_length_in_seconds: float = pydantic.Field()
+    """
+    Length of the generated audio in seconds.
+    """
+
+    encoded_audio: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Base64 encoded string of the generated audio. Used when audio is returned directly in the response.
+    """
+
+    remaining_character_count: int = pydantic.Field()
+    """
+    Remaining number of characters available for synthesis in the current billing cycle.
+    """
+
+    transcription: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Transcript of the generated audio, if transcription was requested.
+    """
+
+    warning: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Any warning or informational message related to the audio generation process.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-1.2.1/src/murf/types/translation.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class Translation(UniversalBaseModel):
+    source_text: typing.Optional[str] = None
+    translated_text: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-1.1.1/src/murf/types/word_duration.py → murf-1.2.1/src/murf/types/word_duration_response.py

@@ -4,19 +4,33 @@ from ..core.pydantic_utilities import UniversalBaseModel
 import typing_extensions
 import typing
 from ..core.serialization import FieldMetadata
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
-class WordDuration(UniversalBaseModel):
+class WordDurationResponse(UniversalBaseModel):
     end_ms: typing_extensions.Annotated[typing.Optional[int], FieldMetadata(alias="endMs")] = None
     pitch_scale_maximum: typing_extensions.Annotated[
         typing.Optional[float], FieldMetadata(alias="pitchScaleMaximum")
-    ] = None
+    ] = pydantic.Field(default=None)
+    """
+    This field has been deprecated.
+    """
+
     pitch_scale_minimum: typing_extensions.Annotated[
         typing.Optional[float], FieldMetadata(alias="pitchScaleMinimum")
-    ] = None
-    source_word_index: typing_extensions.Annotated[typing.Optional[int], FieldMetadata(alias="sourceWordIndex")] = None
+    ] = pydantic.Field(default=None)
+    """
+    This field has been deprecated.
+    """
+
+    source_word_index: typing_extensions.Annotated[typing.Optional[int], FieldMetadata(alias="sourceWordIndex")] = (
+        pydantic.Field(default=None)
+    )
+    """
+    This field has been deprecated.
+    """
+
     start_ms: typing_extensions.Annotated[typing.Optional[int], FieldMetadata(alias="startMs")] = None
     word: typing.Optional[str] = None
 

murf-1.2.1/src/murf/utils.py

@@ -0,0 +1,31 @@
+import hmac
+import hashlib
+import time
+
+def validate_hmac(secret: str, payload: str, timestamp_header: str, hmac_signature: str, tolerance_seconds: int):
+    """
+    Validate the HMAC signature of a payload against a secret key and timestamp.
+
+    Args:
+        secret (str): The secret key used for HMAC generation.
+        payload (str): The payload to validate.
+        timestamp_header (str): The timestamp header from the request.
+        hmac_signature (str): The HMAC signature to validate against.
+        tolerance_seconds (int): The allowed time tolerance in seconds.
+    """
+    try:
+        received_timestamp = int(timestamp_header) 
+        current_timestamp = int(time.time()) * 1000
+        if (abs(current_timestamp - received_timestamp) / 1000) > tolerance_seconds:
+            print("Timestamp is outside the allowed tolerance window.")
+            return False
+        data_to_sign = f"{payload}.{timestamp_header}"
+        calculated_hmac = hmac.new(
+            secret.encode('utf-8'),
+            data_to_sign.encode('utf-8'),
+            hashlib.sha256
+        ).hexdigest()
+        return hmac.compare_digest(calculated_hmac, hmac_signature)
+    except Exception as e:
+        print(f"Error validating HMAC: {e}")
+        return False