magic_hour 0.22.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

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/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/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/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/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.dist-info → magic_hour-0.23.0.dist-info}/METADATA

@@ -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.dist-info → magic_hour-0.23.0.dist-info}/RECORD

@@ -10,7 +10,7 @@ magic_hour/core/request.py,sha256=_ikn8iZ2fU9Ubqnt7M9hdEnXGV6AAFHJYmDKBtxEY4I,52
 magic_hour/core/response.py,sha256=Sl7nPL2axmz7em_6d9TkFSnQQKUpalWaVWbPPWoXJgM,10180
 magic_hour/core/type_utils.py,sha256=4bU9WXnMXJ6YTtuqOMiB8t6Xw0RlfVWJ-IDBONlqEtQ,461
 magic_hour/core/utils.py,sha256=34SiC1vw2A0TkYHONgMA_d09soIIYiiBWRXCZGdwGIk,1669
-magic_hour/environment.py,sha256=g0GH7PJoDf1UopPPNwPA6y2n3WeVAz8nLmwCykGAUHw,535
+magic_hour/environment.py,sha256=e9Vh0yGfeTIQJk7Dw_0XB8R54n0Dp611FTW7m9guGRU,535
 magic_hour/resources/v1/__init__.py,sha256=Aj0sjVcoijjQyieNBxv2_uewPYC2vO2UG-ehoBgCz5E,86
 magic_hour/resources/v1/ai_clothes_changer/README.md,sha256=Bf0C0DQu-5tW696Ft7H4NYC3592XeZjl1RSbR-hw2ss,971
 magic_hour/resources/v1/ai_clothes_changer/__init__.py,sha256=6W_Y2HxG2sDOBiJyzngK3Q2S3xfQgpK-j8xFRmBAhbQ,142
@@ -41,7 +41,7 @@ magic_hour/resources/v1/ai_qr_code_generator/__init__.py,sha256=HnSTg7tB8M5LibZo
 magic_hour/resources/v1/ai_qr_code_generator/client.py,sha256=mmdGgUSVoMTazmGiB24mc2sXsfaAtx-Fbgcu_SncW-Q,3851
 magic_hour/resources/v1/ai_talking_photo/README.md,sha256=3IskEBX7J4mQO1ndzv3v1LdtNJxxEyS9ogPYAWt5IIo,935
 magic_hour/resources/v1/ai_talking_photo/__init__.py,sha256=ZTDD_IRBoR7GSdGWCVEK2-LOEsKUdGEHZZvDHa9MOnA,134
-magic_hour/resources/v1/ai_talking_photo/client.py,sha256=TQNwMP3DhDj5jb51diMxcONDbdMPsIe_GSnNahZg8AM,4623
+magic_hour/resources/v1/ai_talking_photo/client.py,sha256=Y4p5HAlbCAe2NNqekdllSZ0jRhzwCcjAIHO0zlqxi3Q,5311
 magic_hour/resources/v1/animation/README.md,sha256=QQqzioZ8qnBlv6TiE2utyIxcpUnRheMz4vCJTROvdwM,1470
 magic_hour/resources/v1/animation/__init__.py,sha256=M6KUe6TEZl_DAdyn1HFQ2kHYanZo6xy3mvUdCN264hQ,114
 magic_hour/resources/v1/animation/client.py,sha256=YYjggl_hszTW-Sn9SFs3m7bz7PvtRTruhHSSnrkkD9c,6401
@@ -110,7 +110,7 @@ magic_hour/types/models/v1_video_projects_get_response_download.py,sha256=nudDCN
 magic_hour/types/models/v1_video_projects_get_response_downloads_item.py,sha256=DlUuLBSGa7jWoozxferkaOsGc4jASItcjjWbBXGu620,410
 magic_hour/types/models/v1_video_projects_get_response_error.py,sha256=49QxnXAmYHcvSWuuhbQZeGlUfqVcO4YwZ414GczQnvA,568
 magic_hour/types/models/v1_video_to_video_create_response.py,sha256=HCquU2Dciu6jCvhlpce8sGg1CypZngvtrvkwyCWOkSY,1346
