speechify-api 0.0.145__py3-none-any.whl

speechifyinc/tts/voices/client.py

@@ -0,0 +1,559 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ...core.client_wrapper import SyncClientWrapper
+from ...core.request_options import RequestOptions
+from ..types.get_voice import GetVoice
+from ...core.pydantic_utilities import parse_obj_as
+from ..errors.not_found_error import NotFoundError
+from ..errors.internal_server_error import InternalServerError
+from json.decoder import JSONDecodeError
+from ...core.api_error import ApiError
+from .types.voices_create_request_gender import VoicesCreateRequestGender
+from ... import core
+from ..types.created_voice import CreatedVoice
+from ..errors.bad_request_error import BadRequestError
+from ..errors.payment_required_error import PaymentRequiredError
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.client_wrapper import AsyncClientWrapper
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class VoicesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[GetVoice]:
+        """
+        Gets the list of voices available for the user
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[GetVoice]
+            A list of voices
+
+        Examples
+        --------
+        from speechifyinc import Speechify
+
+        client = Speechify(
+            token="YOUR_TOKEN",
+        )
+        client.tts.voices.list()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/voices",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[GetVoice],
+                    parse_obj_as(
+                        type_=typing.List[GetVoice],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    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(),
+                        ),
+                    )
+                )
+            _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 create(
+        self,
+        *,
+        name: str,
+        gender: VoicesCreateRequestGender,
+        sample: core.File,
+        consent: str,
+        locale: typing.Optional[str] = OMIT,
+        avatar: typing.Optional[core.File] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CreatedVoice:
+        """
+        Create a personal (cloned) voice for the user
+
+        Parameters
+        ----------
+        name : str
+            Name of the personal voice
+
+        gender : VoicesCreateRequestGender
+            Gender marker for the personal voice
+            male GenderMale
+            female GenderFemale
+            notSpecified GenderNotSpecified
+
+        sample : core.File
+            See core.File for more documentation
+
+        consent : str
+            A **string** representing the user consent information in JSON format
+            This should include the fullName and email of the consenting individual.
+            For example, `{"fullName": "John Doe", "email": "john@example.com"}`
+
+        locale : typing.Optional[str]
+            Native language (locale) of the personal voice (e.g. en-US, es-ES, etc.)
+
+        avatar : typing.Optional[core.File]
+            See core.File for more documentation
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreatedVoice
+            A created voice
+
+        Examples
+        --------
+        from speechifyinc import Speechify
+
+        client = Speechify(
+            token="YOUR_TOKEN",
+        )
+        client.tts.voices.create(
+            name="name",
+            gender="male",
+            consent="consent",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/voices",
+            method="POST",
+            data={
+                "name": name,
+                "locale": locale,
+                "gender": gender,
+                "consent": consent,
+            },
+            files={
+                "sample": sample,
+                "avatar": avatar,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    CreatedVoice,
+                    parse_obj_as(
+                        type_=CreatedVoice,  # 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 == 500:
+                raise InternalServerError(
+                    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 delete(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Delete a personal (cloned) voice
+
+        Parameters
+        ----------
+        id : str
+            The ID of the voice to delete
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from speechifyinc import Speechify
+
+        client = Speechify(
+            token="YOUR_TOKEN",
+        )
+        client.tts.voices.delete(
+            id="id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/voices/{jsonable_encoder(id)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            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 == 404:
+                raise NotFoundError(
+                    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(),
+                        ),
+                    )
+                )
+            _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 AsyncVoicesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[GetVoice]:
+        """
+        Gets the list of voices available for the user
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[GetVoice]
+            A list of voices
+
+        Examples
+        --------
+        import asyncio
+
+        from speechifyinc import AsyncSpeechify
+
+        client = AsyncSpeechify(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tts.voices.list()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/voices",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[GetVoice],
+                    parse_obj_as(
+                        type_=typing.List[GetVoice],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    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(),
+                        ),
+                    )
+                )
+            _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 create(
+        self,
+        *,
+        name: str,
+        gender: VoicesCreateRequestGender,
+        sample: core.File,
+        consent: str,
+        locale: typing.Optional[str] = OMIT,
+        avatar: typing.Optional[core.File] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CreatedVoice:
+        """
+        Create a personal (cloned) voice for the user
+
+        Parameters
+        ----------
+        name : str
+            Name of the personal voice
+
+        gender : VoicesCreateRequestGender
+            Gender marker for the personal voice
+            male GenderMale
+            female GenderFemale
+            notSpecified GenderNotSpecified
+
+        sample : core.File
+            See core.File for more documentation
+
+        consent : str
+            A **string** representing the user consent information in JSON format
+            This should include the fullName and email of the consenting individual.
+            For example, `{"fullName": "John Doe", "email": "john@example.com"}`
+
+        locale : typing.Optional[str]
+            Native language (locale) of the personal voice (e.g. en-US, es-ES, etc.)
+
+        avatar : typing.Optional[core.File]
+            See core.File for more documentation
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreatedVoice
+            A created voice
+
+        Examples
+        --------
+        import asyncio
+
+        from speechifyinc import AsyncSpeechify
+
+        client = AsyncSpeechify(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tts.voices.create(
+                name="name",
+                gender="male",
+                consent="consent",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/voices",
+            method="POST",
+            data={
+                "name": name,
+                "locale": locale,
+                "gender": gender,
+                "consent": consent,
+            },
+            files={
+                "sample": sample,
+                "avatar": avatar,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    CreatedVoice,
+                    parse_obj_as(
+                        type_=CreatedVoice,  # 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 == 500:
+                raise InternalServerError(
+                    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 delete(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Delete a personal (cloned) voice
+
+        Parameters
+        ----------
+        id : str
+            The ID of the voice to delete
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from speechifyinc import AsyncSpeechify
+
+        client = AsyncSpeechify(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tts.voices.delete(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/voices/{jsonable_encoder(id)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            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 == 404:
+                raise NotFoundError(
+                    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(),
+                        ),
+                    )
+                )
+            _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)

speechifyinc/tts/voices/types/__init__.py

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

speechifyinc/tts/voices/types/voices_create_request_gender.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+VoicesCreateRequestGender = typing.Union[typing.Literal["male", "female", "notSpecified"], typing.Any]

speechifyinc/version.py

@@ -0,0 +1,3 @@
+from importlib import metadata
+
+__version__ = metadata.version("speechify-api")