magic_hour 0.9.5__py3-none-any.whl → 0.44.0__py3-none-any.whl

magic_hour/types/params/{post_v1_ai_qr_code_generator_body_style.py → v1_ai_qr_code_generator_create_body_style.py}

@@ -2,9 +2,9 @@ import pydantic
 import typing_extensions
 
 
-class PostV1AiQrCodeGeneratorBodyStyle(typing_extensions.TypedDict):
+class V1AiQrCodeGeneratorCreateBodyStyle(typing_extensions.TypedDict):
     """
-    PostV1AiQrCodeGeneratorBodyStyle
+    V1AiQrCodeGeneratorCreateBodyStyle
     """
 
     art_style: typing_extensions.Required[str]
@@ -13,9 +13,9 @@ class PostV1AiQrCodeGeneratorBodyStyle(typing_extensions.TypedDict):
     """
 
 
-class _SerializerPostV1AiQrCodeGeneratorBodyStyle(pydantic.BaseModel):
+class _SerializerV1AiQrCodeGeneratorCreateBodyStyle(pydantic.BaseModel):
     """
-    Serializer for PostV1AiQrCodeGeneratorBodyStyle handling case conversions
+    Serializer for V1AiQrCodeGeneratorCreateBodyStyle handling case conversions
     and file omissions as dictated by the API
     """
 

magic_hour/types/params/v1_ai_talking_photo_create_body.py

@@ -0,0 +1,68 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_talking_photo_create_body_assets import (
+    V1AiTalkingPhotoCreateBodyAssets,
+    _SerializerV1AiTalkingPhotoCreateBodyAssets,
+)
+from .v1_ai_talking_photo_create_body_style import (
+    V1AiTalkingPhotoCreateBodyStyle,
+    _SerializerV1AiTalkingPhotoCreateBodyStyle,
+)
+
+
+class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    assets: typing_extensions.Required[V1AiTalkingPhotoCreateBodyAssets]
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    end_seconds: typing_extensions.Required[float]
+    """
+    The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of image. This value is mainly used for your own identification of the image.
+    """
+
+    start_seconds: typing_extensions.Required[float]
+    """
+    The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+    """
+
+    style: typing_extensions.NotRequired[V1AiTalkingPhotoCreateBodyStyle]
+    """
+    Attributes used to dictate the style of the output
+    """
+
+
+class _SerializerV1AiTalkingPhotoCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiTalkingPhotoCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1AiTalkingPhotoCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    end_seconds: float = pydantic.Field(
+        alias="end_seconds",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    start_seconds: float = pydantic.Field(
+        alias="start_seconds",
+    )
+    style: typing.Optional[_SerializerV1AiTalkingPhotoCreateBodyStyle] = pydantic.Field(
+        alias="style", default=None
+    )

magic_hour/types/params/v1_ai_talking_photo_create_body_assets.py

@@ -0,0 +1,46 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiTalkingPhotoCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio file to sync with the image. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The source image to animate. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
+    """
+
+
+class _SerializerV1AiTalkingPhotoCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiTalkingPhotoCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: str = pydantic.Field(
+        alias="audio_file_path",
+    )
+    image_file_path: str = pydantic.Field(
+        alias="image_file_path",
+    )

magic_hour/types/params/v1_ai_talking_photo_create_body_style.py