-magic_hour/types/params/__init__.py,sha256=I8TdaEeRIiRwIkM8i8q4RlYWcYD8dGitWEGEDP9ryYs,10237
+magic_hour/types/params/__init__.py,sha256=GvRYw3XDWkHLT-lgbGlC-WzCzSn5U2XeFzRk9VuJaGY,10466
 magic_hour/types/params/v1_ai_clothes_changer_create_body.py,sha256=X5koqrTxYLiKcRMqPF7r-VwQzy4r_7k81o1289zHJvo,1006
 magic_hour/types/params/v1_ai_clothes_changer_create_body_assets.py,sha256=GGnXOExxXtnHT9wQpDCEkLHQlQB5MbAbYuU47iHGf70,1509
 magic_hour/types/params/v1_ai_face_editor_create_body.py,sha256=sF7mJbqratllYwQ3slqUTctOndAYnH9BDMJu-49Db-4,1313
@@ -133,8 +133,9 @@ magic_hour/types/params/v1_ai_photo_editor_create_body_assets.py,sha256=xoDh4VwV
 magic_hour/types/params/v1_ai_photo_editor_create_body_style.py,sha256=EGPcoSjCDffoTbY3QB-85HVJ97p9swcZkMsYdW_O2JE,2752
 magic_hour/types/params/v1_ai_qr_code_generator_create_body.py,sha256=_O1654Mbl77SGi9lH4FmKkTwtCXCArH9BeSlgTuLyT0,1109
 magic_hour/types/params/v1_ai_qr_code_generator_create_body_style.py,sha256=i3ldwmoQPEnrw654PNIARmpsX-kUHZqaT8wjcc22JoA,839
-magic_hour/types/params/v1_ai_talking_photo_create_body.py,sha256=YOIaCrhespIr0Ue6cOF4R2bg00BGZXQeJwP7RwhJhRI,1408
+magic_hour/types/params/v1_ai_talking_photo_create_body.py,sha256=D8zvwqOoNf8DlWa7EOkDNXHt2PqrGzup0uxXDYP5RCI,1915
 magic_hour/types/params/v1_ai_talking_photo_create_body_assets.py,sha256=_xNq6uVb6h7TYsNGesEbpAvrGKmVgqXwVV7Hq7jyEO4,1230
+magic_hour/types/params/v1_ai_talking_photo_create_body_style.py,sha256=iXKnUrYrKC-9sRxZlthUpiqHgSSyQe0UjYNhhKRKI1Q,1434
 magic_hour/types/params/v1_animation_create_body.py,sha256=QB0zxAhNDV8BEd6vuTAUoZaF2E0PNKwfzV7OrsdueGk,2221
 magic_hour/types/params/v1_animation_create_body_assets.py,sha256=Iot5sbRKLlXCHZS1X5tGICSRKOneBcqaDijYm5_BaUA,1965
 magic_hour/types/params/v1_animation_create_body_style.py,sha256=1ujex1BXQq70rp10Pxs8wkb6pkM7fP6fojTW5ATdXyo,8045
@@ -158,7 +159,7 @@ magic_hour/types/params/v1_text_to_video_create_body_style.py,sha256=9NTboy7J4ef
 magic_hour/types/params/v1_video_to_video_create_body.py,sha256=Pgok6GUVHrpW6H3rwdVFA3O5YJvjgviCZkmmHddOSWo,3802
 magic_hour/types/params/v1_video_to_video_create_body_assets.py,sha256=_-6iA5d8ndka6iJWyWvlJwzRkQcmurJE6hkg-fDwBmQ,1531
 magic_hour/types/params/v1_video_to_video_create_body_style.py,sha256=RrDBhN2KQnCf9hGsnl3sAYvuFRsxth2JXfe5la0IYJg,5749
-magic_hour-0.22.0.dist-info/LICENSE,sha256=F3fxj7JXPgB2K0uj8YXRsVss4u-Dgt_-U3V4VXsivNI,1070
-magic_hour-0.22.0.dist-info/METADATA,sha256=Z6s0unSY6ORWQMQB9jNM01ErVLuce9fWwYOnBvx0W4g,5483
-magic_hour-0.22.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-magic_hour-0.22.0.dist-info/RECORD,,
+magic_hour-0.23.0.dist-info/LICENSE,sha256=F3fxj7JXPgB2K0uj8YXRsVss4u-Dgt_-U3V4VXsivNI,1070
+magic_hour-0.23.0.dist-info/METADATA,sha256=W0vahZcyfUqxLtUDqSxjto2iy8wnmtZYRhTV_9pqpxQ,5478
+magic_hour-0.23.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+magic_hour-0.23.0.dist-info/RECORD,,