magic_hour 0.19.0__tar.gz → 0.21.0__tar.gz

{magic_hour-0.19.0 → magic_hour-0.21.0}/PKG-INFO

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

{magic_hour-0.19.0 → magic_hour-0.21.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.19.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.21.0"

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/resources/v1/ai_gif_generator/README.md

@@ -2,7 +2,7 @@
 ### create <a name="create"></a>
 AI GIFs
 
-Create an AI GIF. Each GIF costs 5 frames.
+Create an AI GIF. Each GIF costs 25 frames.
 
 **API Endpoint**: `POST /v1/ai-gif-generator`
 

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/resources/v1/ai_gif_generator/client.py

@@ -27,7 +27,7 @@ class AiGifGeneratorClient:
         """
         AI GIFs
 
-        Create an AI GIF. Each GIF costs 5 frames.
+        Create an AI GIF. Each GIF costs 25 frames.
 
         POST /v1/ai-gif-generator
 
@@ -80,7 +80,7 @@ class AsyncAiGifGeneratorClient:
         """
         AI GIFs
 
-        Create an AI GIF. Each GIF costs 5 frames.
+        Create an AI GIF. Each GIF costs 25 frames.
 
         POST /v1/ai-gif-generator
 

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/resources/v1/ai_photo_editor/README.md

@@ -25,6 +25,8 @@ res = client.v1.ai_photo_editor.create(
         "prompt": "A photo portrait of a person wearing a hat",
         "prompt_strength": 3.75,
         "steps": 4,
+        "upscale_factor": 2,
+        "upscale_fidelity": 0.5,
     },
     name="Photo Editor image",
 )
@@ -47,6 +49,8 @@ res = await client.v1.ai_photo_editor.create(
         "prompt": "A photo portrait of a person wearing a hat",
         "prompt_strength": 3.75,
         "steps": 4,
+        "upscale_factor": 2,
+        "upscale_fidelity": 0.5,
     },
     name="Photo Editor image",
 )

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/resources/v1/ai_photo_editor/client.py

@@ -65,6 +65,8 @@ class AiPhotoEditorClient:
                 "prompt": "A photo portrait of a person wearing a hat",
                 "prompt_strength": 3.75,
                 "steps": 4,
+                "upscale_factor": 2,
+                "upscale_fidelity": 0.5,
             },
             name="Photo Editor image",
         )
@@ -144,6 +146,8 @@ class AsyncAiPhotoEditorClient:
                 "prompt": "A photo portrait of a person wearing a hat",
                 "prompt_strength": 3.75,
                 "steps": 4,
+                "upscale_factor": 2,
+                "upscale_fidelity": 0.5,
             },
             name="Photo Editor image",
         )

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/resources/v1/video_to_video/client.py

@@ -21,17 +21,21 @@ class VideoToVideoClient:
         *,
         assets: params.V1VideoToVideoCreateBodyAssets,
         end_seconds: float,
-        height: int,
         start_seconds: float,
         style: params.V1VideoToVideoCreateBodyStyle,
-        width: int,
         fps_resolution: typing.Union[
             typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
             type_utils.NotGiven,
         ] = type_utils.NOT_GIVEN,
+        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.V1VideoToVideoCreateResponse:
         """
@@ -48,13 +52,27 @@ class VideoToVideoClient:
             fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
         * `FULL` - the result video will have the same FPS as the input video
         * `HALF` - the result video will have half the FPS as the input video
+            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 video-to-video. 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. Must be divisible by 64. 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
             style: V1VideoToVideoCreateBodyStyle
-            width: The width of the final output video. Must be divisible by 64. 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:
@@ -72,7 +90,6 @@ class VideoToVideoClient:
                 "video_source": "file",
             },
             end_seconds=15.0,
-            height=960,
             start_seconds=0.0,
             style={
                 "art_style": "3D Render",
@@ -81,22 +98,23 @@ class VideoToVideoClient:
                 "prompt_type": "append_default",
                 "version": "default",
             },
-            width=512,
             fps_resolution="HALF",
+            height=960,
             name="Video To Video video",
+            width=512,
         )
         ```
         """
         _json = to_encodable(
             item={
                 "fps_resolution": fps_resolution,
+                "height": height,
                 "name": name,
+                "width": width,
                 "assets": assets,
                 "end_seconds": end_seconds,
-                "height": height,
                 "start_seconds": start_seconds,
                 "style": style,
-                "width": width,
             },
             dump_with=params._SerializerV1VideoToVideoCreateBody,
         )
@@ -119,17 +137,21 @@ class AsyncVideoToVideoClient:
         *,
         assets: params.V1VideoToVideoCreateBodyAssets,
         end_seconds: float,
-        height: int,
         start_seconds: float,
         style: params.V1VideoToVideoCreateBodyStyle,
-        width: int,
         fps_resolution: typing.Union[
             typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
             type_utils.NotGiven,
         ] = type_utils.NOT_GIVEN,
