# This file was auto-generated by Fern from our API Definition. import typing import urllib.parse from json.decoder import JSONDecodeError from .. import core from ..core.api_error import ApiError from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper from ..core.jsonable_encoder import jsonable_encoder from ..core.remove_none_from_dict import remove_none_from_dict from ..core.request_options import RequestOptions from ..errors.unprocessable_entity_error import UnprocessableEntityError from ..types.add_project_response_model import AddProjectResponseModel from ..types.get_projects_response import GetProjectsResponse from ..types.http_validation_error import HttpValidationError from ..types.project_extended_response_model import ProjectExtendedResponseModel from ..types.project_snapshots_response import ProjectSnapshotsResponse from ..types.pronunciation_dictionary_version_locator import PronunciationDictionaryVersionLocator try: import pydantic.v1 as pydantic # type: ignore except ImportError: import pydantic # type: ignore # this is used as the default value for optional parameters OMIT = typing.cast(typing.Any, ...) class ProjectsClient: def __init__(self, *, client_wrapper: SyncClientWrapper): self._client_wrapper = client_wrapper def get_all(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetProjectsResponse: """ Returns a list of your projects together and its metadata. Parameters: - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.get_all() """ _response = self._client_wrapper.httpx_client.request( "GET", urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "v1/projects"), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(GetProjectsResponse, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 add( self, *, name: str, from_url: typing.Optional[str] = None, from_document: typing.Optional[core.File] = None, default_title_voice_id: str, default_paragraph_voice_id: str, default_model_id: str, quality_preset: typing.Optional[str] = None, title: typing.Optional[str] = None, author: typing.Optional[str] = None, isbn_number: typing.Optional[str] = None, acx_volume_normalization: typing.Optional[bool] = None, volume_normalization: typing.Optional[bool] = None, pronunciation_dictionary_locators: typing.List[str], callback_url: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None, ) -> AddProjectResponseModel: """ Creates a new project, it can be either initialized as blank, from a document or from a URL. Parameters: - name: str. The name of the project, used for identification only. - from_url: typing.Optional[str]. An optional URL from which we will extract content to initialize the project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the project as blank. - from_document: typing.Optional[core.File]. See core.File for more documentation - default_title_voice_id: str. The voice_id that corresponds to the default voice used for new titles. - default_paragraph_voice_id: str. The voice_id that corresponds to the default voice used for new paragraphs. - default_model_id: str. The model_id of the model to be used for this project, you can query GET https://api.elevenlabs.io/v1/models to list all available models. - quality_preset: typing.Optional[str]. Output quality of the generated audio. Must be one of: standard - standard output format, 128kbps with 44.1kHz sample rate. high - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side. Using this setting increases the character cost by 20%. ultra - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. Using this setting increases the character cost by 50%. - title: typing.Optional[str]. An optional name of the author of the project, this will be added as metadata to the mp3 file on project / chapter download. - author: typing.Optional[str]. An optional name of the author of the project, this will be added as metadata to the mp3 file on project / chapter download. - isbn_number: typing.Optional[str]. An optional ISBN number of the project you want to create, this will be added as metadata to the mp3 file on project / chapter download. - acx_volume_normalization: typing.Optional[bool]. [Deprecated] When the project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements - volume_normalization: typing.Optional[bool]. When the project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements - pronunciation_dictionary_locators: typing.List[str]. A list of pronunciation dictionary locators (id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody - callback_url: typing.Optional[str]. A url that will be called by our service when the project is converted with a json containing the status of the conversion - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.add() """ _response = self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "v1/projects/add"), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), data=jsonable_encoder( remove_none_from_dict( { "name": name, "from_url": from_url, "default_title_voice_id": default_title_voice_id, "default_paragraph_voice_id": default_paragraph_voice_id, "default_model_id": default_model_id, "quality_preset": quality_preset, "title": title, "author": author, "isbn_number": isbn_number, "acx_volume_normalization": acx_volume_normalization, "volume_normalization": volume_normalization, "pronunciation_dictionary_locators": pronunciation_dictionary_locators, "callback_url": callback_url, } ) ) if request_options is None or request_options.get("additional_body_parameters") is None else { **jsonable_encoder( remove_none_from_dict( { "name": name, "from_url": from_url, "default_title_voice_id": default_title_voice_id, "default_paragraph_voice_id": default_paragraph_voice_id, "default_model_id": default_model_id, "quality_preset": quality_preset, "title": title, "author": author, "isbn_number": isbn_number, "acx_volume_normalization": acx_volume_normalization, "volume_normalization": volume_normalization, "pronunciation_dictionary_locators": pronunciation_dictionary_locators, "callback_url": callback_url, } ) ), **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))), }, files=core.convert_file_dict_to_httpx_tuples(remove_none_from_dict({"from_document": from_document})), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(AddProjectResponseModel, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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( self, project_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> ProjectExtendedResponseModel: """ Returns information about a specific project. This endpoint returns more detailed information about a project than GET api.elevenlabs.io/v1/projects. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.get( project_id="project_id", ) """ _response = self._client_wrapper.httpx_client.request( "GET", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(ProjectExtendedResponseModel, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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, project_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Any: """ Delete a project by its project_id. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.delete( project_id="project_id", ) """ _response = self._client_wrapper.httpx_client.request( "DELETE", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(typing.Any, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 convert(self, project_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Any: """ Starts conversion of a project and all of its chapters. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.convert( project_id="project_id", ) """ _response = self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/convert" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), json=jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {}))) if request_options is not None else None, headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(typing.Any, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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_snapshots( self, project_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> ProjectSnapshotsResponse: """ Gets the snapshots of a project. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.get_snapshots( project_id="project_id", ) """ _response = self._client_wrapper.httpx_client.request( "GET", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/snapshots" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(ProjectSnapshotsResponse, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 stream_audio( self, project_id: str, project_snapshot_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> None: """ Stream the audio from a project snapshot. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - project_snapshot_id: str. The project_snapshot_id of the project snapshot. You can query GET /v1/projects/{project_id}/snapshots to list all available snapshots for a project. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.stream_audio( project_id="project_id", project_snapshot_id="project_snapshot_id", ) """ _response = self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/snapshots/{jsonable_encoder(project_snapshot_id)}/stream", ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), json=jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {}))) if request_options is not None else None, headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 update_pronunciation_dictionaries( self, project_id: str, *, pronunciation_dictionary_locators: typing.Sequence[PronunciationDictionaryVersionLocator], request_options: typing.Optional[RequestOptions] = None, ) -> typing.Any: """ Updates the set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - pronunciation_dictionary_locators: typing.Sequence[PronunciationDictionaryVersionLocator]. A list of pronunciation dictionary locators (id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs import PronunciationDictionaryVersionLocator from elevenlabs.client import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.projects.update_pronunciation_dictionaries( project_id="project_id", pronunciation_dictionary_locators=[ PronunciationDictionaryVersionLocator( pronunciation_dictionary_id="pronunciation_dictionary_id", version_id="version_id", ) ], ) """ _response = self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/update-pronunciation-dictionaries", ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), json=jsonable_encoder({"pronunciation_dictionary_locators": pronunciation_dictionary_locators}) if request_options is None or request_options.get("additional_body_parameters") is None else { **jsonable_encoder({"pronunciation_dictionary_locators": pronunciation_dictionary_locators}), **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))), }, headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(typing.Any, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 AsyncProjectsClient: def __init__(self, *, client_wrapper: AsyncClientWrapper): self._client_wrapper = client_wrapper async def get_all(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetProjectsResponse: """ Returns a list of your projects together and its metadata. Parameters: - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.get_all() """ _response = await self._client_wrapper.httpx_client.request( "GET", urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "v1/projects"), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(GetProjectsResponse, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 add( self, *, name: str, from_url: typing.Optional[str] = None, from_document: typing.Optional[core.File] = None, default_title_voice_id: str, default_paragraph_voice_id: str, default_model_id: str, quality_preset: typing.Optional[str] = None, title: typing.Optional[str] = None, author: typing.Optional[str] = None, isbn_number: typing.Optional[str] = None, acx_volume_normalization: typing.Optional[bool] = None, volume_normalization: typing.Optional[bool] = None, pronunciation_dictionary_locators: typing.List[str], callback_url: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None, ) -> AddProjectResponseModel: """ Creates a new project, it can be either initialized as blank, from a document or from a URL. Parameters: - name: str. The name of the project, used for identification only. - from_url: typing.Optional[str]. An optional URL from which we will extract content to initialize the project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the project as blank. - from_document: typing.Optional[core.File]. See core.File for more documentation - default_title_voice_id: str. The voice_id that corresponds to the default voice used for new titles. - default_paragraph_voice_id: str. The voice_id that corresponds to the default voice used for new paragraphs. - default_model_id: str. The model_id of the model to be used for this project, you can query GET https://api.elevenlabs.io/v1/models to list all available models. - quality_preset: typing.Optional[str]. Output quality of the generated audio. Must be one of: standard - standard output format, 128kbps with 44.1kHz sample rate. high - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side. Using this setting increases the character cost by 20%. ultra - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. Using this setting increases the character cost by 50%. - title: typing.Optional[str]. An optional name of the author of the project, this will be added as metadata to the mp3 file on project / chapter download. - author: typing.Optional[str]. An optional name of the author of the project, this will be added as metadata to the mp3 file on project / chapter download. - isbn_number: typing.Optional[str]. An optional ISBN number of the project you want to create, this will be added as metadata to the mp3 file on project / chapter download. - acx_volume_normalization: typing.Optional[bool]. [Deprecated] When the project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements - volume_normalization: typing.Optional[bool]. When the project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements - pronunciation_dictionary_locators: typing.List[str]. A list of pronunciation dictionary locators (id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody - callback_url: typing.Optional[str]. A url that will be called by our service when the project is converted with a json containing the status of the conversion - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.add() """ _response = await self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "v1/projects/add"), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), data=jsonable_encoder( remove_none_from_dict( { "name": name, "from_url": from_url, "default_title_voice_id": default_title_voice_id, "default_paragraph_voice_id": default_paragraph_voice_id, "default_model_id": default_model_id, "quality_preset": quality_preset, "title": title, "author": author, "isbn_number": isbn_number, "acx_volume_normalization": acx_volume_normalization, "volume_normalization": volume_normalization, "pronunciation_dictionary_locators": pronunciation_dictionary_locators, "callback_url": callback_url, } ) ) if request_options is None or request_options.get("additional_body_parameters") is None else { **jsonable_encoder( remove_none_from_dict( { "name": name, "from_url": from_url, "default_title_voice_id": default_title_voice_id, "default_paragraph_voice_id": default_paragraph_voice_id, "default_model_id": default_model_id, "quality_preset": quality_preset, "title": title, "author": author, "isbn_number": isbn_number, "acx_volume_normalization": acx_volume_normalization, "volume_normalization": volume_normalization, "pronunciation_dictionary_locators": pronunciation_dictionary_locators, "callback_url": callback_url, } ) ), **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))), }, files=core.convert_file_dict_to_httpx_tuples(remove_none_from_dict({"from_document": from_document})), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(AddProjectResponseModel, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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( self, project_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> ProjectExtendedResponseModel: """ Returns information about a specific project. This endpoint returns more detailed information about a project than GET api.elevenlabs.io/v1/projects. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.get( project_id="project_id", ) """ _response = await self._client_wrapper.httpx_client.request( "GET", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(ProjectExtendedResponseModel, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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, project_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Any: """ Delete a project by its project_id. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.delete( project_id="project_id", ) """ _response = await self._client_wrapper.httpx_client.request( "DELETE", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(typing.Any, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 convert(self, project_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Any: """ Starts conversion of a project and all of its chapters. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.convert( project_id="project_id", ) """ _response = await self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/convert" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), json=jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {}))) if request_options is not None else None, headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(typing.Any, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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_snapshots( self, project_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> ProjectSnapshotsResponse: """ Gets the snapshots of a project. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.get_snapshots( project_id="project_id", ) """ _response = await self._client_wrapper.httpx_client.request( "GET", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/snapshots" ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(ProjectSnapshotsResponse, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 stream_audio( self, project_id: str, project_snapshot_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> None: """ Stream the audio from a project snapshot. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - project_snapshot_id: str. The project_snapshot_id of the project snapshot. You can query GET /v1/projects/{project_id}/snapshots to list all available snapshots for a project. - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.stream_audio( project_id="project_id", project_snapshot_id="project_snapshot_id", ) """ _response = await self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/snapshots/{jsonable_encoder(project_snapshot_id)}/stream", ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), json=jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {}))) if request_options is not None else None, headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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 update_pronunciation_dictionaries( self, project_id: str, *, pronunciation_dictionary_locators: typing.Sequence[PronunciationDictionaryVersionLocator], request_options: typing.Optional[RequestOptions] = None, ) -> typing.Any: """ Updates the set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does. Parameters: - project_id: str. The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects. - pronunciation_dictionary_locators: typing.Sequence[PronunciationDictionaryVersionLocator]. A list of pronunciation dictionary locators (id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody - request_options: typing.Optional[RequestOptions]. Request-specific configuration. --- from elevenlabs import PronunciationDictionaryVersionLocator from elevenlabs.client import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) await client.projects.update_pronunciation_dictionaries( project_id="project_id", pronunciation_dictionary_locators=[ PronunciationDictionaryVersionLocator( pronunciation_dictionary_id="pronunciation_dictionary_id", version_id="version_id", ) ], ) """ _response = await self._client_wrapper.httpx_client.request( "POST", urllib.parse.urljoin( f"{self._client_wrapper.get_base_url()}/", f"v1/projects/{jsonable_encoder(project_id)}/update-pronunciation-dictionaries", ), params=jsonable_encoder( request_options.get("additional_query_parameters") if request_options is not None else None ), json=jsonable_encoder({"pronunciation_dictionary_locators": pronunciation_dictionary_locators}) if request_options is None or request_options.get("additional_body_parameters") is None else { **jsonable_encoder({"pronunciation_dictionary_locators": pronunciation_dictionary_locators}), **(jsonable_encoder(remove_none_from_dict(request_options.get("additional_body_parameters", {})))), }, headers=jsonable_encoder( remove_none_from_dict( { **self._client_wrapper.get_headers(), **(request_options.get("additional_headers", {}) if request_options is not None else {}), } ) ), timeout=request_options.get("timeout_in_seconds") if request_options is not None and request_options.get("timeout_in_seconds") is not None else 60, retries=0, max_retries=request_options.get("max_retries") if request_options is not None else 0, # type: ignore ) if 200 <= _response.status_code < 300: return pydantic.parse_obj_as(typing.Any, _response.json()) # type: ignore if _response.status_code == 422: raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json())) # type: ignore try: _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)