murf 1.0.0__py3-none-any.whl

murf/errors/__init__.py

@@ -0,0 +1,17 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .bad_request_error import BadRequestError
+from .forbidden_error import ForbiddenError
+from .internal_server_error import InternalServerError
+from .payment_required_error import PaymentRequiredError
+from .service_unavailable_error import ServiceUnavailableError
+from .unauthorized_error import UnauthorizedError
+
+__all__ = [
+    "BadRequestError",
+    "ForbiddenError",
+    "InternalServerError",
+    "PaymentRequiredError",
+    "ServiceUnavailableError",
+    "UnauthorizedError",
+]

murf/errors/bad_request_error.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.api_error import ApiError
+import typing
+
+
+class BadRequestError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any]):
+        super().__init__(status_code=400, body=body)

murf/errors/forbidden_error.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.api_error import ApiError
+import typing
+
+
+class ForbiddenError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any]):
+        super().__init__(status_code=403, body=body)

murf/errors/internal_server_error.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.api_error import ApiError
+import typing
+
+
+class InternalServerError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any]):
+        super().__init__(status_code=500, body=body)

murf/errors/payment_required_error.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.api_error import ApiError
+import typing
+
+
+class PaymentRequiredError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any]):
+        super().__init__(status_code=402, body=body)

murf/errors/service_unavailable_error.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.api_error import ApiError
+import typing
+
+
+class ServiceUnavailableError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any]):
+        super().__init__(status_code=503, body=body)

murf/errors/unauthorized_error.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.api_error import ApiError
+import typing
+
+
+class UnauthorizedError(ApiError):
+    def __init__(self, body: typing.Optional[typing.Any]):
+        super().__init__(status_code=401, body=body)

murf/text_to_speech/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import GenerateSpeechRequestModelVersion
+
+__all__ = ["GenerateSpeechRequestModelVersion"]

murf/text_to_speech/client.py

