# This file was auto-generated by Fern from our API Definition. import typing from ...core.client_wrapper import SyncClientWrapper from .segment.client import SegmentClient from ...core.request_options import RequestOptions from ...types.speaker_updated_response import SpeakerUpdatedResponse from ...core.jsonable_encoder import jsonable_encoder from ...core.unchecked_base_model import construct_type from ...errors.unprocessable_entity_error import UnprocessableEntityError from ...types.http_validation_error import HttpValidationError from json.decoder import JSONDecodeError from ...core.api_error import ApiError from ...types.similar_voices_for_speaker_response import SimilarVoicesForSpeakerResponse from ...core.client_wrapper import AsyncClientWrapper from .segment.client import AsyncSegmentClient # this is used as the default value for optional parameters OMIT = typing.cast(typing.Any, ...) class SpeakerClient: def __init__(self, *, client_wrapper: SyncClientWrapper): self._client_wrapper = client_wrapper self.segment = SegmentClient(client_wrapper=self._client_wrapper) def update( self, dubbing_id: str, speaker_id: str, *, voice_id: typing.Optional[str] = OMIT, languages: typing.Optional[typing.Sequence[str]] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> SpeakerUpdatedResponse: """ Amend the metadata associated with a speaker, such as their voice. Both voice cloning and using voices from the ElevenLabs library are supported. Parameters ---------- dubbing_id : str ID of the dubbing project. speaker_id : str ID of the speaker. voice_id : typing.Optional[str] Either the identifier of a voice from the ElevenLabs voice library, or one of ['track-clone', 'clip-clone']. languages : typing.Optional[typing.Sequence[str]] Languages to apply these changes to. If empty, will apply to all languages. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- SpeakerUpdatedResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.dubbing.speaker.update( dubbing_id="dubbing_id", speaker_id="speaker_id", ) """ _response = self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}", base_url=self._client_wrapper.get_environment().base, method="PATCH", json={ "voice_id": voice_id, "languages": languages, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return typing.cast( SpeakerUpdatedResponse, construct_type( type_=SpeakerUpdatedResponse, # type: ignore object_=_response.json(), ), ) if _response.status_code == 422: raise UnprocessableEntityError( typing.cast( HttpValidationError, construct_type( type_=HttpValidationError, # 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 similar_voices( self, dubbing_id: str, speaker_id: str, *, request_options: typing.Optional[RequestOptions] = None, ) -> SimilarVoicesForSpeakerResponse: """ Fetch the top 10 similar voices to a speaker, including the voice IDs, names, descriptions, and, where possible, a sample audio recording. Parameters ---------- dubbing_id : str ID of the dubbing project. speaker_id : str ID of the speaker. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- SimilarVoicesForSpeakerResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.dubbing.speaker.similar_voices( dubbing_id="dubbing_id", speaker_id="speaker_id", ) """ _response = self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}/similar-voices", base_url=self._client_wrapper.get_environment().base, method="GET", request_options=request_options, ) try: if 200 <= _response.status_code < 300: return typing.cast( SimilarVoicesForSpeakerResponse, construct_type( type_=SimilarVoicesForSpeakerResponse, # type: ignore object_=_response.json(), ), ) if _response.status_code == 422: raise UnprocessableEntityError( typing.cast( HttpValidationError, construct_type( type_=HttpValidationError, # 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 AsyncSpeakerClient: def __init__(self, *, client_wrapper: AsyncClientWrapper): self._client_wrapper = client_wrapper self.segment = AsyncSegmentClient(client_wrapper=self._client_wrapper) async def update( self, dubbing_id: str, speaker_id: str, *, voice_id: typing.Optional[str] = OMIT, languages: typing.Optional[typing.Sequence[str]] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> SpeakerUpdatedResponse: """ Amend the metadata associated with a speaker, such as their voice. Both voice cloning and using voices from the ElevenLabs library are supported. Parameters ---------- dubbing_id : str ID of the dubbing project. speaker_id : str ID of the speaker. voice_id : typing.Optional[str] Either the identifier of a voice from the ElevenLabs voice library, or one of ['track-clone', 'clip-clone']. languages : typing.Optional[typing.Sequence[str]] Languages to apply these changes to. If empty, will apply to all languages. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- SpeakerUpdatedResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.dubbing.speaker.update( dubbing_id="dubbing_id", speaker_id="speaker_id", ) asyncio.run(main()) """ _response = await self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}", base_url=self._client_wrapper.get_environment().base, method="PATCH", json={ "voice_id": voice_id, "languages": languages, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return typing.cast( SpeakerUpdatedResponse, construct_type( type_=SpeakerUpdatedResponse, # type: ignore object_=_response.json(), ), ) if _response.status_code == 422: raise UnprocessableEntityError( typing.cast( HttpValidationError, construct_type( type_=HttpValidationError, # 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 similar_voices( self, dubbing_id: str, speaker_id: str, *, request_options: typing.Optional[RequestOptions] = None, ) -> SimilarVoicesForSpeakerResponse: """ Fetch the top 10 similar voices to a speaker, including the voice IDs, names, descriptions, and, where possible, a sample audio recording. Parameters ---------- dubbing_id : str ID of the dubbing project. speaker_id : str ID of the speaker. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- SimilarVoicesForSpeakerResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.dubbing.speaker.similar_voices( dubbing_id="dubbing_id", speaker_id="speaker_id", ) asyncio.run(main()) """ _response = await self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}/similar-voices", base_url=self._client_wrapper.get_environment().base, method="GET", request_options=request_options, ) try: if 200 <= _response.status_code < 300: return typing.cast( SimilarVoicesForSpeakerResponse, construct_type( type_=SimilarVoicesForSpeakerResponse, # type: ignore object_=_response.json(), ), ) if _response.status_code == 422: raise UnprocessableEntityError( typing.cast( HttpValidationError, construct_type( type_=HttpValidationError, # 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)