hTCddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z dd l mZdd lmZdd lmZd d lmZd dlmZd dlmZd dlmZddlmZddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddlm1Z1ej2ej3dZ4GddZ5Gd d!Z6dS)"N)SyncClientWrapper)RequestOptions)GetProjectsResponse)construct_type)UnprocessableEntityError)HttpValidationError)JSONDecodeError)ApiError)core) ProjectsAddRequestTargetAudience)ProjectsAddRequestFiction)(ProjectsAddRequestApplyTextNormalization)ProjectsAddRequestSourceType)AddProjectResponseModel)ProjectExtendedResponseModel)jsonable_encoder)EditProjectResponseModel)DeleteProjectResponseModel)ConvertProjectResponseModel)ProjectSnapshotsResponse)$ProjectSnapshotExtendedResponseModel)%PronunciationDictionaryVersionLocator)*CreatePronunciationDictionaryResponseModel)'convert_and_respect_annotation_metadata)AsyncClientWrapper.c9NeZdZdefdZdddejedefdZ e e e e e e e e e e e e e e e e e e e e e e ddd e d e d e d e d eje deje j deje deje deje deje dejeje dejedeje deje deje dejedeje dejedejedejeje deje dejedejed ejed!ejed"ejedejedef8d#Zddd$e dejedefd%Ze e e e dd&d$e d e d e d e deje deje deje dejedejedefd'Zddd$e dejedefd(Ze e e dd)d$e d eje deje j d ejedejedef d*Zddd$e dejedefd+Zddd$e dejedefd,Z ddd$e d-e dejede!fd.Z"e dd/d$e d-e d0ejedejeddf d1Z#ddd$e d-e dejedej$e%fd2Z&e dd3d$e dej'e(d4ejedejede)f d5Z*dS)6ProjectsClientclient_wrapperc||_dSN_client_wrapperselfr s c/var/www/html/prod/cognitive/venv/lib/python3.11/site-packages/elevenlabs/studio/projects/client.py__init__zProjectsClient.__init__+-Nrequest_optionsr,returnc |jjd|jjd|} d|jcxkrdkrCnn@t jttt| S|jdkrMtt jttt| | }n)#t$rt|j|jwxYwt|j|) a Returns a list of your Studio projects with metadata. Parameters ---------- request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetProjectsResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.get_all() v1/studio/projectsGETbase_urlmethodr,,type_object_ status_codebodyr$ httpx_clientrequestget_environmentbaser;typingcastrrjsonrr r r textr&r, _response_response_jsons r'get_allzProjectsClient.get_all.s\.(5== )99;;@+ >   Si+1111c11111{'"1 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNsADA,D&D)from_url from_documentquality_presettitleauthor descriptiongenrestarget_audiencelanguage content_typeoriginal_publication_datemature_content isbn_numberacx_volume_normalizationvolume_normalization!pronunciation_dictionary_locators callback_urlfictionapply_text_normalization auto_convertauto_assign_voices source_typer,namedefault_title_voice_iddefault_paragraph_voice_iddefault_model_idrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`c|jjd|jjdid|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|||||||||dd|i|t } d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|jwxYwt|j|)at Creates a new Studio project, it can be either initialized as blank, from a document or from a URL. Parameters ---------- name : str The name of the Studio project, used for identification only. default_title_voice_id : str The voice_id that corresponds to the default voice used for new titles. default_paragraph_voice_id : str The voice_id that corresponds to the default voice used for new paragraphs. default_model_id : str The ID of the model to be used for this Studio project, you can query GET /v1/models to list all available models. from_url : typing.Optional[str] An optional URL from which we will extract content to initialize the Studio project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the Studio project as blank. from_document : typing.Optional[core.File] See core.File for more documentation quality_preset : typing.Optional[str] Output quality of the generated audio. Must be one of: standard - standard output format, 128kbps with 44.1kHz sample rate. high - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side. Using this setting increases the credit cost by 20%. ultra - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. Using this setting increases the credit cost by 50%. ultra lossless - ultra quality output format, 705.6kbps with 44.1kHz sample rate and highest improvements on our side in a fully lossless format. Using this setting increases the credit cost by 100%. title : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. author : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. description : typing.Optional[str] An optional description of the Studio project. genres : typing.Optional[typing.List[str]] An optional list of genres associated with the Studio project. target_audience : typing.Optional[ProjectsAddRequestTargetAudience] An optional target audience of the Studio project. language : typing.Optional[str] An optional language of the Studio project. Two-letter language code (ISO 639-1). content_type : typing.Optional[str] An optional content type of the Studio project. original_publication_date : typing.Optional[str] An optional original publication date of the Studio project, in the format YYYY-MM-DD or YYYY. mature_content : typing.Optional[bool] An optional specification of whether this Studio project contains mature content. isbn_number : typing.Optional[str] An optional ISBN number of the Studio project you want to create, this will be added as metadata to the mp3 file on Studio project or chapter download. acx_volume_normalization : typing.Optional[bool] [Deprecated] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements volume_normalization : typing.Optional[bool] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements pronunciation_dictionary_locators : typing.Optional[typing.List[str]] A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"Vmd4Zor6fplcA7WrINey","version_id":"hRPaxjlTdR7wFMhV4w0b"}"' --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"JzWtcGQMJ6bnlWwyMo7e","version_id":"lbmwxiLu4q6txYxgdZqn"}"'. Note that multiple dictionaries are not currently supported by our UI which will only show the first. callback_url : typing.Optional[str] A url that will be called by our service when the Studio project is converted. Request will contain a json blob containing the status of the conversion fiction : typing.Optional[ProjectsAddRequestFiction] An optional specification of whether the content of this Studio project is fiction. apply_text_normalization : typing.Optional[ProjectsAddRequestApplyTextNormalization] This parameter controls text normalization with four modes: 'auto', 'on', 'apply_english' and 'off'. When set to 'auto', the system will automatically decide whether to apply text normalization (e.g., spelling out numbers). With 'on', text normalization will always be applied, while with 'off', it will be skipped. 'apply_english' is the same as 'on' but will assume that text is in English. auto_convert : typing.Optional[bool] Whether to auto convert the Studio project to audio or not. auto_assign_voices : typing.Optional[bool] [Alpha Feature] Whether automatically assign voices to phrases in the create Project. source_type : typing.Optional[ProjectsAddRequestSourceType] The type of Studio project to create. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AddProjectResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.add( name="name", default_title_voice_id="default_title_voice_id", default_paragraph_voice_id="default_paragraph_voice_id", default_model_id="default_model_id", ) r/POSTrarbrcrdrKrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`rLr2r3datafilesr,omitr4r5r6r9r:r$r>r?r@rAOMITr;rBrCrrrDrr r r rEr&rarbrcrdrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`r,rGrHs r'addzProjectsClient.addcskb(5== )99;;@(*@-.H#$4  H  !. &{&"?H ,-F!. {!"+,D#$)=5V ,",D ,&8*38 ,G>$ $ J Si+1111c11111{+"5 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs AE A,E &E1 project_idc |jjdt||jjd|} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|jwxYwt|j|) a Returns information about a specific Studio project. This endpoint returns more detailed information about a project than `GET /v1/studio`. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ProjectExtendedResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.get( project_id="21m00Tcm4TlvDq8ikWAM", ) v1/studio/projects/r0r1r4r5r6r9r:r$r>r?rr@rAr;rBrCrrrDrr r r rEr&rpr,rGrHs r'getzProjectsClient.get1snB(5== @"2:">"> @ @)99;;@+ >   Si+1111c11111{0": ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNAD&A,D&D9rNrOrWrYr,c |jjdt||jjd|||||||dddi| t } d| jcxkrdkrCnn@tj ttt| S| jd krMttj ttt| | } n)#t$rt!| j| j wxYwt!| j| ) a Updates the specified Studio project by setting the values of the parameters passed. Parameters ---------- project_id : str The ID of the Studio project. name : str The name of the Studio project, used for identification only. default_title_voice_id : str The voice_id that corresponds to the default voice used for new titles. default_paragraph_voice_id : str The voice_id that corresponds to the default voice used for new paragraphs. title : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. author : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. isbn_number : typing.Optional[str] An optional ISBN number of the Studio project you want to create, this will be added as metadata to the mp3 file on Studio project or chapter download. volume_normalization : typing.Optional[bool] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- EditProjectResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.update_metadata( project_id="21m00Tcm4TlvDq8ikWAM", name="Project 1", default_title_voice_id="21m00Tcm4TlvDq8ikWAM", default_paragraph_voice_id="21m00Tcm4TlvDq8ikWAM", ) rrrfrarbrcrNrOrWrY content-typeapplication/jsonr2r3rDheadersr,rkr4r5r6r9r:r$r>r?rr@rArmr;rBrCrrrDrr r r rE r&rprarbrcrNrOrWrYr,rGrHs r'update_metadatazProjectsClient.update_metadataps@(5== @"2:">"> @ @)99;;@*@.H *(< 2,#>  & Si+1111c11111{,"6 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs#AD%8A,D%%&E c |jjdt||jjd|} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|jwxYwt|j|) aY Deletes a Studio project. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- DeleteProjectResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.delete( project_id="21m00Tcm4TlvDq8ikWAM", ) rrDELETEr1r4r5r6r9r:r$r>r?rr@rAr;rBrCrrrDrr r r rErts r'deletezProjectsClient.deletesnB(5== @"2:">"> @ @)99;;@+ >   Si+1111c11111{."8 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNrvrKrLr^r,c |jjdt|d|jjd||dd|i|t } d|jcxkrdkrCnn@tj ttt| S|jd krMttj ttt| | }n)#t$rt!|j|j wxYwt!|j| ) aY Updates Studio project content. Parameters ---------- project_id : str The ID of the Studio project. from_url : typing.Optional[str] An optional URL from which we will extract content to initialize the Studio project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the Studio project as blank. from_document : typing.Optional[core.File] See core.File for more documentation auto_convert : typing.Optional[bool] Whether to auto convert the Studio project to audio or not. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- EditProjectResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.update_content( project_id="21m00Tcm4TlvDq8ikWAM", ) rr/contentrfrKr^rLrhr4r5r6r9r:r~r&rprKrLr^r,rGrHs r'update_contentzProjectsClient.update_contentsZ(5== H"2:">"> H H H)99;;@$ ,  ,>    Si+1111c11111{,"6 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNsAD!4A,D!!&Ec |jjdt|d|jjd|} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|j wxYwt|j| ) a Starts conversion of a Studio project and all of its chapters. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ConvertProjectResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.convert( project_id="21m00Tcm4TlvDq8ikWAM", ) rr/convertrfr1r4r5r6r9r:r$r>r?rr@rAr;rBrCrrrDrr r r rErts r'convertzProjectsClient.convertmsqB(5== H"2:">"> H H H)99;;@+ >   Si+1111c11111{/"9 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNAD'A,D&D:c |jjdt|d|jjd|} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|j wxYwt|j| ) ax Retrieves a list of snapshots for a Studio project. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ProjectSnapshotsResponse Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.get_snapshots( project_id="21m00Tcm4TlvDq8ikWAM", ) rr /snapshotsr0r1r4r5r6r9r:r$r>r?rr@rAr;rBrCrrrDrr r r rErts r' get_snapshotszProjectsClient.get_snapshotssqB(5== J"2:">"> J J J)99;;@+ >   Si+1111c11111{,"6 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNrproject_snapshot_idc |jjdt|dt||jjd|} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|j wxYwt|j| ) a Returns the project snapshot. Parameters ---------- project_id : str The ID of the Studio project. project_snapshot_id : str The ID of the Studio project snapshot. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ProjectSnapshotExtendedResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.get_project_snapshot( project_id="21m00Tcm4TlvDq8ikWAM", project_snapshot_id="21m00Tcm4TlvDq8ikWAM", ) rr /snapshots/r0r1r4r5r6r9r:r$r>r?rr@rAr;rBrCrrrDrr r r rEr&rprr,rGrHs r'get_project_snapshotz#ProjectsClient.get_project_snapshotsL(5== r"2:">"> r rK[\oKpKp r r)99;;@+ >   Si+1111c11111{8"B ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs!AD#6A,D##&E convert_to_mpegr,rc b|jjdt|dt|d|jjdd|iddi|t } d |jcxkrd krnnd S|jd krMttj ttt| | }n)#t$rt|j|jwxYwt|j|)a8 Stream the audio from a Studio project snapshot. Parameters ---------- project_id : str The ID of the Studio project. project_snapshot_id : str The ID of the Studio project snapshot. convert_to_mpeg : typing.Optional[bool] Whether to convert the audio to mpeg format. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- None Examples -------- from elevenlabs import ElevenLabs client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.stream_audio( project_id="21m00Tcm4TlvDq8ikWAM", project_snapshot_id="21m00Tcm4TlvDq8ikWAM", ) rrr/streamrfrrzr{r|r4r5Nr9r6r:r$r>r?rr@rArmr;rrBrCr rrDr r rEr&rprrr,rGrHs r' stream_audiozProjectsClient.stream_audio/siR(5== y"2:">"> y yK[\oKpKp y y y)99;;@!? 2,>    Si+1111c11111$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs.C2A,C22&Dc #K|jjdt|dt|d|jjd|5} d|jcxkrdkrHnnE||d d nd }|| D]}|V ddddS| |jd krMttj ttt| |}n)#t $rt#|j|jwxYwt#|j|#1swxYwYdS)a9 Returns a compressed archive of the Studio project's audio. Parameters ---------- project_id : str The ID of the Studio project. project_snapshot_id : str The ID of the Studio project snapshot. request_options : typing.Optional[RequestOptions] Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response. Yields ------ typing.Iterator[bytes] Streaming archive data rrr/archiverfr1r4r5N chunk_sizerr9r6r:)r$r>streamrr@rAr;ru iter_bytesreadrrBrCr rrDr r rEr&rprr,rG _chunk_size_chunkrHs r'stream_archivezProjectsClient.stream_archivews#4 ! . 5 5 z"2:">"> z zK[\oKpKp z z z)99;;@+ 6   S  W)/5555#55555M\Mh/"5"5lD"I"I"InrK"+"6"6+"6"N"N%%$  S S S S S S S S   (C//2 /*&9(1(8(8"+!1!1" W W W9+@y~VVVV Wy'<>RRR R5 S S S S S S S S S Ss2#E?%A E?BE?E?&E&&E??FFinvalidate_affected_textr,rc  |jjdt|d|jjdt |tjtd|dddi|t } d |j cxkrd krCnn@tj ttt| S|j d krMt!tj t"tt"| |}n)#t$$rt'|j |jwxYwt'|j |)a_ Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does. Parameters ---------- project_id : str The ID of the Studio project. pronunciation_dictionary_locators : typing.Sequence[PronunciationDictionaryVersionLocator] A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"Vmd4Zor6fplcA7WrINey","version_id":"hRPaxjlTdR7wFMhV4w0b"}"' --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"JzWtcGQMJ6bnlWwyMo7e","version_id":"lbmwxiLu4q6txYxgdZqn"}"'. Note that multiple dictionaries are not currently supported by our UI which will only show the first. invalidate_affected_text : typing.Optional[bool] This will automatically mark text in this project for reconversion when the new dictionary applies or the old one no longer does. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- CreatePronunciationDictionaryResponseModel Successful Response Examples -------- from elevenlabs import ElevenLabs, PronunciationDictionaryVersionLocator client = ElevenLabs( api_key="YOUR_API_KEY", ) client.studio.projects.update_pronunciation_dictionaries( project_id="21m00Tcm4TlvDq8ikWAM", pronunciation_dictionary_locators=[ PronunciationDictionaryVersionLocator( pronunciation_dictionary_id="pronunciation_dictionary_id", ) ], ) rr/pronunciation-dictionariesrfwriter8 annotation directionrZrrzr{r|r4r5r6r9r:r$r>r?rr@rArrBSequencerrmr;rCrrrDrr r r rEr&rprZrr,rGrHs r'!update_pronunciation_dictionariesz0ProjectsClient.update_pronunciation_dictionariess\(5== ["2:">"> [ [ [)99;;@5\=%/TU%666 -E  2,!>  $ Si+1111c11111{>"H ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNsAEA,E&E,)+__name__ __module__ __qualname__rr(rBOptionalrrrIrmstrr FileListrboolrrrrrorrurrrrrrrrrrrrIteratorbytesrrrrrr*r'rr*sk.*;....MQ3O3O3O&/.*I3OUh3O3O3O3Ox*.48/3&*'+,048MQ)--1:>04,0:>6:OS-1>B^b.248EI;?;LOLOLOLO!$ LO %( LO  LO/#&LOty1LO,LOs#LO$LO_S)LO C 01LO )IJLO/#&LO oc*!LO"$*?3#7#LO$-%LO&_S)'LO(#)/$"7)LO*%od3+LO,,2?6;s;K+L-LO.oc*/LO0!:;1LO2#)/2Z"[3LO4od+5LO6#OD17LO8_%AB9LO: 8;LO< !=LOLOLOLOd<@ =O=O=O=O 8 =O & =O=O=O=OL'+'+,06:;?iOiOiOiO iO !$ iO %( iOs#iO$iO_S)iO%od3iO 8iO "iOiOiOiO^<@ =O=O=O=O 8 =O $ =O=O=O=OF*.48.2;?QOQOQOQO/#& QO ty1 QO od+ QO 8QO "QOQOQOQOn<@ =O=O=O=O 8 =O % =O=O=O=OF<@ =O=O=O=O 8 =O " =O=O=O=OH<@ BOBOBOBO!BO  8 BO . BOBOBOBOR26;? FOFOFOFO!FO  . FO  8 FO FOFOFOFOZ<@ 4S4S4S4S!4S  8 4S   4S4S4S4Sv;?;? VOVOVOVO,2?;`+a VO #)/$"7 VO  8 VO 4VOVOVOVOVOVOr*rc9NeZdZdefdZdddejedefdZ e e e e e e e e e e e e e e e e e e e e e e ddd e d e d e d e d eje deje j deje deje deje deje dejeje dejedeje deje deje dejedeje dejedejedejeje deje dejedejed ejed!ejed"ejedejedef8d#Zddd$e dejedefd%Ze e e e dd&d$e d e d e d e deje deje deje dejedejedefd'Zddd$e dejedefd(Ze e e dd)d$e d eje deje j d ejedejedef d*Zddd$e dejedefd+Zddd$e dejedefd,Z ddd$e d-e dejede!fd.Z"e dd/d$e d-e d0ejedejeddf d1Z#ddd$e d-e dejedej$e%fd2Z&e dd3d$e dej'e(d4ejedejede)f d5Z*dS)6AsyncProjectsClientr c||_dSr"r#r%s r'r(zAsyncProjectsClient.__init__r)r*Nr+r,r-c K|jjd|jjd|d{V} d|jcxkrdkrCnn@t jttt| S|jdkrMtt jttt| | }n)#t$rt|j|j wxYwt|j| ) aa Returns a list of your Studio projects with metadata. Parameters ---------- request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- GetProjectsResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.get_all() asyncio.run(main()) r/r0r1Nr4r5r6r9r:r=rFs r'rIzAsyncProjectsClient.get_all s>.;CC )99;;@+ D         Si+1111c11111{'"1 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs AD A,D &D1rJrarbrcrdrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`c$K|jjd|jjdid|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|||||||||dd|i|t d{V} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|jwxYwt|j|)a Creates a new Studio project, it can be either initialized as blank, from a document or from a URL. Parameters ---------- name : str The name of the Studio project, used for identification only. default_title_voice_id : str The voice_id that corresponds to the default voice used for new titles. default_paragraph_voice_id : str The voice_id that corresponds to the default voice used for new paragraphs. default_model_id : str The ID of the model to be used for this Studio project, you can query GET /v1/models to list all available models. from_url : typing.Optional[str] An optional URL from which we will extract content to initialize the Studio project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the Studio project as blank. from_document : typing.Optional[core.File] See core.File for more documentation quality_preset : typing.Optional[str] Output quality of the generated audio. Must be one of: standard - standard output format, 128kbps with 44.1kHz sample rate. high - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side. Using this setting increases the credit cost by 20%. ultra - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. Using this setting increases the credit cost by 50%. ultra lossless - ultra quality output format, 705.6kbps with 44.1kHz sample rate and highest improvements on our side in a fully lossless format. Using this setting increases the credit cost by 100%. title : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. author : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. description : typing.Optional[str] An optional description of the Studio project. genres : typing.Optional[typing.List[str]] An optional list of genres associated with the Studio project. target_audience : typing.Optional[ProjectsAddRequestTargetAudience] An optional target audience of the Studio project. language : typing.Optional[str] An optional language of the Studio project. Two-letter language code (ISO 639-1). content_type : typing.Optional[str] An optional content type of the Studio project. original_publication_date : typing.Optional[str] An optional original publication date of the Studio project, in the format YYYY-MM-DD or YYYY. mature_content : typing.Optional[bool] An optional specification of whether this Studio project contains mature content. isbn_number : typing.Optional[str] An optional ISBN number of the Studio project you want to create, this will be added as metadata to the mp3 file on Studio project or chapter download. acx_volume_normalization : typing.Optional[bool] [Deprecated] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements volume_normalization : typing.Optional[bool] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements pronunciation_dictionary_locators : typing.Optional[typing.List[str]] A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"Vmd4Zor6fplcA7WrINey","version_id":"hRPaxjlTdR7wFMhV4w0b"}"' --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"JzWtcGQMJ6bnlWwyMo7e","version_id":"lbmwxiLu4q6txYxgdZqn"}"'. Note that multiple dictionaries are not currently supported by our UI which will only show the first. callback_url : typing.Optional[str] A url that will be called by our service when the Studio project is converted. Request will contain a json blob containing the status of the conversion fiction : typing.Optional[ProjectsAddRequestFiction] An optional specification of whether the content of this Studio project is fiction. apply_text_normalization : typing.Optional[ProjectsAddRequestApplyTextNormalization] This parameter controls text normalization with four modes: 'auto', 'on', 'apply_english' and 'off'. When set to 'auto', the system will automatically decide whether to apply text normalization (e.g., spelling out numbers). With 'on', text normalization will always be applied, while with 'off', it will be skipped. 'apply_english' is the same as 'on' but will assume that text is in English. auto_convert : typing.Optional[bool] Whether to auto convert the Studio project to audio or not. auto_assign_voices : typing.Optional[bool] [Alpha Feature] Whether automatically assign voices to phrases in the create Project. source_type : typing.Optional[ProjectsAddRequestSourceType] The type of Studio project to create. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- AddProjectResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.add( name="name", default_title_voice_id="default_title_voice_id", default_paragraph_voice_id="default_paragraph_voice_id", default_model_id="default_model_id", ) asyncio.run(main()) r/rfrarbrcrdrKrMrNrOrPrQrRrSrTrUrVrWrXrgrLrhNr4r5r6r9r:rlrns r'rozAsyncProjectsClient.addGsr.;CC )99;;@(*@-.H#$4  H  !. &{&"?H ,-F!. {!"+,D#$)=5V ,",D ,&8*38 ,GD$ $ $ $ $ $ $ $ J Si+1111c11111{+"5 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNsAE&A,E&E9rpc K|jjdt||jjd|d{V} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|j wxYwt|j| ) a@ Returns information about a specific Studio project. This endpoint returns more detailed information about a project than `GET /v1/studio`. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ProjectExtendedResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.get( project_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrr0r1Nr4r5r6r9r:rsrts r'ruzAsyncProjectsClient.getsR.;CC @"2:">"> @ @)99;;@+ D         Si+1111c11111{0": ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNAD.A,D&Erwc K|jjdt||jjd|||||||dddi| t d{V} d| jcxkrd krCnn@tj ttt| S| jd krMttj ttt| | } n)#t$rt!| j| j wxYwt!| j| ) a? Updates the specified Studio project by setting the values of the parameters passed. Parameters ---------- project_id : str The ID of the Studio project. name : str The name of the Studio project, used for identification only. default_title_voice_id : str The voice_id that corresponds to the default voice used for new titles. default_paragraph_voice_id : str The voice_id that corresponds to the default voice used for new paragraphs. title : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. author : typing.Optional[str] An optional name of the author of the Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download. isbn_number : typing.Optional[str] An optional ISBN number of the Studio project you want to create, this will be added as metadata to the mp3 file on Studio project or chapter download. volume_normalization : typing.Optional[bool] When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- EditProjectResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.update_metadata( project_id="21m00Tcm4TlvDq8ikWAM", name="Project 1", default_title_voice_id="21m00Tcm4TlvDq8ikWAM", default_paragraph_voice_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrfryrzr{r|Nr4r5r6r9r:r~rs r'rz#AsyncProjectsClient.update_metadatadsP.;CC @"2:">"> @ @)99;;@*@.H *(< 2,#D        & Si+1111c11111{,"6 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs+AD-A,D--&Ec K|jjdt||jjd|d{V} d|jcxkrdkrCnn@tjttt| S|jdkrMttjttt| | }n)#t$rt|j|j wxYwt|j| ) a Deletes a Studio project. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- DeleteProjectResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.delete( project_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrr1Nr4r5r6r9r:rrts r'rzAsyncProjectsClient.deletesR.;CC @"2:">"> @ @)99;;@+ D         Si+1111c11111{."8 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNrrc K|jjdt|d|jjd||dd|i|t d{V} d|jcxkrd krCnn@tj ttt| S|jd krMttj ttt| | }n)#t$rt!|j|j wxYwt!|j| ) a Updates Studio project content. Parameters ---------- project_id : str The ID of the Studio project. from_url : typing.Optional[str] An optional URL from which we will extract content to initialize the Studio project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the Studio project as blank. from_document : typing.Optional[core.File] See core.File for more documentation auto_convert : typing.Optional[bool] Whether to auto convert the Studio project to audio or not. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- EditProjectResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.update_content( project_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrrfrrLrhNr4r5r6r9r:r~rs r'rz"AsyncProjectsClient.update_contentsj.;CC H"2:">"> H H H)99;;@$ ,  ,D          Si+1111c11111{,"6 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs'AD) None: await client.studio.projects.convert( project_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrrfr1Nr4r5r6r9r:rrts r'rzAsyncProjectsClient.convertysR.;CC H"2:">"> H H H)99;;@+ D         Si+1111c11111{/"9 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNAD/A,D&Ec K|jjdt|d|jjd|d{V} d|jcxkrdkrCnn@tjttt| S|jd krMttjttt| | }n)#t$rt|j|j wxYwt|j| ) a Retrieves a list of snapshots for a Studio project. Parameters ---------- project_id : str The ID of the Studio project. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ProjectSnapshotsResponse Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.get_snapshots( project_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrr0r1Nr4r5r6r9r:rrts r'rz!AsyncProjectsClient.get_snapshotssR.;CC J"2:">"> J J J)99;;@+ D         Si+1111c11111{,"6 ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNrrc K|jjdt|dt||jjd|d{V} d|jcxkrdkrCnn@tjttt| S|jd krMttjttt| | }n)#t$rt|j|j wxYwt|j| ) a} Returns the project snapshot. Parameters ---------- project_id : str The ID of the Studio project. project_snapshot_id : str The ID of the Studio project snapshot. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- ProjectSnapshotExtendedResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.get_project_snapshot( project_id="21m00Tcm4TlvDq8ikWAM", project_snapshot_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrr0r1Nr4r5r6r9r:rrs r'rz(AsyncProjectsClient.get_project_snapshots\.;CC r"2:">"> r rK[\oKpKp r r)99;;@+ D         Si+1111c11111{8"B ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs)AD+>A,D++&Errc rK|jjdt|dt|d|jjdd|iddi|t d {V} d |jcxkrd krnnd S|jd krMttj ttt| | }n)#t$rt|j|jwxYwt|j|)a Stream the audio from a Studio project snapshot. Parameters ---------- project_id : str The ID of the Studio project. project_snapshot_id : str The ID of the Studio project snapshot. convert_to_mpeg : typing.Optional[bool] Whether to convert the audio to mpeg format. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- None Examples -------- import asyncio from elevenlabs import AsyncElevenLabs client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.stream_audio( project_id="21m00Tcm4TlvDq8ikWAM", project_snapshot_id="21m00Tcm4TlvDq8ikWAM", ) asyncio.run(main()) rrrrrfrrzr{r|Nr4r5r9r6r:rrs r'rz AsyncProjectsClient.stream_audioSsb.;CC y"2:">"> y yK[\oKpKp y y y)99;;@!? 2,D          Si+1111c11111$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs6C: A,C::&D c XK|jjdt|dt|d|jjd|4d{V } d|jcxkrdkrUnnR||d d nd }|| 23d{V}|WV 6 dddd{VdS| d{V|jd krMttj ttt| |}n)#t $rt#|j|jwxYwt#|j|#1d{VswxYwYdS)a> Returns a compressed archive of the Studio project's audio. Parameters ---------- project_id : str The ID of the Studio project. project_snapshot_id : str The ID of the Studio project snapshot. request_options : typing.Optional[RequestOptions] Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response. Yields ------ typing.AsyncIterator[bytes] Streaming archive data rrrrrfr1Nr4r5rrrr9r6r:)r$r>rrr@rAr;ru aiter_bytesareadrrBrCr rrDr r rErs r'rz"AsyncProjectsClient.stream_archives4'4;; z"2:">"> z zK[\oKpKp z z z)99;;@+ <   S S S S S S S S  W)/5555#55555M\Mh/"5"5lD"I"I"InrK(1(=(=(=(U(U%%%%%%%f$ )V S S S S S S S S S S S S S S oo'''''''''(C//2 /*&9(1(8(8"+!1!1" W W W9+@y~VVVV Wy'<>RRR R5 S S S S S S S S S S S S S S S Ss>*F,AE1B>7EBEF&FF F#&F#rrc K|jjdt|d|jjdt |tjtd|dddi|t d {V} d |j cxkrd krCnn@tj ttt| S|j dkrMt!tj t"tt"| |}n)#t$$rt'|j |jwxYwt'|j |)a Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does. Parameters ---------- project_id : str The ID of the Studio project. pronunciation_dictionary_locators : typing.Sequence[PronunciationDictionaryVersionLocator] A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"Vmd4Zor6fplcA7WrINey","version_id":"hRPaxjlTdR7wFMhV4w0b"}"' --form 'pronunciation_dictionary_locators="{"pronunciation_dictionary_id":"JzWtcGQMJ6bnlWwyMo7e","version_id":"lbmwxiLu4q6txYxgdZqn"}"'. Note that multiple dictionaries are not currently supported by our UI which will only show the first. invalidate_affected_text : typing.Optional[bool] This will automatically mark text in this project for reconversion when the new dictionary applies or the old one no longer does. request_options : typing.Optional[RequestOptions] Request-specific configuration. Returns ------- CreatePronunciationDictionaryResponseModel Successful Response Examples -------- import asyncio from elevenlabs import AsyncElevenLabs, PronunciationDictionaryVersionLocator client = AsyncElevenLabs( api_key="YOUR_API_KEY", ) async def main() -> None: await client.studio.projects.update_pronunciation_dictionaries( project_id="21m00Tcm4TlvDq8ikWAM", pronunciation_dictionary_locators=[ PronunciationDictionaryVersionLocator( pronunciation_dictionary_id="pronunciation_dictionary_id", ) ], ) asyncio.run(main()) rrrrfrrrrzr{r|Nr4r5r6r9r:rrs r'rz5AsyncProjectsClient.update_pronunciation_dictionariessl.;CC ["2:">"> [ [ [)99;;@5\=%/TU%666 -E  2,!D        $ Si+1111c11111{>"H ) 0 0$++.K+&"5$-NN$4$4'^^--NN S S Sy'<9>RRR R S9#8~NNNNs AE!A,E&E4)+rrrrr(rBrrrrIrmrr rrrrrrrrrorrurrrrrrrrrrrr AsyncIteratorrrrrrrrr*r'rrs.*<....SW;O;O;O0O;O[n;O;O;O;OH*.48/3&*'+,048MQ)--1:>04,0:>6:OS-1>B^b.248EI;?;TOTOTOTO!$ TO %( TO  TO/#&TOty1TO,TOs#TO$TO_S)TO C 01TO )IJTO/#&TO oc*!TO"$*?3#7#TO$-%TO&_S)'TO(#)/$"7)TO*%od3+TO,,2?6;s;K+L-TO.oc*/TO0!:;1TO2#)/2Z"[3TO4od+5TO6#OD17TO8_%AB9TO: 8;TO< !=TOTOTOTOt<@ EOEOEOEO 8 EO & EOEOEOEO\'+'+,06:;?qOqOqOqO qO !$ qO %( qOs#qO$qO_S)qO%od3qO 8qO "qOqOqOqOn<@ EOEOEOEO 8 EO $ EOEOEOEOV*.48.2;?YOYOYOYO/#& YO ty1 YO od+ YO 8YO "YOYOYOYO~<@ EOEOEOEO 8 EO % EOEOEOEOV<@ EOEOEOEO 8 EO " EOEOEOEOX<@ JOJOJOJO!JO  8 JO . JOJOJOJOb26;? NONONONO!NO  . NO  8 NO NONONONOj<@ 4S4S4S4S!4S  8 4S  e $ 4S4S4S4Sv;?;? ^O^O^O^O,2?;`+a ^O #)/$"7 ^O  8 ^O 4^O^O^O^O^O^Or*r)7rBcore.client_wrapperrcore.request_optionsrtypes.get_projects_responsercore.unchecked_base_modelr!errors.unprocessable_entity_errorrtypes.http_validation_errorr json.decoderr core.api_errorr r *types.projects_add_request_target_audiencer"types.projects_add_request_fictionr3types.projects_add_request_apply_text_normalizationr&types.projects_add_request_source_typer types.add_project_response_modelr%types.project_extended_response_modelrcore.jsonable_encoderr!types.edit_project_response_modelr#types.delete_project_response_modelr$types.convert_project_response_modelr types.project_snapshots_responser.types.project_snapshot_extended_response_modelr.types.pronunciation_dictionary_version_locatorr4types.create_pronunciation_dictionary_response_modelrcore.serializationrrrCAnyrmrrrr*r'rs 444444222222>>>>>>777777IIIIII>>>>>>((((((&&&&&&XXXXXXIIIIIIQPPPPPGGGGGGQQQQQQ555555IIIIIIMMMMMMOOOOOOHHHHHHJIIIII555555v{6:s##YOYOYOYOYOYOYOYOxqOqOqOqOqOqOqOqOqOqOr*