+        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.V1VideoToVideoCreateResponse:
         """
@@ -146,13 +168,27 @@ class AsyncVideoToVideoClient:
             fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
         * `FULL` - the result video will have the same FPS as the input video
         * `HALF` - the result video will have half the FPS as the input video
+            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 video-to-video. 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. Must be divisible by 64. 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
             style: V1VideoToVideoCreateBodyStyle
-            width: The width of the final output video. Must be divisible by 64. 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:
@@ -170,7 +206,6 @@ class AsyncVideoToVideoClient:
                 "video_source": "file",
             },
             end_seconds=15.0,
-            height=960,
             start_seconds=0.0,
             style={
                 "art_style": "3D Render",
@@ -179,22 +214,23 @@ class AsyncVideoToVideoClient:
                 "prompt_type": "append_default",
                 "version": "default",
             },
-            width=512,
             fps_resolution="HALF",
+            height=960,
             name="Video To Video video",
+            width=512,
         )
         ```
         """
         _json = to_encodable(
             item={
                 "fps_resolution": fps_resolution,
+                "height": height,
                 "name": name,
+                "width": width,
                 "assets": assets,
                 "end_seconds": end_seconds,
-                "height": height,
                 "start_seconds": start_seconds,
                 "style": style,
-                "width": width,
             },
             dump_with=params._SerializerV1VideoToVideoCreateBody,
         )

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/types/params/v1_ai_photo_editor_create_body_style.py

@@ -38,6 +38,16 @@ class V1AiPhotoEditorCreateBodyStyle(typing_extensions.TypedDict):
     Number of iterations used to generate the output. Higher values improve quality and increase the strength of the prompt but increase processing time.
     """
 
+    upscale_factor: typing_extensions.NotRequired[int]
+    """
+    The multiplier applied to an image's original dimensions during the upscaling process. For example, a scale of 2 doubles the width and height (e.g., from 512x512 to 1024x1024).
+    """
+
+    upscale_fidelity: typing_extensions.NotRequired[float]
+    """
+    Upscale fidelity refers to the level of quality desired in the generated image. Fidelity value of 1 means more details.
+    """
+
 
 class _SerializerV1AiPhotoEditorCreateBodyStyle(pydantic.BaseModel):
     """
@@ -65,3 +75,9 @@ class _SerializerV1AiPhotoEditorCreateBodyStyle(pydantic.BaseModel):
         alias="prompt_strength",
     )
     steps: typing.Optional[int] = pydantic.Field(alias="steps", default=None)
+    upscale_factor: typing.Optional[int] = pydantic.Field(
+        alias="upscale_factor", default=None
+    )
+    upscale_fidelity: typing.Optional[float] = pydantic.Field(
+        alias="upscale_fidelity", default=None
+    )

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/types/params/v1_video_to_video_create_body.py

@@ -36,9 +36,16 @@ class V1VideoToVideoCreateBody(typing_extensions.TypedDict):
     * `HALF` - the result video will have half the FPS as the input video
     """
 
-    height: typing_extensions.Required[int]
+    height: typing_extensions.NotRequired[int]
     """
-    The height of the final output video. Must be divisible by 64. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
+    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]
@@ -53,9 +60,16 @@ class V1VideoToVideoCreateBody(typing_extensions.TypedDict):
 
     style: typing_extensions.Required[V1VideoToVideoCreateBodyStyle]
 
-    width: typing_extensions.Required[int]
+    width: typing_extensions.NotRequired[int]
     """
-    The width of the final output video. Must be divisible by 64. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
+    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.
     """
 
 
@@ -78,9 +92,7 @@ class _SerializerV1VideoToVideoCreateBody(pydantic.BaseModel):
     fps_resolution: typing.Optional[typing_extensions.Literal["FULL", "HALF"]] = (
         pydantic.Field(alias="fps_resolution", default=None)
     )
-    height: int = pydantic.Field(
-        alias="height",
-    )
+    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",
@@ -88,6 +100,4 @@ class _SerializerV1VideoToVideoCreateBody(pydantic.BaseModel):
     style: _SerializerV1VideoToVideoCreateBodyStyle = pydantic.Field(
         alias="style",
     )
-    width: int = pydantic.Field(
-        alias="width",
-    )
+    width: typing.Optional[int] = pydantic.Field(alias="width", default=None)

{magic_hour-0.19.0 → magic_hour-0.21.0}/pyproject.toml

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

{magic_hour-0.19.0 → magic_hour-0.21.0}/magic_hour/resources/v1/video_to_video/README.md

@@ -19,7 +19,6 @@ client = Client(token=getenv("API_TOKEN"))
 res = client.v1.video_to_video.create(
     assets={"video_file_path": "api-assets/id/1234.mp4", "video_source": "file"},
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
     style={
         "art_style": "3D Render",
@@ -28,9 +27,10 @@ res = client.v1.video_to_video.create(
         "prompt_type": "append_default",
         "version": "default",
     },
-    width=512,
     fps_resolution="HALF",
+    height=960,
     name="Video To Video video",
+    width=512,
 )
 ```
 
@@ -44,7 +44,6 @@ client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.video_to_video.create(
     assets={"video_file_path": "api-assets/id/1234.mp4", "video_source": "file"},
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
     style={
         "art_style": "3D Render",
@@ -53,8 +52,9 @@ res = await client.v1.video_to_video.create(
         "prompt_type": "append_default",
         "version": "default",
     },
-    width=512,
     fps_resolution="HALF",
+    height=960,
     name="Video To Video video",
+    width=512,
 )
 ```