o lWiu@s ddlmZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z dd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZddlmZejryddlmZm Z ddl!m"Z"m#Z#ddl$m%Z%m&Z&ddl'm(Z(m)Z)e*ej+dZ,GdddZ-GdddZ.dS)) annotationsN)core)AsyncClientWrapperSyncClientWrapper)RequestOptions)AddVoiceResponseModel)DeleteVoiceResponseModel)EditVoiceResponseModel)GetLibraryVoicesResponse)GetVoicesResponse)GetVoicesV2Response)Voice)AsyncRawVoicesClientRawVoicesClient)VoicesGetSharedRequestCategory)AsyncIvcClient IvcClient)AsyncPvcClient PvcClient)AsyncSamplesClient SamplesClient)AsyncSettingsClientSettingsClient.c@ eZdZdaddZedbddZd d d dcddZd d d d d d d d d d d d d ddd"d#Zd d d$ded)d*Zd d+dfd-d.Z e e e e d d/dgd7d8Z d d+dhddidOdPZ e e e d dQdjdWdXZedYdZZed[d\Zed]d^Zed_d`Zd S)k VoicesClientclient_wrapperrcC.t|d|_||_d|_d|_d|_d|_dSNr)r _raw_client_client_wrapper _settings_ivc_pvc_samplesselfrr)\/var/www/html/asistente-voz-ia/venv/lib/python3.10/site-packages/elevenlabs/voices/client.py__init__  zVoicesClient.__init__returnrcC|jS)z Retrieves a raw implementation of this client that returns raw responses. Returns ------- RawVoicesClient r!r(r)r)r*with_raw_response& zVoicesClient.with_raw_responseN show_legacyrequest_optionsr4typing.Optional[bool]r5typing.Optional[RequestOptions]r cC|jj||d}|jS)a Returns a list of all available voices for a user. Parameters ---------- show_legacy : typing.Optional[bool] If set to true, legacy premade voices will be included in responses from /v1/voices request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetVoicesResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.get_all( show_legacy=True, ) r3r!get_alldatar(r4r5 _responser)r)r*r:1zVoicesClient.get_all next_page_token page_sizesearchsortsort_direction voice_typecategoryfine_tuning_state collection_idinclude_total_count voice_idsr5r@typing.Optional[str]rAtyping.Optional[int]rBrCrDrErFrGrHrIrJ8typing.Optional[typing.Union[str, typing.Sequence[str]]]r c Cs*|jj||||||||| | | | d } | jS)a Gets a list of all available voices for a user with search, filtering and pagination. Parameters ---------- next_page_token : typing.Optional[str] The next page token to use for pagination. Returned from the previous request. Use this in combination with the has_more flag for reliable pagination. page_size : typing.Optional[int] How many voices to return at maximum. Can not exceed 100, defaults to 10. Page 0 may include more voices due to default voices being included. search : typing.Optional[str] Search term to filter voices by. Searches in name, description, labels, category. sort : typing.Optional[str] Which field to sort by, one of 'created_at_unix' or 'name'. 'created_at_unix' may not be available for older voices. sort_direction : typing.Optional[str] Which direction to sort the voices in. 'asc' or 'desc'. voice_type : typing.Optional[str] Type of the voice to filter by. One of 'personal', 'community', 'default', 'workspace', 'non-default'. 'non-default' is equal to all but 'default'. category : typing.Optional[str] Category of the voice to filter by. One of 'premade', 'cloned', 'generated', 'professional' fine_tuning_state : typing.Optional[str] State of the voice's fine tuning to filter by. Applicable only to professional voices clones. One of 'draft', 'not_verified', 'not_started', 'queued', 'fine_tuning', 'fine_tuned', 'failed', 'delayed' collection_id : typing.Optional[str] Collection ID to filter voices by. include_total_count : typing.Optional[bool] Whether to include the total count of voices found in the response. NOTE: The total_count value is a live snapshot and may change between requests as users create, modify, or delete voices. For pagination, rely on the has_more flag instead. Only enable this when you actually need the total count (e.g., for display purposes), as it incurs a performance cost. voice_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]] Voice IDs to lookup by. Maximum 100 voice IDs. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetVoicesV2Response Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.search( next_page_token="next_page_token", page_size=1, search="search", sort="sort", sort_direction="sort_direction", voice_type="voice_type", category="category", fine_tuning_state="fine_tuning_state", collection_id="collection_id", include_total_count=True, ) r?r!rBr;r(r@rArBrCrDrErFrGrHrIrJr5r=r)r)r*rBRsRzVoicesClient.search with_settingsr5voice_idstrrQrcCs|jj|||d}|jS)a] Returns metadata about a specific voice. Parameters ---------- voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. with_settings : typing.Optional[bool] This parameter is now deprecated. It is ignored and will be removed in a future version. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- Voice Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.get( voice_id="21m00Tcm4TlvDq8ikWAM", with_settings=True, ) rPr!getr;r(rRrQr5r=r)r)r*rUs&zVoicesClient.getr5r cCr8)a Deletes a voice by its ID. Parameters ---------- voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- DeleteVoiceResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.delete( voice_id="21m00Tcm4TlvDq8ikWAM", ) rWr!deleter;r(rRr5r=r)r)r*rYr>zVoicesClient.deletefilesremove_background_noise descriptionlabelsr5namer\'typing.Optional[typing.List[core.File]]r]r^r_r c Cs |jj|||||||d}|jS)aN Edit a voice created by you. Parameters ---------- voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. name : str The name that identifies this voice. This will be displayed in the dropdown of the website. files : typing.Optional[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. description : typing.Optional[str] A description of the voice. labels : typing.Optional[str] Serialized labels dictionary for the voice. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- EditVoiceResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.update( voice_id="21m00Tcm4TlvDq8ikWAM", name="name", ) r`r\r]r^r_r5r!updater; r(rRr`r\r]r^r_r5r=r)r)r*rds6 zVoicesClient.updatepublic_user_idnew_namercC|jj||||d}|jS)a) Add a shared voice to your collection of Voices Parameters ---------- public_user_id : str Public user ID used to publicly identify ElevenLabs users. voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. new_name : str The name that identifies this voice. This will be displayed in the dropdown of the website. 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.share( public_user_id="63e06b7e7cafdc46be4d2e0b3f045940231ae058d508589653d74d1265a574ca", voice_id="21m00Tcm4TlvDq8ikWAM", new_name="John Smith", ) rgr5r!sharer;r(rfrRrgr5r=r)r)r*rk?s+zVoicesClient.sharerArFgenderageaccentlanguagelocalerB use_cases descriptivesfeaturedmin_notice_period_daysinclude_custom_ratesinclude_live_moderatedreader_app_enabledowner_idrCpager5/typing.Optional[VoicesGetSharedRequestCategory]rnrorprqrrrsrtrurvrwrxryrzr{r cCs|jjdid|d|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|}|jS)at Retrieves a list of shared voices. Parameters ---------- page_size : typing.Optional[int] How many shared voices to return at maximum. Can not exceed 100, defaults to 30. category : typing.Optional[VoicesGetSharedRequestCategory] Voice category used for filtering gender : typing.Optional[str] Gender used for filtering age : typing.Optional[str] Age used for filtering accent : typing.Optional[str] Accent used for filtering language : typing.Optional[str] Language used for filtering locale : typing.Optional[str] Locale used for filtering search : typing.Optional[str] Search term used for filtering use_cases : typing.Optional[typing.Union[str, typing.Sequence[str]]] Use-case used for filtering descriptives : typing.Optional[typing.Union[str, typing.Sequence[str]]] Search term used for filtering featured : typing.Optional[bool] Filter featured voices min_notice_period_days : typing.Optional[int] Filter voices with a minimum notice period of the given number of days. include_custom_rates : typing.Optional[bool] Include/exclude voices with custom rates include_live_moderated : typing.Optional[bool] Include/exclude voices that are live moderated reader_app_enabled : typing.Optional[bool] Filter voices that are enabled for the reader app owner_id : typing.Optional[str] Filter voices by public owner ID sort : typing.Optional[str] Sort criteria page : typing.Optional[int] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetLibraryVoicesResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.get_shared( page_size=1, category="professional", gender="gender", age="age", accent="accent", language="language", locale="locale", search="search", featured=True, min_notice_period_days=1, include_custom_rates=True, include_live_moderated=True, reader_app_enabled=True, owner_id="owner_id", sort="sort", page=1, ) rArFrnrorprqrrrBrsrtrurvrwrxryrzrCr{r5Nr)r! get_sharedr;r(rArFrnrorprqrrrBrsrtrurvrwrxryrzrCr{r5r=r)r)r*r~msP s     zVoicesClient.get_shared audio_filesimilarity_thresholdtop_kr5rtyping.Optional[core.File]rtyping.Optional[float]rcCrh)aw Returns a list of shared voices similar to the provided audio sample. If neither similarity_threshold nor top_k is provided, we will apply default values. Parameters ---------- audio_file : typing.Optional[core.File] See core.File for more documentation similarity_threshold : typing.Optional[float] Threshold for voice similarity between provided sample and library voices. Values range from 0 to 2. The smaller the value the more similar voices will be returned. top_k : typing.Optional[int] Number of most similar voices to return. If similarity_threshold is provided, less than this number of voices may be returned. Values range from 1 to 100. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetLibraryVoicesResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.voices.find_similar_voices() rr!find_similar_voicesr;r(rrrr5r=r)r)r*rs'z VoicesClient.find_similar_voicescC*|jdurddlm}||jd|_|jS)Nr)rr )r#settings.clientrr")r(rr)r)r*settings&  zVoicesClient.settingscCr)Nr)rr )r$ ivc.clientrr")r(rr)r)r*ivc.rzVoicesClient.ivccCr)Nr)rr )r% pvc.clientrr")r(rr)r)r*pvc6rzVoicesClient.pvccCr)Nr)rr )r&samples.clientrr")r(rr)r)r*samples>rzVoicesClient.samples)rr)r-rr4r6r5r7r-r r@rKrArLrBrKrCrKrDrKrErKrFrKrGrKrHrKrIr6rJrMr5r7r-r rRrSrQr6r5r7r-rrRrSr5r7r-r rRrSr`rSr\rar]r6r^rKr_rKr5r7r-r rfrSrRrSrgrSr5r7r-r(rArLrFr|rnrKrorKrprKrqrKrrrKrBrKrsrMrtrMrur6rvrLrwr6rxr6ryr6rzrKrCrKr{rLr5r7r-r rrrrrrLr5r7r-r __name__ __module__ __qualname__r+propertyr1r:rBrUrYOMITrdrkr~rrrrrr)r)r)r*rs   $f*&G1/   rc@r)kAsyncVoicesClientrrcCrr)rr!r"r#r$r%r&r'r)r)r*r+Hr,zAsyncVoicesClient.__init__r-rcCr.)z Retrieves a raw implementation of this client that returns raw responses. Returns ------- AsyncRawVoicesClient r/r0r)r)r*r1Pr2z#AsyncVoicesClient.with_raw_responseNr3r4r6r5r7r c|jj||dIdH}|jS)a Returns a list of all available voices for a user. Parameters ---------- show_legacy : typing.Optional[bool] If set to true, legacy premade voices will be included in responses from /v1/voices request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetVoicesResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.get_all( show_legacy=True, ) asyncio.run(main()) r3Nr9r<r)r)r*r:[&zAsyncVoicesClient.get_allr?r@rKrArLrBrCrDrErFrGrHrIrJrMr c s2|jj||||||||| | | | d IdH} | jS)aH Gets a list of all available voices for a user with search, filtering and pagination. Parameters ---------- next_page_token : typing.Optional[str] The next page token to use for pagination. Returned from the previous request. Use this in combination with the has_more flag for reliable pagination. page_size : typing.Optional[int] How many voices to return at maximum. Can not exceed 100, defaults to 10. Page 0 may include more voices due to default voices being included. search : typing.Optional[str] Search term to filter voices by. Searches in name, description, labels, category. sort : typing.Optional[str] Which field to sort by, one of 'created_at_unix' or 'name'. 'created_at_unix' may not be available for older voices. sort_direction : typing.Optional[str] Which direction to sort the voices in. 'asc' or 'desc'. voice_type : typing.Optional[str] Type of the voice to filter by. One of 'personal', 'community', 'default', 'workspace', 'non-default'. 'non-default' is equal to all but 'default'. category : typing.Optional[str] Category of the voice to filter by. One of 'premade', 'cloned', 'generated', 'professional' fine_tuning_state : typing.Optional[str] State of the voice's fine tuning to filter by. Applicable only to professional voices clones. One of 'draft', 'not_verified', 'not_started', 'queued', 'fine_tuning', 'fine_tuned', 'failed', 'delayed' collection_id : typing.Optional[str] Collection ID to filter voices by. include_total_count : typing.Optional[bool] Whether to include the total count of voices found in the response. NOTE: The total_count value is a live snapshot and may change between requests as users create, modify, or delete voices. For pagination, rely on the has_more flag instead. Only enable this when you actually need the total count (e.g., for display purposes), as it incurs a performance cost. voice_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]] Voice IDs to lookup by. Maximum 100 voice IDs. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetVoicesV2Response Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.search( next_page_token="next_page_token", page_size=1, search="search", sort="sort", sort_direction="sort_direction", voice_type="voice_type", category="category", fine_tuning_state="fine_tuning_state", collection_id="collection_id", include_total_count=True, ) asyncio.run(main()) r?NrNrOr)r)r*rBs Z zAsyncVoicesClient.searchrPrRrSrQrcs |jj|||dIdH}|jS)a Returns metadata about a specific voice. Parameters ---------- voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. with_settings : typing.Optional[bool] This parameter is now deprecated. It is ignored and will be removed in a future version. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- Voice Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.get( voice_id="21m00Tcm4TlvDq8ikWAM", with_settings=True, ) asyncio.run(main()) rPNrTrVr)r)r*rUs.zAsyncVoicesClient.getrWr cr)a' Deletes a voice by its ID. Parameters ---------- voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- DeleteVoiceResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.delete( voice_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rWNrXrZr)r)r*rYrzAsyncVoicesClient.deleter[r`r\rar]r^r_r c s(|jj|||||||dIdH}|jS)a Edit a voice created by you. Parameters ---------- voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. name : str The name that identifies this voice. This will be displayed in the dropdown of the website. files : typing.Optional[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. description : typing.Optional[str] A description of the voice. labels : typing.Optional[str] Serialized labels dictionary for the voice. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- EditVoiceResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.update( voice_id="21m00Tcm4TlvDq8ikWAM", name="name", ) asyncio.run(main()) rbNrcrer)r)r*rdHs>  zAsyncVoicesClient.updaterfrgrc"|jj||||dIdH}|jS)a Add a shared voice to your collection of Voices Parameters ---------- public_user_id : str Public user ID used to publicly identify ElevenLabs users. voice_id : str ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/search) endpoint list all the available voices. new_name : str The name that identifies this voice. This will be displayed in the dropdown of the website. 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.share( public_user_id="63e06b7e7cafdc46be4d2e0b3f045940231ae058d508589653d74d1265a574ca", voice_id="21m00Tcm4TlvDq8ikWAM", new_name="John Smith", ) asyncio.run(main()) riNrjrlr)r)r*rks 3 zAsyncVoicesClient.sharermr|rnrorprqrrrsrtrurvrwrxryrzr{r cs|jjdid|d|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|IdH}|jS)a& Retrieves a list of shared voices. Parameters ---------- page_size : typing.Optional[int] How many shared voices to return at maximum. Can not exceed 100, defaults to 30. category : typing.Optional[VoicesGetSharedRequestCategory] Voice category used for filtering gender : typing.Optional[str] Gender used for filtering age : typing.Optional[str] Age used for filtering accent : typing.Optional[str] Accent used for filtering language : typing.Optional[str] Language used for filtering locale : typing.Optional[str] Locale used for filtering search : typing.Optional[str] Search term used for filtering use_cases : typing.Optional[typing.Union[str, typing.Sequence[str]]] Use-case used for filtering descriptives : typing.Optional[typing.Union[str, typing.Sequence[str]]] Search term used for filtering featured : typing.Optional[bool] Filter featured voices min_notice_period_days : typing.Optional[int] Filter voices with a minimum notice period of the given number of days. include_custom_rates : typing.Optional[bool] Include/exclude voices with custom rates include_live_moderated : typing.Optional[bool] Include/exclude voices that are live moderated reader_app_enabled : typing.Optional[bool] Filter voices that are enabled for the reader app owner_id : typing.Optional[str] Filter voices by public owner ID sort : typing.Optional[str] Sort criteria page : typing.Optional[int] request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetLibraryVoicesResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.get_shared( page_size=1, category="professional", gender="gender", age="age", accent="accent", language="language", locale="locale", search="search", featured=True, min_notice_period_days=1, include_custom_rates=True, include_live_moderated=True, reader_app_enabled=True, owner_id="owner_id", sort="sort", page=1, ) asyncio.run(main()) rArFrnrorprqrrrBrsrtrurvrwrxryrzrCr{r5Nr)r}rr)r)r*r~sR {      zAsyncVoicesClient.get_sharedrrrrrrcr)a Returns a list of shared voices similar to the provided audio sample. If neither similarity_threshold nor top_k is provided, we will apply default values. Parameters ---------- audio_file : typing.Optional[core.File] See core.File for more documentation similarity_threshold : typing.Optional[float] Threshold for voice similarity between provided sample and library voices. Values range from 0 to 2. The smaller the value the more similar voices will be returned. top_k : typing.Optional[int] Number of most similar voices to return. If similarity_threshold is provided, less than this number of voices may be returned. Values range from 1 to 100. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetLibraryVoicesResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.voices.find_similar_voices() asyncio.run(main()) rNrrr)r)r*r[s/ z%AsyncVoicesClient.find_similar_voicescCr)Nr)rr )r#rrr")r(rr)r)r*rrzAsyncVoicesClient.settingscCr)Nr)rr )r$rrr")r(rr)r)r*rrzAsyncVoicesClient.ivccCr)Nr)rr )r%rrr")r(rr)r)r*rrzAsyncVoicesClient.pvccCr)Nr)rr )r&rrr")r(rr)r)r*rrzAsyncVoicesClient.samples)rr)r-rrrrrrrrrrr)r)r)r*rGs   ,n2.O;7   r)/ __future__rtypingrcore.client_wrapperrrcore.request_optionsrtypes.add_voice_response_modelr!types.delete_voice_response_modelr types.edit_voice_response_modelr !types.get_library_voices_responser types.get_voices_responser types.get_voices_v_2_responser types.voicer raw_clientrr(types.voices_get_shared_request_categoryr TYPE_CHECKINGrrrrrrrrrrrrcastAnyrrrr)r)r)r*s4           .