magic_hour 0.14.0__tar.gz → 0.15.0__tar.gz

{magic_hour-0.14.0 → magic_hour-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.14.0
+Version: 0.15.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3

{magic_hour-0.14.0 → magic_hour-0.15.0}/magic_hour/environment.py

@@ -5,4 +5,4 @@ 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.14.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.15.0"

{magic_hour-0.14.0 → magic_hour-0.15.0}/magic_hour/resources/v1/face_swap/client.py

@@ -20,12 +20,16 @@ class FaceSwapClient:
         *,
         assets: params.V1FaceSwapCreateBodyAssets,
         end_seconds: float,
-        height: int,
         start_seconds: float,
-        width: int,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> models.V1FaceSwapCreateResponse:
         """
@@ -39,12 +43,26 @@ class FaceSwapClient:
         POST /v1/face-swap
 
         Args:
+            height: Used to determine the dimensions of the output video.
+
+        * If height is provided, width will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio.
+        * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.
+
+        Note: if the video's original resolution is less than the maximum, the video will not be resized.
+
+        See our [pricing page](https://magichour.ai/pricing) for more details.
             name: The name of video
+            width: Used to determine the dimensions of the output video.
+
+        * If width is provided, height will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio.
+        * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.
+
+        Note: if the video's original resolution is less than the maximum, the video will not be resized.
+
+        See our [pricing page](https://magichour.ai/pricing) for more details.
             assets: Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
             end_seconds: The end time of the input video in seconds
-            height: The height of the final output video. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
             start_seconds: The start time of the input video in seconds
-            width: The width of the final output video. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -63,21 +81,21 @@ class FaceSwapClient:
                 "video_source": "file",
             },
             end_seconds=15.0,
-            height=960,
             start_seconds=0.0,
-            width=512,
+            height=960,
             name="Face Swap video",
+            width=512,
         )
         ```
         """
         _json = to_encodable(
             item={
+                "height": height,
                 "name": name,
+                "width": width,
                 "assets": assets,
                 "end_seconds": end_seconds,
-                "height": height,
                 "start_seconds": start_seconds,
-                "width": width,
             },
             dump_with=params._SerializerV1FaceSwapCreateBody,
         )
@@ -100,12 +118,16 @@ class AsyncFaceSwapClient:
         *,
         assets: params.V1FaceSwapCreateBodyAssets,
         end_seconds: float,
-        height: int,
         start_seconds: float,
-        width: int,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> models.V1FaceSwapCreateResponse:
         """
@@ -119,12 +141,26 @@ class AsyncFaceSwapClient:
         POST /v1/face-swap
 
         Args:
+            height: Used to determine the dimensions of the output video.
+
+        * If height is provided, width will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio.
+        * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.
+
+        Note: if the video's original resolution is less than the maximum, the video will not be resized.
+
+        See our [pricing page](https://magichour.ai/pricing) for more details.
             name: The name of video
+            width: Used to determine the dimensions of the output video.
+
+        * If width is provided, height will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio.
+        * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.
+
+        Note: if the video's original resolution is less than the maximum, the video will not be resized.
+
+        See our [pricing page](https://magichour.ai/pricing) for more details.
             assets: Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
             end_seconds: The end time of the input video in seconds
-            height: The height of the final output video. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
             start_seconds: The start time of the input video in seconds
-            width: The width of the final output video. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -143,21 +179,21 @@ class AsyncFaceSwapClient:
                 "video_source": "file",
             },
             end_seconds=15.0,
-            height=960,
             start_seconds=0.0,
-            width=512,
+            height=960,
             name="Face Swap video",
+            width=512,
         )
         ```
         """
         _json = to_encodable(
             item={
+                "height": height,
                 "name": name,
+                "width": width,
                 "assets": assets,
                 "end_seconds": end_seconds,
-                "height": height,
                 "start_seconds": start_seconds,
-                "width": width,
             },
             dump_with=params._SerializerV1FaceSwapCreateBody,
         )

magic_hour-0.15.0/magic_hour/types/params/v1_face_swap_create_body.py

@@ -0,0 +1,82 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_face_swap_create_body_assets import (
+    V1FaceSwapCreateBodyAssets,
+    _SerializerV1FaceSwapCreateBodyAssets,
+)
+
+
+class V1FaceSwapCreateBody(typing_extensions.TypedDict):
+    """
+    V1FaceSwapCreateBody
+    """
+
+    assets: typing_extensions.Required[V1FaceSwapCreateBodyAssets]
+    """
+    Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
+    """
+
+    end_seconds: typing_extensions.Required[float]
+    """
+    The end time of the input video in seconds
+    """
+
+    height: typing_extensions.NotRequired[int]
+    """
+    Used to determine the dimensions of the output video. 
+      
+    * If height is provided, width will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio.
+    * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.
+    
+    Note: if the video's original resolution is less than the maximum, the video will not be resized.
+    
+    See our [pricing page](https://magichour.ai/pricing) for more details.
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of video
+    """
+
+    start_seconds: typing_extensions.Required[float]
+    """
+    The start time of the input video in seconds
+    """
+
+    width: typing_extensions.NotRequired[int]
+    """
+    Used to determine the dimensions of the output video. 
+      
+    * If width is provided, height will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio.
+    * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.
+    
+    Note: if the video's original resolution is less than the maximum, the video will not be resized.
+    
+    See our [pricing page](https://magichour.ai/pricing) for more details.
+    """
+
+
+class _SerializerV1FaceSwapCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1FaceSwapCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1FaceSwapCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    end_seconds: float = pydantic.Field(
+        alias="end_seconds",
+    )
+    height: typing.Optional[int] = pydantic.Field(alias="height", default=None)
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    start_seconds: float = pydantic.Field(
+        alias="start_seconds",
+    )
+    width: typing.Optional[int] = pydantic.Field(alias="width", default=None)

{magic_hour-0.14.0 → magic_hour-0.15.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "magic_hour"
-version = "0.14.0"
+version = "0.15.0"
 description = "Python SDK for Magic Hour API"
 readme = "README.md"
 authors = []

magic_hour-0.14.0/magic_hour/types/params/v1_face_swap_create_body.py

@@ -1,72 +0,0 @@
-import pydantic
-import typing
-import typing_extensions
-
-from .v1_face_swap_create_body_assets import (
-    V1FaceSwapCreateBodyAssets,
-    _SerializerV1FaceSwapCreateBodyAssets,
-)
-
-
-class V1FaceSwapCreateBody(typing_extensions.TypedDict):
-    """
-    V1FaceSwapCreateBody
-    """
-
-    assets: typing_extensions.Required[V1FaceSwapCreateBodyAssets]
-    """
-    Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
-    """
-
-    end_seconds: typing_extensions.Required[float]
-    """
-    The end time of the input video in seconds
-    """
-
-    height: typing_extensions.Required[int]
-    """
-    The height of the final output video. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
-    """
-
-    name: typing_extensions.NotRequired[str]
-    """
-    The name of video
-    """
-
-    start_seconds: typing_extensions.Required[float]
-    """
-    The start time of the input video in seconds
-    """
-
-    width: typing_extensions.Required[int]
-    """
-    The width of the final output video. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
-    """
-
-
-class _SerializerV1FaceSwapCreateBody(pydantic.BaseModel):
-    """
-    Serializer for V1FaceSwapCreateBody handling case conversions
-    and file omissions as dictated by the API
-    """
-
-    model_config = pydantic.ConfigDict(
-        populate_by_name=True,
-    )
-
-    assets: _SerializerV1FaceSwapCreateBodyAssets = pydantic.Field(
-        alias="assets",
-    )
-    end_seconds: float = pydantic.Field(
-        alias="end_seconds",
-    )
-    height: int = pydantic.Field(
-        alias="height",
-    )
-    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
-    start_seconds: float = pydantic.Field(
-        alias="start_seconds",
-    )
-    width: int = pydantic.Field(
-        alias="width",
-    )

{magic_hour-0.14.0 → magic_hour-0.15.0}/magic_hour/resources/v1/face_swap/README.md

@@ -23,10 +23,10 @@ res = client.v1.face_swap.create(
         "video_source": "file",
     },
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
-    width=512,
+    height=960,
     name="Face Swap video",
+    width=512,
 )
 ```
 
@@ -44,9 +44,9 @@ res = await client.v1.face_swap.create(
         "video_source": "file",
     },
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
-    width=512,
+    height=960,
     name="Face Swap video",
+    width=512,
 )
 ```