@@ -0,0 +1,44 @@
+import pydantic
+import typing
+import typing_extensions
+
+
+class V1AiTalkingPhotoCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    Attributes used to dictate the style of the output
+    """
+
+    generation_mode: typing_extensions.NotRequired[
+        typing_extensions.Literal["expressive", "pro", "stable", "standard"]
+    ]
+    """
+    Controls overall motion style.
+    * `pro` -  Higher fidelity, realistic detail, accurate lip sync, and faster generation.
+    * `standard` -  More expressive motion, but lower visual fidelity.
+    
+    * `expressive` - More motion and facial expressiveness; may introduce visual artifacts. (Deprecated: passing this value will be treated as `standard`)
+    * `stable` -  Reduced motion for cleaner output; may result in minimal animation. (Deprecated: passing this value will be treated as `pro`)
+    """
+
+    intensity: typing_extensions.NotRequired[float]
+    """
+    Note: this value is only applicable when generation_mode is `expressive`. The value can include up to 2 decimal places.
+    * Lower values yield more stability but can suppress mouth movement.
+    * Higher values increase motion and expressiveness, with a higher risk of distortion.
+    """
+
+
+class _SerializerV1AiTalkingPhotoCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiTalkingPhotoCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    generation_mode: typing.Optional[
+        typing_extensions.Literal["expressive", "pro", "stable", "standard"]
+    ] = pydantic.Field(alias="generation_mode", default=None)
+    intensity: typing.Optional[float] = pydantic.Field(alias="intensity", default=None)

magic_hour/types/params/v1_ai_talking_photo_generate_body_assets.py

@@ -0,0 +1,26 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiTalkingPhotoGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio file to sync with the image. This value is either
+    - a direct URL to the video file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The source image to animate. This value is either
+    - a direct URL to the video file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_voice_cloner_create_body.py

@@ -0,0 +1,49 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_voice_cloner_create_body_assets import (
+    V1AiVoiceClonerCreateBodyAssets,
+    _SerializerV1AiVoiceClonerCreateBodyAssets,
+)
+from .v1_ai_voice_cloner_create_body_style import (
+    V1AiVoiceClonerCreateBodyStyle,
+    _SerializerV1AiVoiceClonerCreateBodyStyle,
+)
+
+
+class V1AiVoiceClonerCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiVoiceClonerCreateBody
+    """
+
+    assets: typing_extensions.Required[V1AiVoiceClonerCreateBodyAssets]
+    """
+    Provide the assets for voice cloning.
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of audio. This value is mainly used for your own identification of the audio.
+    """
+
+    style: typing_extensions.Required[V1AiVoiceClonerCreateBodyStyle]
+
+
+class _SerializerV1AiVoiceClonerCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1AiVoiceClonerCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerV1AiVoiceClonerCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour/types/params/v1_ai_voice_cloner_create_body_assets.py

@@ -0,0 +1,33 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceClonerCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for voice cloning.
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio used to clone the voice. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
+    """
+
+
+class _SerializerV1AiVoiceClonerCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: str = pydantic.Field(
+        alias="audio_file_path",
+    )

magic_hour/types/params/v1_ai_voice_cloner_create_body_style.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceClonerCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    V1AiVoiceClonerCreateBodyStyle
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    Text used to generate speech from the cloned voice. The character limit is 1000 characters.
+    """
+
+
+class _SerializerV1AiVoiceClonerCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    prompt: str = pydantic.Field(
+        alias="prompt",
+    )

magic_hour/types/params/v1_ai_voice_cloner_generate_body_assets.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceClonerGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for voice cloning.
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio used to clone the voice. This can be a local file path or URL.
+    """
+
+
+class _SerializerV1AiVoiceClonerGenerateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerGenerateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: str = pydantic.Field(
+        alias="audio_file_path",
+    )

magic_hour/types/params/v1_ai_voice_generator_create_body.py

@@ -0,0 +1,40 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_voice_generator_create_body_style import (
+    V1AiVoiceGeneratorCreateBodyStyle,
+    _SerializerV1AiVoiceGeneratorCreateBodyStyle,
+)
+
+
+class V1AiVoiceGeneratorCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiVoiceGeneratorCreateBody
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of audio. This value is mainly used for your own identification of the audio.
+    """
+
+    style: typing_extensions.Required[V1AiVoiceGeneratorCreateBodyStyle]
+    """
+    The content used to generate speech.
+    """
+
+
+class _SerializerV1AiVoiceGeneratorCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceGeneratorCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerV1AiVoiceGeneratorCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )