# This file was auto-generated by Fern from our API Definition. import typing from ....core.client_wrapper import SyncClientWrapper from .audio.client import AudioClient from .waveform.client import WaveformClient from .speakers.client import SpeakersClient from .... import core from ....core.request_options import RequestOptions from ....types.voice_sample import VoiceSample 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.add_voice_response_model import AddVoiceResponseModel from ....types.delete_voice_sample_response_model import DeleteVoiceSampleResponseModel from ....core.client_wrapper import AsyncClientWrapper from .audio.client import AsyncAudioClient from .waveform.client import AsyncWaveformClient from .speakers.client import AsyncSpeakersClient # this is used as the default value for optional parameters OMIT = typing.cast(typing.Any, ...) class SamplesClient: def __init__(self, *, client_wrapper: SyncClientWrapper): self._client_wrapper = client_wrapper self.audio = AudioClient(client_wrapper=self._client_wrapper) self.waveform = WaveformClient(client_wrapper=self._client_wrapper) self.speakers = SpeakersClient(client_wrapper=self._client_wrapper) def create( self, voice_id: str, *, files: typing.List[core.File], remove_background_noise: typing.Optional[bool] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> typing.List[VoiceSample]: """ Add audio samples to a PVC voice Parameters ---------- voice_id : str Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices. files : typing.List[core.File] See core.File for more documentation remove_background_noise : typing.Optional[bool] If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- typing.List[VoiceSample] Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.pvc.samples.create( voice_id="21m00Tcm4TlvDq8ikWAM", ) """ _response = self._client_wrapper.httpx_client.request( f"v1/voices/pvc/{jsonable_encoder(voice_id)}/samples", base_url=self._client_wrapper.get_environment().base, method="POST", data={ "remove_background_noise": remove_background_noise, }, files={ "files": files, }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return typing.cast( typing.List[VoiceSample], construct_type( type_=typing.List[VoiceSample], # 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 update( self, voice_id: str, sample_id: str, *, remove_background_noise: typing.Optional[bool] = OMIT, selected_speaker_ids: typing.Optional[typing.Sequence[str]] = OMIT, trim_start_time: typing.Optional[int] = OMIT, trim_end_time: typing.Optional[int] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AddVoiceResponseModel: """ Update a PVC voice sample - apply noise removal, or select speaker. Parameters ---------- voice_id : str Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices. sample_id : str Sample ID to be used remove_background_noise : typing.Optional[bool] If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse. selected_speaker_ids : typing.Optional[typing.Sequence[str]] Speaker IDs to be used for PVC training. Make sure you send all the speaker IDs you want to use for PVC training in one request because the last request will override the previous ones. trim_start_time : typing.Optional[int] The start time of the audio to be used for PVC training. Time should be in milliseconds trim_end_time : typing.Optional[int] The end time of the audio to be used for PVC training. Time should be in milliseconds request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AddVoiceResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.pvc.samples.update( voice_id="21m00Tcm4TlvDq8ikWAM", sample_id="VW7YKqPnjY4h39yTbx2L", ) """ _response = self._client_wrapper.httpx_client.request( f"v1/voices/pvc/{jsonable_encoder(voice_id)}/samples/{jsonable_encoder(sample_id)}", base_url=self._client_wrapper.get_environment().base, method="POST", json={ "remove_background_noise": remove_background_noise, "selected_speaker_ids": selected_speaker_ids, "trim_start_time": trim_start_time, "trim_end_time": trim_end_time, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return typing.cast( AddVoiceResponseModel, construct_type( type_=AddVoiceResponseModel, # 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 delete( self, voice_id: str, sample_id: str, *, request_options: typing.Optional[RequestOptions] = None, ) -> DeleteVoiceSampleResponseModel: """ Delete a sample from a PVC voice. Parameters ---------- voice_id : str Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices. sample_id : str Sample ID to be used request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- DeleteVoiceSampleResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.pvc.samples.delete( voice_id="21m00Tcm4TlvDq8ikWAM", sample_id="VW7YKqPnjY4h39yTbx2L", ) """ _response = self._client_wrapper.httpx_client.request( f"v1/voices/pvc/{jsonable_encoder(voice_id)}/samples/{jsonable_encoder(sample_id)}", base_url=self._client_wrapper.get_environment().base, method="DELETE", request_options=request_options, ) try: if 200 <= _response.status_code < 300: return typing.cast( DeleteVoiceSampleResponseModel, construct_type( type_=DeleteVoiceSampleResponseModel, # 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 AsyncSamplesClient: def __init__(self, *, client_wrapper: AsyncClientWrapper): self._client_wrapper = client_wrapper self.audio = AsyncAudioClient(client_wrapper=self._client_wrapper) self.waveform = AsyncWaveformClient(client_wrapper=self._client_wrapper) self.speakers = AsyncSpeakersClient(client_wrapper=self._client_wrapper) async def create( self, voice_id: str, *, files: typing.List[core.File], remove_background_noise: typing.Optional[bool] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> typing.List[VoiceSample]: """ Add audio samples to a PVC voice Parameters ---------- voice_id : str Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices. files : typing.List[core.File] See core.File for more documentation remove_background_noise : typing.Optional[bool] If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- typing.List[VoiceSample] Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.pvc.samples.create( voice_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) """ _response = await self._client_wrapper.httpx_client.request( f"v1/voices/pvc/{jsonable_encoder(voice_id)}/samples", base_url=self._client_wrapper.get_environment().base, method="POST", data={ "remove_background_noise": remove_background_noise, }, files={ "files": files, }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return typing.cast( typing.List[VoiceSample], construct_type( type_=typing.List[VoiceSample], # 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 update( self, voice_id: str, sample_id: str, *, remove_background_noise: typing.Optional[bool] = OMIT, selected_speaker_ids: typing.Optional[typing.Sequence[str]] = OMIT, trim_start_time: typing.Optional[int] = OMIT, trim_end_time: typing.Optional[int] = OMIT, request_options: typing.Optional[RequestOptions] = None, ) -> AddVoiceResponseModel: """ Update a PVC voice sample - apply noise removal, or select speaker. Parameters ---------- voice_id : str Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices. sample_id : str Sample ID to be used remove_background_noise : typing.Optional[bool] If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse. selected_speaker_ids : typing.Optional[typing.Sequence[str]] Speaker IDs to be used for PVC training. Make sure you send all the speaker IDs you want to use for PVC training in one request because the last request will override the previous ones. trim_start_time : typing.Optional[int] The start time of the audio to be used for PVC training. Time should be in milliseconds trim_end_time : typing.Optional[int] The end time of the audio to be used for PVC training. Time should be in milliseconds request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AddVoiceResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.pvc.samples.update( voice_id="21m00Tcm4TlvDq8ikWAM", sample_id="VW7YKqPnjY4h39yTbx2L", ) asyncio.run(main()) """ _response = await self._client_wrapper.httpx_client.request( f"v1/voices/pvc/{jsonable_encoder(voice_id)}/samples/{jsonable_encoder(sample_id)}", base_url=self._client_wrapper.get_environment().base, method="POST", json={ "remove_background_noise": remove_background_noise, "selected_speaker_ids": selected_speaker_ids, "trim_start_time": trim_start_time, "trim_end_time": trim_end_time, }, headers={ "content-type": "application/json", }, request_options=request_options, omit=OMIT, ) try: if 200 <= _response.status_code < 300: return typing.cast( AddVoiceResponseModel, construct_type( type_=AddVoiceResponseModel, # 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 delete( self, voice_id: str, sample_id: str, *, request_options: typing.Optional[RequestOptions] = None, ) -> DeleteVoiceSampleResponseModel: """ Delete a sample from a PVC voice. Parameters ---------- voice_id : str Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices. sample_id : str Sample ID to be used request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- DeleteVoiceSampleResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.pvc.samples.delete( voice_id="21m00Tcm4TlvDq8ikWAM", sample_id="VW7YKqPnjY4h39yTbx2L", ) asyncio.run(main()) """ _response = await self._client_wrapper.httpx_client.request( f"v1/voices/pvc/{jsonable_encoder(voice_id)}/samples/{jsonable_encoder(sample_id)}", base_url=self._client_wrapper.get_environment().base, method="DELETE", request_options=request_options, ) try: if 200 <= _response.status_code < 300: return typing.cast( DeleteVoiceSampleResponseModel, construct_type( type_=DeleteVoiceSampleResponseModel, # 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)