@@ -0,0 +1,592 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ..core.client_wrapper import SyncClientWrapper
+from .types.generate_speech_request_model_version import GenerateSpeechRequestModelVersion
+from ..types.pronunciation_detail import PronunciationDetail
+from ..core.request_options import RequestOptions
+from ..types.generate_speech_response import GenerateSpeechResponse
+from ..core.serialization import convert_and_respect_annotation_metadata
+from ..core.pydantic_utilities import parse_obj_as
+from ..errors.bad_request_error import BadRequestError
+from ..errors.payment_required_error import PaymentRequiredError
+from ..errors.forbidden_error import ForbiddenError
+from ..errors.internal_server_error import InternalServerError
+from ..errors.service_unavailable_error import ServiceUnavailableError
+from json.decoder import JSONDecodeError
+from ..core.api_error import ApiError
+from ..types.api_voice import ApiVoice
+from ..core.client_wrapper import AsyncClientWrapper
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class TextToSpeechClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def generate(
+        self,
+        *,
+        text: str,
+        voice_id: str,
+        audio_duration: typing.Optional[float] = OMIT,
+        channel_type: typing.Optional[str] = OMIT,
+        encode_as_base_64: typing.Optional[bool] = OMIT,
+        format: typing.Optional[str] = OMIT,
+        model_version: typing.Optional[GenerateSpeechRequestModelVersion] = OMIT,
+        multi_native_locale: typing.Optional[str] = OMIT,
+        pitch: typing.Optional[int] = OMIT,
+        pronunciation_dictionary: typing.Optional[typing.Dict[str, PronunciationDetail]] = 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,
+    ) -> GenerateSpeechResponse:
+        """
+        Returns a url to the generated audio file along with other associated properties.
+
+        Parameters
+        ----------
+        text : str
+            The text that is to be synthesised. e.g. 'Hello there [pause 1s] friend'
+
+        voice_id : str
+
+        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.
+
+        channel_type : typing.Optional[str]
+            Valid values: STEREO, MONO
+
+        encode_as_base_64 : typing.Optional[bool]
+            Set to true to receive audio in response as a Base64 encoded string instead of a url.
+
+        format : typing.Optional[str]
+            Format of the generated audio file. Valid values: MP3, WAV, FLAC, ALAW, ULAW
+
+        model_version : typing.Optional[GenerateSpeechRequestModelVersion]
+            Valid values: GEN1, GEN2. Use GEN2 to generate audio using new and advanced model. Outputs from Gen 2 will sound better, but different from the old model
+
+        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.
+
+        pitch : typing.Optional[int]
+            Pitch of the voiceover
+
+        pronunciation_dictionary : typing.Optional[typing.Dict[str, PronunciationDetail]]
+            An object used to define custom pronunciations.
+
+             Example 1: {"live":{"type": "IPA", "pronunciation": "laɪv"}}.
+
+             Example 2: {"2022":{"type": "SAY_AS", "pronunciation": "twenty twenty two"}}
+
+        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.
+
+        Returns
+        -------
+        GenerateSpeechResponse
+            Ok
+
+        Examples
+        --------
+        from murf import Murf
+
+        client = Murf(
+            api_key="YOUR_API_KEY",
+        )
+        client.text_to_speech.generate(
+            text="Hello, world!",
+            voice_id="en-US-natalie",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/speech/generate",
+            method="POST",
+            json={
+                "audioDuration": audio_duration,
+                "channelType": channel_type,
+                "encodeAsBase64": encode_as_base_64,
+                "format": format,
+                "modelVersion": model_version,
+                "multiNativeLocale": multi_native_locale,
+                "pitch": pitch,
+                "pronunciationDictionary": convert_and_respect_annotation_metadata(
+                    object_=pronunciation_dictionary,
+                    annotation=typing.Dict[str, PronunciationDetail],
+                    direction="write",
+                ),
+                "rate": rate,
+                "sampleRate": sample_rate,
+                "style": style,
+                "text": text,
+                "variation": variation,
+                "voiceId": voice_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    GenerateSpeechResponse,
+                    parse_obj_as(
+                        type_=GenerateSpeechResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            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]:
+        """
+        Returns a list of available voices for speech synthesis
+
+        Parameters
+        ----------
+        token : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[ApiVoice]
+            Ok
+
+        Examples
+        --------
+        from murf import Murf
+
+        client = Murf(
+            api_key="YOUR_API_KEY",
+        )
+        client.text_to_speech.get_voices()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/speech/voices",
+            method="GET",
+            headers={
+                "token": str(token) if token is not None else None,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[ApiVoice],
+                    parse_obj_as(
+                        type_=typing.List[ApiVoice],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            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 == 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)
+
+
+class AsyncTextToSpeechClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def generate(
+        self,
+        *,
+        text: str,
+        voice_id: str,
+        audio_duration: typing.Optional[float] = OMIT,
+        channel_type: typing.Optional[str] = OMIT,
+        encode_as_base_64: typing.Optional[bool] = OMIT,
+        format: typing.Optional[str] = OMIT,
+        model_version: typing.Optional[GenerateSpeechRequestModelVersion] = OMIT,
+        multi_native_locale: typing.Optional[str] = OMIT,
+        pitch: typing.Optional[int] = OMIT,
+        pronunciation_dictionary: typing.Optional[typing.Dict[str, PronunciationDetail]] = 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,
+    ) -> GenerateSpeechResponse:
+        """
+        Returns a url to the generated audio file along with other associated properties.
+
+        Parameters
+        ----------
+        text : str
+            The text that is to be synthesised. e.g. 'Hello there [pause 1s] friend'
+
+        voice_id : str
+
+        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.
+
+        channel_type : typing.Optional[str]
+            Valid values: STEREO, MONO
+
+        encode_as_base_64 : typing.Optional[bool]
+            Set to true to receive audio in response as a Base64 encoded string instead of a url.
+
+        format : typing.Optional[str]
+            Format of the generated audio file. Valid values: MP3, WAV, FLAC, ALAW, ULAW
+
+        model_version : typing.Optional[GenerateSpeechRequestModelVersion]
+            Valid values: GEN1, GEN2. Use GEN2 to generate audio using new and advanced model. Outputs from Gen 2 will sound better, but different from the old model
+
+        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.
+
+        pitch : typing.Optional[int]
+            Pitch of the voiceover
+
+        pronunciation_dictionary : typing.Optional[typing.Dict[str, PronunciationDetail]]
+            An object used to define custom pronunciations.
+
+             Example 1: {"live":{"type": "IPA", "pronunciation": "laɪv"}}.
+
+             Example 2: {"2022":{"type": "SAY_AS", "pronunciation": "twenty twenty two"}}
+
+        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.
+
+        Returns
+        -------
+        GenerateSpeechResponse
+            Ok
+
+        Examples
+        --------
+        import asyncio
+
+        from murf import AsyncMurf
+
+        client = AsyncMurf(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.text_to_speech.generate(
+                text="Hello, world!",
+                voice_id="en-US-natalie",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/speech/generate",
+            method="POST",
+            json={
+                "audioDuration": audio_duration,
+                "channelType": channel_type,
+                "encodeAsBase64": encode_as_base_64,
+                "format": format,
+                "modelVersion": model_version,
+                "multiNativeLocale": multi_native_locale,
+                "pitch": pitch,
+                "pronunciationDictionary": convert_and_respect_annotation_metadata(
+                    object_=pronunciation_dictionary,
+                    annotation=typing.Dict[str, PronunciationDetail],
+                    direction="write",
+                ),
+                "rate": rate,
+                "sampleRate": sample_rate,
+                "style": style,
+                "text": text,
+                "variation": variation,
+                "voiceId": voice_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    GenerateSpeechResponse,
+                    parse_obj_as(
+                        type_=GenerateSpeechResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            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]:
+        """
+        Returns a list of available voices for speech synthesis
+
+        Parameters
+        ----------
+        token : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[ApiVoice]
+            Ok
+
+        Examples
+        --------
+        import asyncio
+
+        from murf import AsyncMurf
+
+        client = AsyncMurf(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.text_to_speech.get_voices()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/speech/voices",
+            method="GET",
+            headers={
+                "token": str(token) if token is not None else None,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[ApiVoice],
+                    parse_obj_as(
+                        type_=typing.List[ApiVoice],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            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 == 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)

murf/text_to_speech/types/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .generate_speech_request_model_version import GenerateSpeechRequestModelVersion
+
+__all__ = ["GenerateSpeechRequestModelVersion"]