magic_hour 0.18.0__py3-none-any.whl → 0.20.0__py3-none-any.whl

magic_hour/core/__init__.py

@@ -18,6 +18,7 @@ from .request import (
     filter_not_given,
     to_content,
     to_encodable,
+    to_form_urlencoded,
     RequestOptions,
     default_request_options,
 )
@@ -42,6 +43,7 @@ __all__ = [
     "OAuth2ClientCredentialsForm",
     "OAuth2PasswordForm",
     "to_encodable",
+    "to_form_urlencoded",
     "filter_not_given",
     "to_content",
     "encode_query_param",

magic_hour/core/query.py

@@ -1,3 +1,5 @@
+import json
+
 from typing import Any, Dict, Union
 from typing_extensions import Literal, Sequence
 from urllib.parse import quote_plus, quote
@@ -9,13 +11,14 @@ import httpx
 QueryParams = Dict[
     str, Union[httpx._types.PrimitiveData, Sequence[httpx._types.PrimitiveData]]
 ]
+QueryParamStyle = Literal["form", "spaceDelimited", "pipeDelimited", "deepObject"]
 
 
 def encode_query_param(
     params: QueryParams,
     name: str,
     value: Any,
-    style: Literal["form", "spaceDelimited", "pipeDelimited", "deepObject"] = "form",
+    style: QueryParamStyle = "form",
     explode: bool = True,
 ):
     if style == "form":
@@ -30,6 +33,13 @@ def encode_query_param(
         raise NotImplementedError(f"query param style '{style}' not implemented")
 
 
+def _query_str(val: Any) -> str:
+    """jsonify value without wrapping quotes for strings"""
+    if isinstance(val, str):
+        return val
+    return json.dumps(val)
+
+
 def _encode_form(params: QueryParams, name: str, value: Any, explode: bool):
     """
     Encodes query params in the `form` style as defined by OpenAPI with both explode and non-explode
@@ -37,18 +47,18 @@ def _encode_form(params: QueryParams, name: str, value: Any, explode: bool):
     """
     if isinstance(value, list) and not explode:
         # non-explode form lists should be encoded like /users?id=3,4,5
-        params[name] = quote_plus(",".join(map(str, value)))
+        params[name] = quote_plus(",".join(map(_query_str, value)))
     elif isinstance(value, dict):
         if explode:
             # explode form objects should be encoded like /users?key0=val0&key1=val1
             # the input param name will be omitted
             for k, v in value.items():
-                params[k] = quote_plus(str(v))
+                params[k] = quote_plus(_query_str(v))
         else:
             # non-explode form objects should be encoded like /users?id=key0,val0,key1,val1
             encoded_chunks = []
             for k, v in value.items():
-                encoded_chunks.extend([str(k), str(v)])
+                encoded_chunks.extend([str(k), _query_str(v)])
             params[name] = quote_plus(",".join(encoded_chunks))
     else:
         params[name] = value
@@ -61,7 +71,7 @@ def _encode_spaced_delimited(params: QueryParams, name: str, value: Any, explode
     """
     if isinstance(value, list) and not explode:
         # non-explode spaceDelimited lists should be encoded like /users?id=3%204%205
-        params[name] = quote(" ".join(map(str, value)))
+        params[name] = quote(" ".join(map(_query_str, value)))
     else:
         # according to the docs, spaceDelimited + explode=false only effects lists,
         # all other encodings are marked as n/a or are the same as `form` style
@@ -76,7 +86,7 @@ def _encode_pipe_delimited(params: QueryParams, name: str, value: Any, explode:
     """
     if isinstance(value, list) and not explode:
         # non-explode pipeDelimited lists should be encoded like /users?id=3|4|5
-        params[name] = quote("|".join(map(str, value)))
+        params[name] = quote("|".join(map(_query_str, value)))
     else:
         # according to the docs, pipeDelimited + explode=false only effects lists,
         # all other encodings are marked as n/a or are the same as `form` style
@@ -85,12 +95,15 @@ def _encode_pipe_delimited(params: QueryParams, name: str, value: Any, explode:
 
 
 def _encode_deep_object(params: QueryParams, name: str, value: Any, explode: bool):
-    """ """
-    if isinstance(value, dict):
+    """
+    Encodes query params in the `deepObject` style as defined by with both explode and non-explode
+    variants.
+    """
+    if isinstance(value, (dict, list)):
         _encode_deep_object_key(params, name, value)
     else:
         # according to the docs, deepObject style only applies to
-        # object encodes, encodings for primitives & arrays are listed as n/a,
+        # object encodes, encodings for primitives are listed as n/a,
         # fall back on form style as it is the default for query params
         _encode_form(params, name, value, explode)
 
@@ -103,4 +116,4 @@ def _encode_deep_object_key(params: QueryParams, key: str, value: Any):
         for i, v in enumerate(value):
             _encode_deep_object_key(params, f"{key}[{i}]", v)
     else:
-        params[key] = value
+        params[key] = _query_str(value)

magic_hour/core/request.py

@@ -1,12 +1,11 @@
-from typing import Any, Dict, Type, Union, Sequence, List
-from urllib.parse import quote_plus
+from typing import Any, Dict, Type, Union, List, Mapping
 
 import httpx
 from typing_extensions import TypedDict, Required, NotRequired
 from pydantic import TypeAdapter, BaseModel
 
 from .type_utils import NotGiven
-from .query import QueryParams
+from .query import QueryParams, QueryParamStyle, encode_query_param
 
 """
 Request configuration and utility functions for handling HTTP requests.
@@ -96,6 +95,31 @@ def to_encodable(
     return model_dump(validated_item)
 
 
+def to_form_urlencoded(
+    *,
+    item: Any,
+    dump_with: Union[Type, Union[Type, Any]],
+    style: Mapping[str, QueryParamStyle],
+    explode: Mapping[str, bool],
+) -> Mapping[str, Any]:
+    """
+    Encodes object as x-www-form-urlencoded according to style and explode options
+    """
+    encoded = to_encodable(item=item, dump_with=dump_with)
+
+    if not isinstance(encoded, dict):
+        raise TypeError("x-www-form-urlencoded data must be an object at the top level")
+
+    form_data: QueryParams = {}
+
+    for key, val in encoded.items():
+        key_style = style.get(key, "form")
+        key_explode = explode.get(key, key_style == "form")
+        encode_query_param(form_data, key, val, style=key_style, explode=key_explode)
+
+    return form_data
+
+
 def to_content(*, file: httpx._types.FileTypes) -> httpx._types.RequestContent:
     """
     Converts the various ways files can be provided to something that is accepted by
@@ -112,24 +136,6 @@ def to_content(*, file: httpx._types.FileTypes) -> httpx._types.RequestContent:
         return file_content
 
 
-def encode_param(
-    value: Any, explode: bool
-) -> Union[httpx._types.PrimitiveData, Sequence[httpx._types.PrimitiveData]]:
-    """
-    Encodes parameter values for use in URLs.
-
-    Handles both simple values and collections, with special handling for
-    unexploded collections (combining them with commas) versus exploded ones.
-
-    Args:
-        explode: Whether to explode collections into separate parameters
-    """
-    if isinstance(value, (list, dict)) and not explode:
-        return quote_plus(",".join(map(str, value)))
-    else:
-        return value
-
-
 def filter_not_given(value: Any) -> Any:
     """Helper function to recursively filter out NotGiven values"""
     if isinstance(value, NotGiven):

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.18.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.20.0"

magic_hour/resources/v1/ai_gif_generator/README.md

@@ -0,0 +1,31 @@
+
+### create <a name="create"></a>
+AI GIFs
+
+Create an AI GIF. Each GIF costs 25 frames.
+
+**API Endpoint**: `POST /v1/ai-gif-generator`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.ai_gif_generator.create(
+    style={"prompt": "Cute dancing cat, pixel art"}, name="Ai Gif gif"
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.ai_gif_generator.create(
+    style={"prompt": "Cute dancing cat, pixel art"}, name="Ai Gif gif"
+)
+```

magic_hour/resources/v1/ai_gif_generator/__init__.py

@@ -0,0 +1,4 @@
+from .client import AiGifGeneratorClient, AsyncAiGifGeneratorClient
+
+
+__all__ = ["AiGifGeneratorClient", "AsyncAiGifGeneratorClient"]

magic_hour/resources/v1/ai_gif_generator/client.py

@@ -0,0 +1,117 @@
+import typing
+
+from magic_hour.core import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+    to_encodable,
+    type_utils,
+)
+from magic_hour.types import models, params
+
+
+class AiGifGeneratorClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        style: params.V1AiGifGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiGifGeneratorCreateResponse:
+        """
+        AI GIFs
+
+        Create an AI GIF. Each GIF costs 25 frames.
+
+        POST /v1/ai-gif-generator
+
+        Args:
+            name: The name of gif
+            style: V1AiGifGeneratorCreateBodyStyle
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        client.v1.ai_gif_generator.create(
+            style={"prompt": "Cute dancing cat, pixel art"}, name="Ai Gif gif"
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={"name": name, "style": style},
+            dump_with=params._SerializerV1AiGifGeneratorCreateBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/ai-gif-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiGifGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAiGifGeneratorClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        style: params.V1AiGifGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiGifGeneratorCreateResponse:
+        """
+        AI GIFs
+
+        Create an AI GIF. Each GIF costs 25 frames.
+
+        POST /v1/ai-gif-generator
+
+        Args:
+            name: The name of gif
+            style: V1AiGifGeneratorCreateBodyStyle
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        await client.v1.ai_gif_generator.create(
+            style={"prompt": "Cute dancing cat, pixel art"}, name="Ai Gif gif"
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={"name": name, "style": style},
+            dump_with=params._SerializerV1AiGifGeneratorCreateBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/ai-gif-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiGifGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/client.py

@@ -7,6 +7,10 @@ from magic_hour.resources.v1.ai_face_editor import (
     AiFaceEditorClient,
     AsyncAiFaceEditorClient,
 )
+from magic_hour.resources.v1.ai_gif_generator import (
+    AiGifGeneratorClient,
+    AsyncAiGifGeneratorClient,
+)
 from magic_hour.resources.v1.ai_headshot_generator import (
     AiHeadshotGeneratorClient,
     AsyncAiHeadshotGeneratorClient,
@@ -80,6 +84,7 @@ class V1Client:
         self.video_projects = VideoProjectsClient(base_client=self._base_client)
         self.ai_clothes_changer = AiClothesChangerClient(base_client=self._base_client)
         self.ai_face_editor = AiFaceEditorClient(base_client=self._base_client)
+        self.ai_gif_generator = AiGifGeneratorClient(base_client=self._base_client)
         self.ai_headshot_generator = AiHeadshotGeneratorClient(
             base_client=self._base_client
         )
@@ -114,6 +119,7 @@ class AsyncV1Client:
             base_client=self._base_client
         )
         self.ai_face_editor = AsyncAiFaceEditorClient(base_client=self._base_client)
+        self.ai_gif_generator = AsyncAiGifGeneratorClient(base_client=self._base_client)
         self.ai_headshot_generator = AsyncAiHeadshotGeneratorClient(
             base_client=self._base_client
         )

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,
 )
 ```

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/types/models/__init__.py

@@ -1,5 +1,6 @@
 from .v1_ai_clothes_changer_create_response import V1AiClothesChangerCreateResponse
 from .v1_ai_face_editor_create_response import V1AiFaceEditorCreateResponse
+from .v1_ai_gif_generator_create_response import V1AiGifGeneratorCreateResponse
 from .v1_ai_headshot_generator_create_response import (
     V1AiHeadshotGeneratorCreateResponse,
 )
@@ -40,6 +41,7 @@ from .v1_video_to_video_create_response import V1VideoToVideoCreateResponse
 __all__ = [
     "V1AiClothesChangerCreateResponse",
     "V1AiFaceEditorCreateResponse",
+    "V1AiGifGeneratorCreateResponse",
     "V1AiHeadshotGeneratorCreateResponse",
     "V1AiImageGeneratorCreateResponse",
     "V1AiImageUpscalerCreateResponse",

magic_hour/types/models/v1_ai_gif_generator_create_response.py

@@ -0,0 +1,25 @@
+import pydantic
+
+
+class V1AiGifGeneratorCreateResponse(pydantic.BaseModel):
+    """
+    Success
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    frame_cost: int = pydantic.Field(
+        alias="frame_cost",
+    )
+    """
+    The frame cost of the image generation
+    """
+    id: str = pydantic.Field(
+        alias="id",
+    )
+    """
+    Unique ID of the image. This value can be used in the [get image project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch additional details such as status
+    """

magic_hour/types/models/v1_image_projects_get_response.py

@@ -72,5 +72,5 @@ class V1ImageProjectsGetResponse(pydantic.BaseModel):
         alias="type",
     )
     """
-    The type of the image project. Possible values are AI_HEADSHOT, AI_IMAGE, IMAGE_UPSCALER, FACE_SWAP, PHOTO_EDITOR, QR_CODE, BACKGROUND_REMOVER, CLOTHES_CHANGER, AI_MEME, FACE_EDITOR, PHOTO_COLORIZER
+    The type of the image project. Possible values are AI_HEADSHOT, AI_IMAGE, IMAGE_UPSCALER, FACE_SWAP, PHOTO_EDITOR, QR_CODE, BACKGROUND_REMOVER, CLOTHES_CHANGER, AI_MEME, FACE_EDITOR, PHOTO_COLORIZER, AI_GIF
     """

magic_hour/types/params/__init__.py

@@ -18,6 +18,14 @@ from .v1_ai_face_editor_create_body_style import (
     V1AiFaceEditorCreateBodyStyle,
     _SerializerV1AiFaceEditorCreateBodyStyle,
 )
+from .v1_ai_gif_generator_create_body import (
+    V1AiGifGeneratorCreateBody,
+    _SerializerV1AiGifGeneratorCreateBody,
+)
+from .v1_ai_gif_generator_create_body_style import (
+    V1AiGifGeneratorCreateBodyStyle,
+    _SerializerV1AiGifGeneratorCreateBodyStyle,
+)
 from .v1_ai_headshot_generator_create_body import (
     V1AiHeadshotGeneratorCreateBody,
     _SerializerV1AiHeadshotGeneratorCreateBody,
@@ -183,6 +191,8 @@ __all__ = [
     "V1AiFaceEditorCreateBody",
     "V1AiFaceEditorCreateBodyAssets",
     "V1AiFaceEditorCreateBodyStyle",
+    "V1AiGifGeneratorCreateBody",
+    "V1AiGifGeneratorCreateBodyStyle",
     "V1AiHeadshotGeneratorCreateBody",
     "V1AiHeadshotGeneratorCreateBodyAssets",
     "V1AiHeadshotGeneratorCreateBodyStyle",
@@ -228,6 +238,8 @@ __all__ = [
     "_SerializerV1AiFaceEditorCreateBody",
     "_SerializerV1AiFaceEditorCreateBodyAssets",
     "_SerializerV1AiFaceEditorCreateBodyStyle",
+    "_SerializerV1AiGifGeneratorCreateBody",
+    "_SerializerV1AiGifGeneratorCreateBodyStyle",
     "_SerializerV1AiHeadshotGeneratorCreateBody",
     "_SerializerV1AiHeadshotGeneratorCreateBodyAssets",
     "_SerializerV1AiHeadshotGeneratorCreateBodyStyle",

magic_hour/types/params/v1_ai_gif_generator_create_body.py

@@ -0,0 +1,37 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_gif_generator_create_body_style import (
+    V1AiGifGeneratorCreateBodyStyle,
+    _SerializerV1AiGifGeneratorCreateBodyStyle,
+)
+
+
+class V1AiGifGeneratorCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiGifGeneratorCreateBody
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of gif
+    """
+
+    style: typing_extensions.Required[V1AiGifGeneratorCreateBodyStyle]
+
+
+class _SerializerV1AiGifGeneratorCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiGifGeneratorCreateBody 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: _SerializerV1AiGifGeneratorCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour/types/params/v1_ai_gif_generator_create_body_style.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiGifGeneratorCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    V1AiGifGeneratorCreateBodyStyle
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    The prompt used for the GIF.
+    """
+
+
+class _SerializerV1AiGifGeneratorCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiGifGeneratorCreateBodyStyle 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_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.18.0.dist-info → magic_hour-0.20.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.18.0
+Version: 0.20.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -67,6 +67,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/ai_face_editor/README.md#create) - AI Face Editor
 
+### [v1.ai_gif_generator](magic_hour/resources/v1/ai_gif_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_gif_generator/README.md#create) - AI GIFs
+
 ### [v1.ai_headshot_generator](magic_hour/resources/v1/ai_headshot_generator/README.md)
 
 * [create](magic_hour/resources/v1/ai_headshot_generator/README.md#create) - AI Headshots

{magic_hour-0.18.0.dist-info → magic_hour-0.20.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
 magic_hour/__init__.py,sha256=KIpC-OAJjT6m-WLHmdIdUlsYyicCiX4WHVIwfPG-e0c,203
 magic_hour/client.py,sha256=DMxeed7El-0q_URdGYXXNStGXJ11l7u6q1bQD8LWQ8g,2038
-magic_hour/core/__init__.py,sha256=s2y_QWfn976ilhDlvKGz-QWhAYcRDzvtAYnLbMMOTEA,1167
+magic_hour/core/__init__.py,sha256=YiyAhiYwhYzCN0Kk4jhca5HbxE-ot0fwXzHUL27HZu8,1217
 magic_hour/core/api_error.py,sha256=K1d47qRbhLBNEaUVbs0NPgxee24X3qGZ37gBhleUzEE,1760
 magic_hour/core/auth.py,sha256=NSjPcmTyHelRag9FqH1ufbchBWQgGDpH2P0akfppIPo,9130
 magic_hour/core/base_client.py,sha256=H9FJtNvN3ZfjjnPq4t9HXgh0c1324x1RFtAHXWEnqWk,18846
 magic_hour/core/binary_response.py,sha256=T-DATvb21P2ZRnYa4LlXmF77VfM8Tut2951QHEQct_U,681
-magic_hour/core/query.py,sha256=Z4NB5gSkJ8KMJU2vleHP_dx0NisP0v8S0em5XVlS_tE,4247
-magic_hour/core/request.py,sha256=lyHrh2VWY238D7JPbgZJlodTqBlHSmQn4fBJiBfE1Es,5069
+magic_hour/core/query.py,sha256=FdGdyHggFc8weFDSiUuVIEfZ7B2UAU0QOS38bp2ud9o,4627
+magic_hour/core/request.py,sha256=_ikn8iZ2fU9Ubqnt7M9hdEnXGV6AAFHJYmDKBtxEY4I,5263
 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=Qodwn0_lYoL2oFefrZzADTnkrEe6VnzOU_xKyEFeLKs,213
+magic_hour/environment.py,sha256=zppHUVUOt6Y2aej89SSPBfUZtdUSBmh2BLqAIEWj_9Q,213
 magic_hour/resources/v1/__init__.py,sha256=Aj0sjVcoijjQyieNBxv2_uewPYC2vO2UG-ehoBgCz5E,86
 magic_hour/resources/v1/ai_clothes_changer/README.md,sha256=KQTvbttct5GcdOJW3NG5gCsWF6G2qlwIoBjBd92TjUs,977
 magic_hour/resources/v1/ai_clothes_changer/__init__.py,sha256=6W_Y2HxG2sDOBiJyzngK3Q2S3xfQgpK-j8xFRmBAhbQ,142
@@ -18,6 +18,9 @@ magic_hour/resources/v1/ai_clothes_changer/client.py,sha256=gnhqocjO0GjoGM6dFOKk
 magic_hour/resources/v1/ai_face_editor/README.md,sha256=nhTRDxHPVqkd22FNZcZbtpEBqcV-t8-MavSqfuPh00w,1811
 magic_hour/resources/v1/ai_face_editor/__init__.py,sha256=RY8GBMQcqsDFbFcUuK-4LPvablq-U9XmSSlQk4HLKmM,126
 magic_hour/resources/v1/ai_face_editor/client.py,sha256=N5toTWe-Ag2iAhwk-CbWQxGnK6fZ2uHAFEKx15SPl-I,5315
+magic_hour/resources/v1/ai_gif_generator/README.md,sha256=jjNjYamGve_wv4NsD7ehn9lr3ztpqggViUoOhXNHb9k,651
+magic_hour/resources/v1/ai_gif_generator/__init__.py,sha256=SG_WmxUnpQWlfNQoHfdXPEGQEPC0WZPgom8ATaR9jiY,134
+magic_hour/resources/v1/ai_gif_generator/client.py,sha256=uIt2HfyTNtGqn-funDkcGV0lXZtWdMJKS7Jhv99phPo,3489
 magic_hour/resources/v1/ai_headshot_generator/README.md,sha256=CWihzwUuDVoLBItSDJKGBW1EQthz2REmkLkaaA68yao,705
 magic_hour/resources/v1/ai_headshot_generator/__init__.py,sha256=4WZ3jfrL2yPhQaPalMJrUEykwUoF3KBtop2VJEij-0s,154
 magic_hour/resources/v1/ai_headshot_generator/client.py,sha256=PoRzXFJCIyGA4PDOZyK6rQ1PHE6EUXSE7ilu_N9RTEc,4159
@@ -42,7 +45,7 @@ magic_hour/resources/v1/ai_talking_photo/client.py,sha256=TQNwMP3DhDj5jb51diMxcO
 magic_hour/resources/v1/animation/README.md,sha256=uIVfUwD7iAOe2eJDgrxj4UyYmq9R30fdI3Z0JuEChc4,1477
 magic_hour/resources/v1/animation/__init__.py,sha256=M6KUe6TEZl_DAdyn1HFQ2kHYanZo6xy3mvUdCN264hQ,114
 magic_hour/resources/v1/animation/client.py,sha256=YYjggl_hszTW-Sn9SFs3m7bz7PvtRTruhHSSnrkkD9c,6401
-magic_hour/resources/v1/client.py,sha256=x9DGi-0Fgqt85FgFWgD49NNFJzzSHtpJTcovT-WX4C4,6339
+magic_hour/resources/v1/client.py,sha256=kxrv1LfFHebey-tVjxlBN6c-9hSYMBqno9rVl54pUUg,6626
 magic_hour/resources/v1/face_swap/README.md,sha256=g5e_eZu3OsrIuc6ISpXbliIX1uVeYX7MwOfdw74dIoI,1306
 magic_hour/resources/v1/face_swap/__init__.py,sha256=lyg5uAHyYHEUVAiAZtP3zwjGCEGqq8IWbQKexVdhr00,110
 magic_hour/resources/v1/face_swap/client.py,sha256=-BpJae7J4PZPUG45BMA3HBB2XhrbHpgWqwwyaDFH88A,8519
@@ -75,12 +78,13 @@ magic_hour/resources/v1/text_to_video/client.py,sha256=HFFj6a9VaYEzEsa--5lI8HhsS
 magic_hour/resources/v1/video_projects/README.md,sha256=8z3EpBwXMR1nZL-ba34DAkoCfRZ0S2CyMaYCwLBYCEo,1589
 magic_hour/resources/v1/video_projects/__init__.py,sha256=1aj_tE-GAf8BuQ76RQvjGVn8Y39CjdAJDlcsCPucX0w,130
 magic_hour/resources/v1/video_projects/client.py,sha256=JvhYhf3phYkdVj8VpWxvxF8qWBRU-WaZYi-8lhVgpSQ,5511
-magic_hour/resources/v1/video_to_video/README.md,sha256=yOIRj1EPTVl8rl15SPWhpc2PZi1ddKGMix8WbaxlXzQ,1630
+magic_hour/resources/v1/video_to_video/README.md,sha256=--Z-JVvJ-412coXNU1F1a2Iq2IgR96QTbxQ31ryN8AE,1630
 magic_hour/resources/v1/video_to_video/__init__.py,sha256=1SHaRLlsrlBkdxxKBYgdbHrGATlRvqlXc22RpjjHaOA,126
-magic_hour/resources/v1/video_to_video/client.py,sha256=dYb2zi8MMhm1YUBFxGhFno4ikbMEjcLrs3JofapyP-s,8368
-magic_hour/types/models/__init__.py,sha256=9hopLSb427808uWcsoDeDskz3ZBF9akYYMorpKj2MaY,3305
+magic_hour/resources/v1/video_to_video/client.py,sha256=WFmYL3ZBLyKLDBOOOc9tJigtwviI6JLjbH7yJSsiIyM,10404
+magic_hour/types/models/__init__.py,sha256=Zv5G1HTpnPT94bSWyVhAxrijRGsInkXbBaifvaJxsr8,3423
 magic_hour/types/models/v1_ai_clothes_changer_create_response.py,sha256=gpPZLGvSukhBSK2LzTckn4HFcNDseP_XtfwasxzE2uc,625
 magic_hour/types/models/v1_ai_face_editor_create_response.py,sha256=mjeIlBOfcvHy9WrtOh0ZKFwrYZbA3gUY46fQ-fIGHuI,621
+magic_hour/types/models/v1_ai_gif_generator_create_response.py,sha256=vcEFAN1F9ef4aMzrZhoAMOOu5I-DJCAKqVtzjb84xW4,623
 magic_hour/types/models/v1_ai_headshot_generator_create_response.py,sha256=s4OheUpwh5jW1XAP4x_M7j-Xafq_gq9Lbz3NbUsFhs8,628
 magic_hour/types/models/v1_ai_image_generator_create_response.py,sha256=gqRQUTb1dznt9trj5i4vIc2GcPac910ti7EXzz49btc,625
 magic_hour/types/models/v1_ai_image_upscaler_create_response.py,sha256=u5z8WHJA7iT3u3EsTcDuAzwJ9JL9wMi0K93JhahjpGk,624
@@ -94,7 +98,7 @@ magic_hour/types/models/v1_face_swap_photo_create_response.py,sha256=d68oxwceXya
 magic_hour/types/models/v1_files_upload_urls_create_response.py,sha256=ecdnxoo-ZBTa2kAusHq4nyz6RdugzyN7w4oazJt5ri0,460
 magic_hour/types/models/v1_files_upload_urls_create_response_items_item.py,sha256=AjW1Myj-dB10IdM3zTMEsXouY3tnx8vdN5CW3HLQX_M,799
 magic_hour/types/models/v1_image_background_remover_create_response.py,sha256=jK_RVF3V0VSZn70FzsEjCrA_SEbpvcDdxy1RSlvsygw,631
-magic_hour/types/models/v1_image_projects_get_response.py,sha256=FEt7O6Z_C2pDzFnjkBciC2Cq6A9OfRsq-u8db4JTEqY,2141
+magic_hour/types/models/v1_image_projects_get_response.py,sha256=BC0YSrI07xumBXmv-kbUxhi9aabEjWFU4Oo7RDtGWfw,2149
 magic_hour/types/models/v1_image_projects_get_response_downloads_item.py,sha256=kC0UhiMug52kxN6Ib1H_u_JQGUbeRc91gjuVaXYaM-c,410
 magic_hour/types/models/v1_image_projects_get_response_error.py,sha256=R1qg-aIt63h6Q7bQ4AvgeC0lbUg5u35rwFXFvU_gvZs,568
 magic_hour/types/models/v1_image_to_video_create_response.py,sha256=9I3MptKUR2gdQW6SbGSZr5Usdte9PRSniq-pjwJySk4,736
@@ -106,12 +110,14 @@ 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=dRQql5qEQvcF0wbGO8M0yabgMef26w5T3JGtgnqLZ-Y,736
-magic_hour/types/params/__init__.py,sha256=7ZOYQNGmdT3vCKHSIM1Mi4NBVDcRyggTe0pcMtfngkQ,9805
+magic_hour/types/params/__init__.py,sha256=I8TdaEeRIiRwIkM8i8q4RlYWcYD8dGitWEGEDP9ryYs,10237
 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
 magic_hour/types/params/v1_ai_face_editor_create_body_assets.py,sha256=lhfVPTuAEFWATi5Su0weYlM_Npd5qEu75LexlJP5UZA,843
 magic_hour/types/params/v1_ai_face_editor_create_body_style.py,sha256=yNCL--4tDHR6eOltXh842YO0rcjBilJZxOXMcA6xaT4,3502
+magic_hour/types/params/v1_ai_gif_generator_create_body.py,sha256=7kl9B9cjDgnBTp7necRx7E6wbzhrVsZFuYWrr3sLYnU,919
+magic_hour/types/params/v1_ai_gif_generator_create_body_style.py,sha256=xefwoS15Iu9sbhc8oszcH8otTamk-ZTvSMuV1qvcYuQ,611
 magic_hour/types/params/v1_ai_headshot_generator_create_body.py,sha256=Ydzqxzfo6mMEIUc8R_PTWJujfnTDdzt7Ze4ZYiWxWJM,1405
 magic_hour/types/params/v1_ai_headshot_generator_create_body_assets.py,sha256=Zzb_CjU9PjGIugafxPIY59JiS1wABQRod29hPRm7xLc,908
 magic_hour/types/params/v1_ai_headshot_generator_create_body_style.py,sha256=DrX20IwvAhoO0ETO3aNn4YLpfQM5nbUNyz0pm8AO_38,670
@@ -149,10 +155,10 @@ magic_hour/types/params/v1_photo_colorizer_create_body.py,sha256=z6ARPEh1m3UL137
 magic_hour/types/params/v1_photo_colorizer_create_body_assets.py,sha256=fMC-R5V3gcd-S0LjxNViwtKiLvsxCwEFES31BLWYFp4,859
 magic_hour/types/params/v1_text_to_video_create_body.py,sha256=ax7CQZQ7keVjOWIsYFTQ9lb_PhhwvfMBXzHWX4x1nB8,1436
 magic_hour/types/params/v1_text_to_video_create_body_style.py,sha256=9NTboy7J4efsA8tVub2uOZpmgriiggfOyf5uAodBN3o,1065
-magic_hour/types/params/v1_video_to_video_create_body.py,sha256=iOb3qGXySlI4unyWPAXDmiLMUSHH6ymuDHeiwpmhKeE,2942
+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=2jgpJ3A8LNXksTPQ5pp1tWXtd753zBuhBjA22qqCsTE,5697
-magic_hour-0.18.0.dist-info/LICENSE,sha256=F3fxj7JXPgB2K0uj8YXRsVss4u-Dgt_-U3V4VXsivNI,1070
-magic_hour-0.18.0.dist-info/METADATA,sha256=VjdrNtXy4yjhjzxXWH2KeBQBX9ooWvvZURFQDfNzXNo,5323
-magic_hour-0.18.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-magic_hour-0.18.0.dist-info/RECORD,,
+magic_hour-0.20.0.dist-info/LICENSE,sha256=F3fxj7JXPgB2K0uj8YXRsVss4u-Dgt_-U3V4VXsivNI,1070
+magic_hour-0.20.0.dist-info/METADATA,sha256=zAN1JSubDBg-YepmgpXZIdck90lN02P4XV5pDNXADBU,5483
+magic_hour-0.20.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+magic_hour-0.20.0.dist-info/RECORD,,