o êiO2@svdZddlmZmZmZddlmZmZmZm Z ddl m Z m Z m Z dedefdd ZGd d d ZGd d d ZdS)z"Voice management namespace client.)ListOptionalUnion)OMITAsyncClientWrapper ClientWrapperRequestOptions)PaginatedResponse VisibilityVoicedreturncCsdd|DS)z,Remove None and OMIT values from dictionary.cSs&i|]\}}|dur|tur||qSN)r).0kvrN/home/ubuntu/.local/lib/python3.10/site-packages/fishaudio/resources/voices.py s&z _filter_none..)items)r rrr _filter_none src@eZdZdZdefddZddeedeeedd d d ed ed ee dee e e e fde dee dee e e e fdee e e e fde dee deefddZd dde dee defddZeeeedddd dd e d e ed!ee d"ee e dee e d#eed$ed%e d&e dee defd'd(Zeeeeed d)de d ee d!ee d#eed$eedee e dee dd fd*d+Zd dde dee dd fd,d-Zd S). VoicesClientz(Synchronous voice management operations.client_wrappercC ||_dSr_clientselfrrrr__init__ zVoicesClient.__init__ F task_countN page_size page_numbertitletags self_only author_idlanguagetitle_languagesort_byrequest_optionsr&r'r(r)r*r+r,r-r.r/rc CsBt||||||||| d } |jjdd| | d} tt| S)a& List available voices/models. Args: page_size: Number of results per page page_number: Page number (1-indexed) title: Filter by title tags: Filter by tags (single tag or list) self_only: Only return user's own voices author_id: Filter by author ID language: Filter by language(s) title_language: Filter by title language(s) sort_by: Sort field ("task_count" or "created_at") request_options: Request-level overrides Returns: Paginated response with total count and voice items Example: ```python client = FishAudio(api_key="...") # List all voices voices = client.voices.list(page_size=20) print(f"Total: {voices.total}") for voice in voices.items: print(f"{voice.title}: {voice.id}") # Filter by tags tagged = client.voices.list(tags=["male", "english"]) ``` r&r'r(tagrr+r,r-r.GET/modelparamsr/rrrequestr r model_validatejson rr&r'r(r)r*r+r,r-r.r/r5responserrrlists&/zVoicesClient.listr/voice_idcCs&|jjdd||d}t|S)a Get voice by ID. Args: voice_id: Voice model ID request_options: Request-level overrides Returns: Voice model details Example: ```python client = FishAudio(api_key="...") voice = client.voices.get("voice_id_here") print(voice.title, voice.description) ``` r2/model/r=rr7r r8r9rr>r/r;rrrget\s zVoicesClient.getprivatefastT descriptiontextsr) cover_image visibility train_modeenhance_audio_qualityr/voicesrFrGrHrIrJrKc  Csrt|||d||p g|p g| d} dd|D} |tur'|dur'| d|f|jjdd| | | d } t| S) aa Create/clone a new voice. Args: title: Voice model name voices: List of audio file bytes for training description: Voice description texts: Transcripts for voice samples tags: Tags for categorization cover_image: Cover image bytes visibility: Visibility setting (public, unlist, private) train_mode: Training mode (currently only "fast" supported) enhance_audio_quality: Whether to enhance audio quality request_options: Request-level overrides Returns: Created voice model Example: ```python client = FishAudio(api_key="...") with open("voice1.wav", "rb") as f1, open("voice2.wav", "rb") as f2: voice = client.voices.create( title="My Voice", voices=[f1.read(), f2.read()], description="Custom voice clone", tags=["custom", "english"] ) print(f"Created: {voice.id}") ``` ttsr(rFrItyperJrGr)rKcSg|]}d|fqSrLrrvoicerrr z'VoicesClient.create..NrHPOSTr3datafilesr/rrappendrr7r r8r9rr(rLrFrGr)rHrIrJrKr/rXrYr;rrrcreatezs,/zVoicesClient.creater(rFrHrIr)r/c Cs\t||||d}g} |tur|dur| d|f|jjdd||| r'| nd|ddS)aR Update voice metadata. Args: voice_id: Voice model ID title: New title description: New description cover_image: New cover image bytes visibility: New visibility setting tags: New tags request_options: Request-level overrides Example: ```python client = FishAudio(api_key="...") client.voices.update( "voice_id_here", title="Updated Title", visibility="public" ) ``` r(rFrIr)NrHPATCHr?rWrrr[rr7 rr>r(rFrHrIr)r/rXrYrrrupdates""   zVoicesClient.updatecCs|jjdd||ddS)a" Delete a voice. Args: voice_id: Voice model ID request_options: Request-level overrides Example: ```python client = FishAudio(api_key="...") client.voices.delete("voice_id_here") ``` DELETEr?r=Nrr7rr>r/rrrdeletes  zVoicesClient.delete)__name__ __module__ __qualname____doc__rr rintrstrrrboolr r r r<rBbytesr r]rcrgrrrrrs     L #       P   =rc@r).AsyncVoicesClientz)Asynchronous voice management operations.rcCrrrrrrrr r!zAsyncVoicesClient.__init__r"r#Fr$Nr%r&r'r(r)r*r+r,r-r.r/rc sJt||||||||| d } |jjdd| | dIdH} tt| S)zCList available voices/models (async). See sync version for details.r0r2r3r4Nr6r:rrrr<s( zAsyncVoicesClient.listr=r>cs.|jjdd||dIdH}t|S)z6Get voice by ID (async). See sync version for details.r2r?r=Nr@rArrrrBEs zAsyncVoicesClient.getrCrDTrErLrFrGrHrIrJrKc  szt|||d||p g|p g| d} dd|D} |tur(|dur(| d|f|jjdd| | | d IdH} t| S) z?Create/clone a new voice (async). See sync version for details.rMrNcSrPrQrrRrrrrTorUz,AsyncVoicesClient.create..NrHrVr3rWrZr\rrrr]Ss.  zAsyncVoicesClient.creater^c sdt||||d}g} |tur|dur| d|f|jjdd||| r(| nd|dIdHdS)zs