# This file was auto-generated by Fern from our API Definition. import typing from json.decoder import JSONDecodeError from ....core.api_error import ApiError from ....core.client_wrapper import AsyncClientWrapper, SyncClientWrapper from ....core.http_response import AsyncHttpResponse, HttpResponse from ....core.jsonable_encoder import jsonable_encoder from ....core.request_options import RequestOptions from ....core.unchecked_base_model import construct_type from ....errors.unprocessable_entity_error import UnprocessableEntityError from ....types.http_validation_error import HttpValidationError from ....types.similar_voices_for_speaker_response import SimilarVoicesForSpeakerResponse from ....types.speaker_created_response import SpeakerCreatedResponse from ....types.speaker_updated_response import SpeakerUpdatedResponse # this is used as the default value for optional parameters OMIT = typing.cast(typing.Any, ...) class RawSpeakerClient: def __init__(self, *, client_wrapper: SyncClientWrapper): self._client_wrapper = client_wrapper def update( self, dubbing_id: str, speaker_id: str, *, speaker_name: typing.Optional[str] = OMIT, voice_id: typing.Optional[str] = OMIT, voice_stability: typing.Optional[float] = OMIT, voice_similarity: typing.Optional[float] = OMIT, voice_style: typing.Optional[float] = OMIT, languages: typing.Optional[typing.Sequence[str]] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[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. speaker_name : typing.Optional[str] Name to attribute to this speaker. voice_id : typing.Optional[str] Either the identifier of a voice from the ElevenLabs voice library, or one of ['track-clone', 'clip-clone']. voice_stability : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 0.65, with a valid range of [0.0, 1.0]. voice_similarity : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. voice_style : typing.Optional[float] For models that support it, the voice style value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. 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 ------- HttpResponse[SpeakerUpdatedResponse] Successful Response """ _response = self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}", method="PATCH", json={ "speaker_name": speaker_name, "voice_id": voice_id, "voice_stability": voice_stability, "voice_similarity": voice_similarity, "voice_style": voice_style, "languages": languages, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( SpeakerUpdatedResponse, construct_type( type_=SpeakerUpdatedResponse, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def create( self, dubbing_id: str, *, speaker_name: typing.Optional[str] = OMIT, voice_id: typing.Optional[str] = OMIT, voice_stability: typing.Optional[float] = OMIT, voice_similarity: typing.Optional[float] = OMIT, voice_style: typing.Optional[float] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> HttpResponse[SpeakerCreatedResponse]: """ Parameters ---------- dubbing_id : str ID of the dubbing project. speaker_name : typing.Optional[str] Name to attribute to this speaker. voice_id : typing.Optional[str] Either the identifier of a voice from the ElevenLabs voice library, or one of ['track-clone', 'clip-clone']. voice_stability : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 0.65, with a valid range of [0.0, 1.0]. voice_similarity : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. voice_style : typing.Optional[float] For models that support it, the voice style value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- HttpResponse[SpeakerCreatedResponse] Successful Response """ _response = self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker", method="POST", json={ "speaker_name": speaker_name, "voice_id": voice_id, "voice_stability": voice_stability, "voice_similarity": voice_similarity, "voice_style": voice_style, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( SpeakerCreatedResponse, construct_type( type_=SpeakerCreatedResponse, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) def find_similar_voices( self, dubbing_id: str, speaker_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> HttpResponse[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 ------- HttpResponse[SimilarVoicesForSpeakerResponse] Successful Response """ _response = self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}/similar-voices", method="GET", request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( SimilarVoicesForSpeakerResponse, construct_type( type_=SimilarVoicesForSpeakerResponse, # type: ignore object_=_response.json(), ), ) return HttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) class AsyncRawSpeakerClient: def __init__(self, *, client_wrapper: AsyncClientWrapper): self._client_wrapper = client_wrapper async def update( self, dubbing_id: str, speaker_id: str, *, speaker_name: typing.Optional[str] = OMIT, voice_id: typing.Optional[str] = OMIT, voice_stability: typing.Optional[float] = OMIT, voice_similarity: typing.Optional[float] = OMIT, voice_style: typing.Optional[float] = OMIT, languages: typing.Optional[typing.Sequence[str]] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[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. speaker_name : typing.Optional[str] Name to attribute to this speaker. voice_id : typing.Optional[str] Either the identifier of a voice from the ElevenLabs voice library, or one of ['track-clone', 'clip-clone']. voice_stability : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 0.65, with a valid range of [0.0, 1.0]. voice_similarity : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. voice_style : typing.Optional[float] For models that support it, the voice style value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. 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 ------- AsyncHttpResponse[SpeakerUpdatedResponse] Successful Response """ _response = await self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}", method="PATCH", json={ "speaker_name": speaker_name, "voice_id": voice_id, "voice_stability": voice_stability, "voice_similarity": voice_similarity, "voice_style": voice_style, "languages": languages, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( SpeakerUpdatedResponse, construct_type( type_=SpeakerUpdatedResponse, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def create( self, dubbing_id: str, *, speaker_name: typing.Optional[str] = OMIT, voice_id: typing.Optional[str] = OMIT, voice_stability: typing.Optional[float] = OMIT, voice_similarity: typing.Optional[float] = OMIT, voice_style: typing.Optional[float] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AsyncHttpResponse[SpeakerCreatedResponse]: """ Parameters ---------- dubbing_id : str ID of the dubbing project. speaker_name : typing.Optional[str] Name to attribute to this speaker. voice_id : typing.Optional[str] Either the identifier of a voice from the ElevenLabs voice library, or one of ['track-clone', 'clip-clone']. voice_stability : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 0.65, with a valid range of [0.0, 1.0]. voice_similarity : typing.Optional[float] For models that support it, the voice similarity value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. voice_style : typing.Optional[float] For models that support it, the voice style value to use. This will default to 1.0, with a valid range of [0.0, 1.0]. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AsyncHttpResponse[SpeakerCreatedResponse] Successful Response """ _response = await self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker", method="POST", json={ "speaker_name": speaker_name, "voice_id": voice_id, "voice_stability": voice_stability, "voice_similarity": voice_similarity, "voice_style": voice_style, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( SpeakerCreatedResponse, construct_type( type_=SpeakerCreatedResponse, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json) async def find_similar_voices( self, dubbing_id: str, speaker_id: str, *, request_options: typing.Optional[RequestOptions] = None ) -> AsyncHttpResponse[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 ------- AsyncHttpResponse[SimilarVoicesForSpeakerResponse] Successful Response """ _response = await self._client_wrapper.httpx_client.request( f"v1/dubbing/resource/{jsonable_encoder(dubbing_id)}/speaker/{jsonable_encoder(speaker_id)}/similar-voices", method="GET", request_options=request_options, ) try: if 200 <= _response.status_code < 300: _data = typing.cast( SimilarVoicesForSpeakerResponse, construct_type( type_=SimilarVoicesForSpeakerResponse, # type: ignore object_=_response.json(), ), ) return AsyncHttpResponse(response=_response, data=_data) if _response.status_code == 422: raise UnprocessableEntityError( headers=dict(_response.headers), body=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, headers=dict(_response.headers), body=_response.text) raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)