magic_hour 0.22.0__tar.gz → 0.23.0__tar.gz

{magic_hour-0.22.0 → magic_hour-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.22.0
+Version: 0.23.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -10,7 +10,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: httpx (>=0.26.0,<0.27.0)
+Requires-Dist: httpx (>=0.26.0,<1)
 Requires-Dist: jsonpointer (>=3.0.0,<4.0.0)
 Requires-Dist: pydantic (>=2.5.0,<3.0.0)
 Requires-Dist: typing_extensions (>=4.0.0,<5.0.0)

{magic_hour-0.22.0 → magic_hour-0.23.0}/magic_hour/environment.py

@@ -6,7 +6,7 @@ class Environment(enum.Enum):
     """Pre-defined base URLs for the API"""
 
     ENVIRONMENT = "https://api.magichour.ai"
-    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.22.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.23.0"
 
 
 def _get_base_url(

{magic_hour-0.22.0 → magic_hour-0.23.0}/magic_hour/resources/v1/ai_talking_photo/client.py

@@ -24,6 +24,9 @@ class AiTalkingPhotoClient:
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1AiTalkingPhotoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> models.V1AiTalkingPhotoCreateResponse:
         """
@@ -35,9 +38,10 @@ class AiTalkingPhotoClient:
 
         Args:
             name: The name of image
+            style: Attributes used to dictate the style of the output
             assets: Provide the assets for creating a talking photo
-            end_seconds: The end time of the input video in seconds
-            start_seconds: The start time of the input video in seconds
+            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -63,6 +67,7 @@ class AiTalkingPhotoClient:
         _json = to_encodable(
             item={
                 "name": name,
+                "style": style,
                 "assets": assets,
                 "end_seconds": end_seconds,
                 "start_seconds": start_seconds,
@@ -92,6 +97,9 @@ class AsyncAiTalkingPhotoClient:
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1AiTalkingPhotoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> models.V1AiTalkingPhotoCreateResponse:
         """
@@ -103,9 +111,10 @@ class AsyncAiTalkingPhotoClient:
 
         Args:
             name: The name of image
+            style: Attributes used to dictate the style of the output
             assets: Provide the assets for creating a talking photo
-            end_seconds: The end time of the input video in seconds
-            start_seconds: The start time of the input video in seconds
+            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -131,6 +140,7 @@ class AsyncAiTalkingPhotoClient:
         _json = to_encodable(
             item={
                 "name": name,
+                "style": style,
                 "assets": assets,
                 "end_seconds": end_seconds,
                 "start_seconds": start_seconds,

{magic_hour-0.22.0 → magic_hour-0.23.0}/magic_hour/types/params/__init__.py

@@ -94,6 +94,10 @@ from .v1_ai_talking_photo_create_body_assets import (
     V1AiTalkingPhotoCreateBodyAssets,
     _SerializerV1AiTalkingPhotoCreateBodyAssets,
 )
+from .v1_ai_talking_photo_create_body_style import (
+    V1AiTalkingPhotoCreateBodyStyle,
+    _SerializerV1AiTalkingPhotoCreateBodyStyle,
+)
 from .v1_animation_create_body import (
     V1AnimationCreateBody,
     _SerializerV1AnimationCreateBody,
@@ -210,6 +214,7 @@ __all__ = [
     "V1AiQrCodeGeneratorCreateBodyStyle",
     "V1AiTalkingPhotoCreateBody",
     "V1AiTalkingPhotoCreateBodyAssets",
+    "V1AiTalkingPhotoCreateBodyStyle",
     "V1AnimationCreateBody",
     "V1AnimationCreateBodyAssets",
     "V1AnimationCreateBodyStyle",
@@ -257,6 +262,7 @@ __all__ = [
     "_SerializerV1AiQrCodeGeneratorCreateBodyStyle",
     "_SerializerV1AiTalkingPhotoCreateBody",
     "_SerializerV1AiTalkingPhotoCreateBodyAssets",
+    "_SerializerV1AiTalkingPhotoCreateBodyStyle",
     "_SerializerV1AnimationCreateBody",
     "_SerializerV1AnimationCreateBodyAssets",
     "_SerializerV1AnimationCreateBodyStyle",

{magic_hour-0.22.0 → magic_hour-0.23.0}/magic_hour/types/params/v1_ai_talking_photo_create_body.py

@@ -6,6 +6,10 @@ 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):
@@ -20,7 +24,7 @@ class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
 
     end_seconds: typing_extensions.Required[float]
     """
-    The end time of the input video in seconds
+    The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
     """
 
     name: typing_extensions.NotRequired[str]
@@ -30,7 +34,12 @@ class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
 
     start_seconds: typing_extensions.Required[float]
     """
-    The start time of the input video in seconds
+    The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+    """
+
+    style: typing_extensions.NotRequired[V1AiTalkingPhotoCreateBodyStyle]
+    """
+    Attributes used to dictate the style of the output
     """
 
 
@@ -54,3 +63,6 @@ class _SerializerV1AiTalkingPhotoCreateBody(pydantic.BaseModel):
     start_seconds: float = pydantic.Field(
         alias="start_seconds",
     )
+    style: typing.Optional[_SerializerV1AiTalkingPhotoCreateBodyStyle] = pydantic.Field(
+        alias="style", default=None
+    )

magic_hour-0.23.0/magic_hour/types/params/v1_ai_talking_photo_create_body_style.py

@@ -0,0 +1,41 @@
+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", "stable"]
+    ]
+    """
+    Controls overall motion style.
+    * `expressive` - More motion and facial expressiveness; may introduce visual artifacts.
+    * `stable` -  Reduced motion for cleaner output; may result in minimal animation.
+    """
+
+    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", "stable"]
+    ] = pydantic.Field(alias="generation_mode", default=None)
+    intensity: typing.Optional[float] = pydantic.Field(alias="intensity", default=None)

{magic_hour-0.22.0 → magic_hour-0.23.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "magic_hour"
-version = "0.22.0"
+version = "0.23.0"
 description = "Python SDK for Magic Hour API"
 readme = "README.md"
 authors = []
@@ -8,7 +8,7 @@ packages = [{ include = "magic_hour" }]
 
 [tool.poetry.dependencies]
 python = "^3.8"
-httpx = "^0.26.0"
+httpx = ">=0.26.0, <1"
 pydantic = "^2.5.0"
 typing_extensions = "^4.0.0"
 jsonpointer = "^3.0.0"