murf 2.0.0__tar.gz → 2.0.2__tar.gz

{murf-2.0.0 → murf-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: murf
-Version: 2.0.0
+Version: 2.0.2
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{murf-2.0.0 → murf-2.0.2}/pyproject.toml

@@ -3,7 +3,7 @@ name = "murf"
 
 [tool.poetry]
 name = "murf"
-version = "2.0.0"
+version = "2.0.2"
 description = ""
 readme = "README.md"
 authors = []

{murf-2.0.0 → murf-2.0.2}/src/murf/__init__.py

@@ -25,11 +25,14 @@ from .types import (
     PronunciationDetail,
     PronunciationDetailType,
     SendText,
+    SendTextVoiceConfig,
+    SendTextVoiceConfigPronunciationDictionaryValue,
+    SendTextVoiceConfigPronunciationDictionaryValueType,
     SetAdvancedSettings,
-    SetVoiceConfiguration,
-    SetVoiceConfigurationVoiceConfig,
-    SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue,
-    SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType,
+    SetVoiceConfigurationOrInitializeContext,
+    SetVoiceConfigurationOrInitializeContextVoiceConfig,
+    SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue,
+    SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType,
     SourceLocaleResponse,
     SpeechToSpeechResponse,
     StyleDetails,
@@ -92,12 +95,15 @@ __all__ = [
     "ReceiveMessage",
     "SendMessage",
     "SendText",
+    "SendTextVoiceConfig",
+    "SendTextVoiceConfigPronunciationDictionaryValue",
+    "SendTextVoiceConfigPronunciationDictionaryValueType",
     "ServiceUnavailableError",
     "SetAdvancedSettings",
-    "SetVoiceConfiguration",
-    "SetVoiceConfigurationVoiceConfig",
-    "SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue",
-    "SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType",
+    "SetVoiceConfigurationOrInitializeContext",
+    "SetVoiceConfigurationOrInitializeContextVoiceConfig",
+    "SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue",
+    "SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType",
     "SourceLocaleResponse",
     "SpeechToSpeechResponse",
     "StyleDetails",

{murf-2.0.0 → murf-2.0.2}/src/murf/core/client_wrapper.py

@@ -23,7 +23,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "murf",
-            "X-Fern-SDK-Version": "2.0.0",
+            "X-Fern-SDK-Version": "2.0.2",
         }
         if self._api_key is not None:
             headers["api-key"] = self._api_key

{murf-2.0.0 → murf-2.0.2}/src/murf/core/http_client.py

@@ -85,8 +85,8 @@ def _retry_timeout(response: httpx.Response, retries: int) -> float:
 
 
 def _should_retry(response: httpx.Response) -> bool:
-    retriable_400s = [429, 408, 409]
-    return response.status_code >= 500 or response.status_code in retriable_400s
+    retryable_400s = [429, 408, 409]
+    return response.status_code >= 500 or response.status_code in retryable_400s
 
 
 def remove_omit_from_dict(
@@ -183,7 +183,7 @@ class HttpClient:
         files: typing.Optional[typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]]] = None,
         headers: typing.Optional[typing.Dict[str, typing.Any]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-        retries: int = 0,
+        retries: int = 2,
         omit: typing.Optional[typing.Any] = None,
     ) -> httpx.Response:
         base_url = self.get_base_url(base_url)
@@ -269,7 +269,7 @@ class HttpClient:
         files: typing.Optional[typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]]] = None,
         headers: typing.Optional[typing.Dict[str, typing.Any]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-        retries: int = 0,
+        retries: int = 2,
         omit: typing.Optional[typing.Any] = None,
     ) -> typing.Iterator[httpx.Response]:
         base_url = self.get_base_url(base_url)
@@ -359,7 +359,7 @@ class AsyncHttpClient:
         files: typing.Optional[typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]]] = None,
         headers: typing.Optional[typing.Dict[str, typing.Any]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-        retries: int = 0,
+        retries: int = 2,
         omit: typing.Optional[typing.Any] = None,
     ) -> httpx.Response:
         base_url = self.get_base_url(base_url)
@@ -445,7 +445,7 @@ class AsyncHttpClient:
         files: typing.Optional[typing.Dict[str, typing.Optional[typing.Union[File, typing.List[File]]]]] = None,
         headers: typing.Optional[typing.Dict[str, typing.Any]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-        retries: int = 0,
+        retries: int = 2,
         omit: typing.Optional[typing.Any] = None,
     ) -> typing.AsyncIterator[httpx.Response]:
         base_url = self.get_base_url(base_url)

{murf-2.0.0 → murf-2.0.2}/src/murf/core/pydantic_utilities.py

@@ -79,7 +79,7 @@ def to_jsonable_with_fallback(
 class UniversalBaseModel(pydantic.BaseModel):
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            # Allow fields begining with `model_` to be used in the model
+            # Allow fields beginning with `model_` to be used in the model
             protected_namespaces=(),
         )  # type: ignore # Pydantic v2
 
@@ -128,7 +128,7 @@ class UniversalBaseModel(pydantic.BaseModel):
         Override the default dict method to `exclude_unset` by default. This function patches
         `exclude_unset` to work include fields within non-None default values.
         """
-        # Note: the logic here is multi-plexed given the levers exposed in Pydantic V1 vs V2
+        # Note: the logic here is multiplexed given the levers exposed in Pydantic V1 vs V2
         # Pydantic V1's .dict can be extremely slow, so we do not want to call it twice.
         #
         # We'd ideally do the same for Pydantic V2, but it shells out to a library to serialize models

{murf-2.0.0 → murf-2.0.2}/src/murf/stream_input/types/send_message.py

@@ -1,9 +1,9 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from ...types.set_voice_configuration import SetVoiceConfiguration
+from ...types.set_voice_configuration_or_initialize_context import SetVoiceConfigurationOrInitializeContext
 from ...types.send_text import SendText
 from ...types.set_advanced_settings import SetAdvancedSettings
 from ...types.clear_context import ClearContext
 
-SendMessage = typing.Union[SetVoiceConfiguration, SendText, SetAdvancedSettings, ClearContext]
+SendMessage = typing.Union[SetVoiceConfigurationOrInitializeContext, SendText, SetAdvancedSettings, ClearContext]

{murf-2.0.0 → murf-2.0.2}/src/murf/text_to_speech/client.py

@@ -34,6 +34,7 @@ class TextToSpeechClient:
         audio_duration: typing.Optional[float] = OMIT,
         channel_type: typing.Optional[str] = OMIT,
         encode_as_base_64: typing.Optional[bool] = OMIT,
+        encoded_as_base_64_with_zero_retention: typing.Optional[bool] = OMIT,
         format: typing.Optional[str] = OMIT,
         model_version: typing.Optional[GenerateSpeechRequestModelVersion] = OMIT,
         multi_native_locale: typing.Optional[str] = OMIT,
@@ -43,6 +44,7 @@ class TextToSpeechClient:
         sample_rate: typing.Optional[float] = OMIT,
         style: typing.Optional[str] = OMIT,
         variation: typing.Optional[int] = OMIT,
+        word_durations_as_original_text: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> GenerateSpeechResponse:
         """
@@ -65,8 +67,11 @@ class TextToSpeechClient:
         encode_as_base_64 : typing.Optional[bool]
             Set to true to receive audio in response as a Base64 encoded string instead of a url.
 
+        encoded_as_base_64_with_zero_retention : typing.Optional[bool]
+            Set to true to receive audio in response as a Base64 encoded string with zero data retention
+
         format : typing.Optional[str]
-            Format of the generated audio file. Valid values: MP3, WAV, FLAC, ALAW, ULAW
+            Format of the generated audio file. Valid values: MP3, WAV, FLAC, ALAW, ULAW, PCM, OGG
 
         model_version : typing.Optional[GenerateSpeechRequestModelVersion]
             Valid values: GEN1, GEN2. Use GEN2 to generate audio using new and advanced model. Outputs from Gen 2 will sound better, but different from the old model
@@ -97,6 +102,9 @@ class TextToSpeechClient:
         variation : typing.Optional[int]
             Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
 
+        word_durations_as_original_text : typing.Optional[bool]
+            If set to true, the word durations in response will return words as the original input text. (English only)
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -125,6 +133,7 @@ class TextToSpeechClient:
                 "audioDuration": audio_duration,
                 "channelType": channel_type,
                 "encodeAsBase64": encode_as_base_64,
+                "encodedAsBase64WithZeroRetention": encoded_as_base_64_with_zero_retention,
                 "format": format,
                 "modelVersion": model_version,
                 "multiNativeLocale": multi_native_locale,
@@ -140,6 +149,7 @@ class TextToSpeechClient:
                 "text": text,
                 "variation": variation,
                 "voiceId": voice_id,
+                "wordDurationsAsOriginalText": word_durations_as_original_text,
             },
             headers={
                 "content-type": "application/json",
@@ -220,6 +230,7 @@ class TextToSpeechClient:
         format: typing.Optional[str] = OMIT,
         multi_native_locale: typing.Optional[str] = OMIT,
         pitch: typing.Optional[int] = OMIT,
+        pronunciation_dictionary: typing.Optional[typing.Dict[str, PronunciationDetail]] = OMIT,
         rate: typing.Optional[int] = OMIT,
         sample_rate: typing.Optional[float] = OMIT,
         style: typing.Optional[str] = OMIT,
@@ -241,7 +252,7 @@ class TextToSpeechClient:
             Valid values: STEREO, MONO
 
         format : typing.Optional[str]
-            Format of the generated audio file. Valid values: MP3, WAV
+            Format of the generated audio file. Valid values: MP3, WAV, PCM
 
         multi_native_locale : typing.Optional[str]
             Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model.
@@ -250,6 +261,13 @@ class TextToSpeechClient:
         pitch : typing.Optional[int]
             Pitch of the voiceover
 
+        pronunciation_dictionary : typing.Optional[typing.Dict[str, PronunciationDetail]]
+            An object used to define custom pronunciations.
+
+             Example 1: {"live":{"type": "IPA", "pronunciation": "laɪv"}}.
+
+             Example 2: {"2022":{"type": "SAY_AS", "pronunciation": "twenty twenty two"}}
+
         rate : typing.Optional[int]
             Speed of the voiceover
 
@@ -288,6 +306,11 @@ class TextToSpeechClient:
                 "format": format,
                 "multiNativeLocale": multi_native_locale,
                 "pitch": pitch,
+                "pronunciationDictionary": convert_and_respect_annotation_metadata(
+                    object_=pronunciation_dictionary,
+                    annotation=typing.Dict[str, PronunciationDetail],
+                    direction="write",
+                ),
                 "rate": rate,
                 "sampleRate": sample_rate,
                 "style": style,
@@ -466,6 +489,7 @@ class AsyncTextToSpeechClient:
         audio_duration: typing.Optional[float] = OMIT,
         channel_type: typing.Optional[str] = OMIT,
         encode_as_base_64: typing.Optional[bool] = OMIT,
+        encoded_as_base_64_with_zero_retention: typing.Optional[bool] = OMIT,
         format: typing.Optional[str] = OMIT,
         model_version: typing.Optional[GenerateSpeechRequestModelVersion] = OMIT,
         multi_native_locale: typing.Optional[str] = OMIT,
@@ -475,6 +499,7 @@ class AsyncTextToSpeechClient:
         sample_rate: typing.Optional[float] = OMIT,
         style: typing.Optional[str] = OMIT,
         variation: typing.Optional[int] = OMIT,
+        word_durations_as_original_text: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> GenerateSpeechResponse:
         """
@@ -497,8 +522,11 @@ class AsyncTextToSpeechClient:
         encode_as_base_64 : typing.Optional[bool]
             Set to true to receive audio in response as a Base64 encoded string instead of a url.
 
+        encoded_as_base_64_with_zero_retention : typing.Optional[bool]
+            Set to true to receive audio in response as a Base64 encoded string with zero data retention
+
         format : typing.Optional[str]
-            Format of the generated audio file. Valid values: MP3, WAV, FLAC, ALAW, ULAW
+            Format of the generated audio file. Valid values: MP3, WAV, FLAC, ALAW, ULAW, PCM, OGG
 
         model_version : typing.Optional[GenerateSpeechRequestModelVersion]
             Valid values: GEN1, GEN2. Use GEN2 to generate audio using new and advanced model. Outputs from Gen 2 will sound better, but different from the old model
@@ -529,6 +557,9 @@ class AsyncTextToSpeechClient:
         variation : typing.Optional[int]
             Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
 
+        word_durations_as_original_text : typing.Optional[bool]
+            If set to true, the word durations in response will return words as the original input text. (English only)
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -565,6 +596,7 @@ class AsyncTextToSpeechClient:
                 "audioDuration": audio_duration,
                 "channelType": channel_type,
                 "encodeAsBase64": encode_as_base_64,
+                "encodedAsBase64WithZeroRetention": encoded_as_base_64_with_zero_retention,
                 "format": format,
                 "modelVersion": model_version,
                 "multiNativeLocale": multi_native_locale,
@@ -580,6 +612,7 @@ class AsyncTextToSpeechClient:
                 "text": text,
                 "variation": variation,
                 "voiceId": voice_id,
+                "wordDurationsAsOriginalText": word_durations_as_original_text,
             },
             headers={
                 "content-type": "application/json",
@@ -660,6 +693,7 @@ class AsyncTextToSpeechClient:
         format: typing.Optional[str] = OMIT,
         multi_native_locale: typing.Optional[str] = OMIT,
         pitch: typing.Optional[int] = OMIT,
+        pronunciation_dictionary: typing.Optional[typing.Dict[str, PronunciationDetail]] = OMIT,
         rate: typing.Optional[int] = OMIT,
         sample_rate: typing.Optional[float] = OMIT,
         style: typing.Optional[str] = OMIT,
@@ -681,7 +715,7 @@ class AsyncTextToSpeechClient:
             Valid values: STEREO, MONO
 
         format : typing.Optional[str]
-            Format of the generated audio file. Valid values: MP3, WAV
+            Format of the generated audio file. Valid values: MP3, WAV, PCM
 
         multi_native_locale : typing.Optional[str]
             Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model.
@@ -690,6 +724,13 @@ class AsyncTextToSpeechClient:
         pitch : typing.Optional[int]
             Pitch of the voiceover
 
+        pronunciation_dictionary : typing.Optional[typing.Dict[str, PronunciationDetail]]
+            An object used to define custom pronunciations.
+
+             Example 1: {"live":{"type": "IPA", "pronunciation": "laɪv"}}.
+
+             Example 2: {"2022":{"type": "SAY_AS", "pronunciation": "twenty twenty two"}}
+
         rate : typing.Optional[int]
             Speed of the voiceover
 
@@ -736,6 +777,11 @@ class AsyncTextToSpeechClient:
                 "format": format,
                 "multiNativeLocale": multi_native_locale,
                 "pitch": pitch,
+                "pronunciationDictionary": convert_and_respect_annotation_metadata(
+                    object_=pronunciation_dictionary,
+                    annotation=typing.Dict[str, PronunciationDetail],
+                    direction="write",
+                ),
                 "rate": rate,
                 "sampleRate": sample_rate,
                 "style": style,

{murf-2.0.0 → murf-2.0.2}/src/murf/types/__init__.py

@@ -24,14 +24,21 @@ from .murf_api_translation_response import MurfApiTranslationResponse
 from .pronunciation_detail import PronunciationDetail
 from .pronunciation_detail_type import PronunciationDetailType
 from .send_text import SendText
+from .send_text_voice_config import SendTextVoiceConfig
+from .send_text_voice_config_pronunciation_dictionary_value import SendTextVoiceConfigPronunciationDictionaryValue
+from .send_text_voice_config_pronunciation_dictionary_value_type import (
+    SendTextVoiceConfigPronunciationDictionaryValueType,
+)
 from .set_advanced_settings import SetAdvancedSettings
-from .set_voice_configuration import SetVoiceConfiguration
-from .set_voice_configuration_voice_config import SetVoiceConfigurationVoiceConfig
-from .set_voice_configuration_voice_config_pronunciation_dictionary_value import (
-    SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue,
+from .set_voice_configuration_or_initialize_context import SetVoiceConfigurationOrInitializeContext
+from .set_voice_configuration_or_initialize_context_voice_config import (
+    SetVoiceConfigurationOrInitializeContextVoiceConfig,
+)
+from .set_voice_configuration_or_initialize_context_voice_config_pronunciation_dictionary_value import (
+    SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue,
 )
-from .set_voice_configuration_voice_config_pronunciation_dictionary_value_type import (
-    SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType,
+from .set_voice_configuration_or_initialize_context_voice_config_pronunciation_dictionary_value_type import (
+    SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType,
 )
 from .source_locale_response import SourceLocaleResponse
 from .speech_to_speech_response import SpeechToSpeechResponse
@@ -72,11 +79,14 @@ __all__ = [
     "PronunciationDetail",
     "PronunciationDetailType",
     "SendText",
+    "SendTextVoiceConfig",
+    "SendTextVoiceConfigPronunciationDictionaryValue",
+    "SendTextVoiceConfigPronunciationDictionaryValueType",
     "SetAdvancedSettings",
-    "SetVoiceConfiguration",
-    "SetVoiceConfigurationVoiceConfig",
-    "SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue",
-    "SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType",
+    "SetVoiceConfigurationOrInitializeContext",
+    "SetVoiceConfigurationOrInitializeContextVoiceConfig",
+    "SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue",
+    "SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType",
     "SourceLocaleResponse",
     "SpeechToSpeechResponse",
     "StyleDetails",

{murf-2.0.0 → murf-2.0.2}/src/murf/types/final_output.py

@@ -7,7 +7,7 @@ from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
 class FinalOutput(UncheckedBaseModel):
-    is_final: bool = pydantic.Field()
+    final: bool = pydantic.Field()
     """
     Indicates if the audio is final, you will not receive audio param in this message
     """

{murf-2.0.0 → murf-2.0.2}/src/murf/types/send_text.py

@@ -3,6 +3,7 @@
 from ..core.unchecked_base_model import UncheckedBaseModel
 import pydantic
 import typing
+from .send_text_voice_config import SendTextVoiceConfig
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
@@ -22,6 +23,8 @@ class SendText(UncheckedBaseModel):
     Indicates if this is the end of the text stream (optional)
     """
 
+    voice_config: typing.Optional[SendTextVoiceConfig] = None
+
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:

murf-2.0.2/src/murf/types/send_text_voice_config.py

@@ -0,0 +1,55 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from .send_text_voice_config_pronunciation_dictionary_value import SendTextVoiceConfigPronunciationDictionaryValue
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class SendTextVoiceConfig(UncheckedBaseModel):
+    voice_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Voice ID to use for TTS. Defaults to "en-US-daniel"
+    """
+
+    style: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The style of speech (optional)
+    """
+
+    rate: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Speech rate (optional)
+    """
+
+    pitch: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Speech pitch (optional)
+    """
+
+    pronunciation_dictionary: typing.Optional[typing.Dict[str, SendTextVoiceConfigPronunciationDictionaryValue]] = (
+        pydantic.Field(default=None)
+    )
+    """
+    A map of words to their pronunciation details. Example 1: {"live":{"type": "IPA", "pronunciation": "laɪv"}}.
+    """
+
+    variation: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
+    """
+
+    multi_native_locale: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Specifies the language for the generated audio, enabling a voice to speak in multiple languages natively. Only available in the Gen2 model. Valid values: "en-US", "en-UK", "es-ES", etc. Use the GET /v1/speed/voices endpoint to retrieve the list of available voices and languages.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-2.0.0/src/murf/types/set_voice_configuration_voice_config_pronunciation_dictionary_value.py → murf-2.0.2/src/murf/types/send_text_voice_config_pronunciation_dictionary_value.py

@@ -1,16 +1,16 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from ..core.unchecked_base_model import UncheckedBaseModel
-from .set_voice_configuration_voice_config_pronunciation_dictionary_value_type import (
-    SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType,
+from .send_text_voice_config_pronunciation_dictionary_value_type import (
+    SendTextVoiceConfigPronunciationDictionaryValueType,
 )
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 import typing
 
 
-class SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue(UncheckedBaseModel):
-    type: SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType = pydantic.Field()
+class SendTextVoiceConfigPronunciationDictionaryValue(UncheckedBaseModel):
+    type: SendTextVoiceConfigPronunciationDictionaryValueType = pydantic.Field()
     """
     Type of pronunciation (IPA or SAY_AS)
     """

murf-2.0.2/src/murf/types/send_text_voice_config_pronunciation_dictionary_value_type.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+SendTextVoiceConfigPronunciationDictionaryValueType = typing.Union[typing.Literal["IPA", "SAY_AS"], typing.Any]

murf-2.0.2/src/murf/types/set_voice_configuration_or_initialize_context.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .set_voice_configuration_or_initialize_context_voice_config import (
+    SetVoiceConfigurationOrInitializeContextVoiceConfig,
+)
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class SetVoiceConfigurationOrInitializeContext(UncheckedBaseModel):
+    voice_config: SetVoiceConfigurationOrInitializeContextVoiceConfig
+    context_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Optional context identifier
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-2.0.0/src/murf/types/set_voice_configuration_voice_config.py → murf-2.0.2/src/murf/types/set_voice_configuration_or_initialize_context_voice_config.py

@@ -3,13 +3,13 @@
 from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
 import pydantic
-from .set_voice_configuration_voice_config_pronunciation_dictionary_value import (
-    SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue,
+from .set_voice_configuration_or_initialize_context_voice_config_pronunciation_dictionary_value import (
+    SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue,
 )
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
-class SetVoiceConfigurationVoiceConfig(UncheckedBaseModel):
+class SetVoiceConfigurationOrInitializeContextVoiceConfig(UncheckedBaseModel):
     voice_id: typing.Optional[str] = pydantic.Field(default=None)
     """
     Voice ID to use for TTS. Defaults to "en-US-daniel"
@@ -31,7 +31,7 @@ class SetVoiceConfigurationVoiceConfig(UncheckedBaseModel):
     """
 
     pronunciation_dictionary: typing.Optional[
-        typing.Dict[str, SetVoiceConfigurationVoiceConfigPronunciationDictionaryValue]
+        typing.Dict[str, SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue]
     ] = pydantic.Field(default=None)
     """
     A map of words to their pronunciation details. Example 1: {"live":{"type": "IPA", "pronunciation": "laɪv"}}.

murf-2.0.2/src/murf/types/set_voice_configuration_or_initialize_context_voice_config_pronunciation_dictionary_value.py

@@ -0,0 +1,30 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .set_voice_configuration_or_initialize_context_voice_config_pronunciation_dictionary_value_type import (
+    SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType,
+)
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+
+
+class SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValue(UncheckedBaseModel):
+    type: SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType = pydantic.Field()
+    """
+    Type of pronunciation (IPA or SAY_AS)
+    """
+
+    pronunciation: str = pydantic.Field()
+    """
+    The actual pronunciation string
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

murf-2.0.0/src/murf/types/set_voice_configuration_voice_config_pronunciation_dictionary_value_type.py → murf-2.0.2/src/murf/types/set_voice_configuration_or_initialize_context_voice_config_pronunciation_dictionary_value_type.py

@@ -2,6 +2,6 @@
 
 import typing
 
-SetVoiceConfigurationVoiceConfigPronunciationDictionaryValueType = typing.Union[
+SetVoiceConfigurationOrInitializeContextVoiceConfigPronunciationDictionaryValueType = typing.Union[
     typing.Literal["IPA", "SAY_AS"], typing.Any
 ]

{murf-2.0.0 → murf-2.0.2}/src/murf/voice_changer/client.py

@@ -26,6 +26,7 @@ class VoiceChangerClient:
     def convert(
         self,
         *,
+        voice_id: str,
         audio_duration: typing.Optional[float] = OMIT,
         channel_type: typing.Optional[str] = OMIT,
         encode_output_as_base_64: typing.Optional[bool] = OMIT,
@@ -43,7 +44,6 @@ class VoiceChangerClient:
         style: typing.Optional[str] = OMIT,
         transcription: typing.Optional[str] = OMIT,
         variation: typing.Optional[int] = OMIT,
-        voice_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SpeechToSpeechResponse:
         """
@@ -51,6 +51,9 @@ class VoiceChangerClient:
 
         Parameters
         ----------
+        voice_id : str
+            Use the GET /v1/speech/voices API to find supported voiceIds. You can use either the voiceId (e.g. en-US-natalie) or just the voice actor's name (e.g. natalie).
+
         audio_duration : typing.Optional[float]
             This parameter allows specifying the duration (in seconds) for the generated audio. If the value is 0, this parameter will be ignored. Only available for Gen2 model.
 
@@ -108,9 +111,6 @@ class VoiceChangerClient:
         variation : typing.Optional[int]
             Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
 
-        voice_id : typing.Optional[str]
-            Use the GET /v1/speech/voices API to find supported voiceIds. You can use either the voiceId (e.g. en-US-natalie) or just the voice actor's name (e.g. natalie).
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -126,7 +126,9 @@ class VoiceChangerClient:
         client = Murf(
             api_key="YOUR_API_KEY",
         )
-        client.voice_changer.convert()
+        client.voice_changer.convert(
+            voice_id="voice_id",
+        )
         """
         _response = self._client_wrapper.httpx_client.request(
             "v1/voice-changer/convert",
@@ -229,6 +231,7 @@ class AsyncVoiceChangerClient:
     async def convert(
         self,
         *,
+        voice_id: str,
         audio_duration: typing.Optional[float] = OMIT,
         channel_type: typing.Optional[str] = OMIT,
         encode_output_as_base_64: typing.Optional[bool] = OMIT,
@@ -246,7 +249,6 @@ class AsyncVoiceChangerClient:
         style: typing.Optional[str] = OMIT,
         transcription: typing.Optional[str] = OMIT,
         variation: typing.Optional[int] = OMIT,
-        voice_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SpeechToSpeechResponse:
         """
@@ -254,6 +256,9 @@ class AsyncVoiceChangerClient:
 
         Parameters
         ----------
+        voice_id : str
+            Use the GET /v1/speech/voices API to find supported voiceIds. You can use either the voiceId (e.g. en-US-natalie) or just the voice actor's name (e.g. natalie).
+
         audio_duration : typing.Optional[float]
             This parameter allows specifying the duration (in seconds) for the generated audio. If the value is 0, this parameter will be ignored. Only available for Gen2 model.
 
@@ -311,9 +316,6 @@ class AsyncVoiceChangerClient:
         variation : typing.Optional[int]
             Higher values will add more variation in terms of Pause, Pitch, and Speed to the voice. Only available for Gen2 model.
 
-        voice_id : typing.Optional[str]
-            Use the GET /v1/speech/voices API to find supported voiceIds. You can use either the voiceId (e.g. en-US-natalie) or just the voice actor's name (e.g. natalie).
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -334,7 +336,9 @@ class AsyncVoiceChangerClient:
 
 
         async def main() -> None:
-            await client.voice_changer.convert()
+            await client.voice_changer.convert(
+                voice_id="voice_id",
+            )
 
 
         asyncio.run(main())

murf-2.0.0/src/murf/types/set_voice_configuration.py

@@ -1,20 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-from ..core.unchecked_base_model import UncheckedBaseModel
-from .set_voice_configuration_voice_config import SetVoiceConfigurationVoiceConfig
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-import typing
-import pydantic
-
-
-class SetVoiceConfiguration(UncheckedBaseModel):
-    voice_config: SetVoiceConfigurationVoiceConfig
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow