magic_hour 0.27.0__tar.gz → 0.29.0__tar.gz

{magic_hour-0.27.0 → magic_hour-0.29.0}/PKG-INFO

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

{magic_hour-0.27.0 → magic_hour-0.29.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.27.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.29.0"
 
 
 def _get_base_url(

{magic_hour-0.27.0 → magic_hour-0.29.0}/magic_hour/resources/v1/ai_talking_photo/README.md

@@ -10,8 +10,8 @@ Create a talking photo from an image and audio or text input.
 | Parameter | Required | Description | Example |
 |-----------|:--------:|-------------|--------|
 | `assets` | ✓ | Provide the assets for creating a talking photo | `{"audio_file_path": "api-assets/id/1234.mp3", "image_file_path": "api-assets/id/1234.png"}` |
-| `end_seconds` | ✓ | The end time of the input audio in seconds. The maximum duration allowed is 30 seconds. | `15.0` |
-| `start_seconds` | ✓ | The start time of the input audio in seconds. The maximum duration allowed is 30 seconds. | `0.0` |
+| `end_seconds` | ✓ | The end time of the input audio in seconds. The maximum duration allowed is 60 seconds. | `15.0` |
+| `start_seconds` | ✓ | The start time of the input audio in seconds. The maximum duration allowed is 60 seconds. | `0.0` |
 | `name` | ✗ | The name of image | `"Talking Photo image"` |
 | `style` | ✗ | Attributes used to dictate the style of the output | `{"generation_mode": "expressive", "intensity": 1.5}` |
 

{magic_hour-0.27.0 → magic_hour-0.29.0}/magic_hour/resources/v1/ai_talking_photo/client.py

@@ -40,8 +40,8 @@ class AiTalkingPhotoClient:
             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 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.
+            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -113,8 +113,8 @@ class AsyncAiTalkingPhotoClient:
             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 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.
+            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
             request_options: Additional options to customize the HTTP request
 
         Returns:

{magic_hour-0.27.0 → magic_hour-0.29.0}/magic_hour/resources/v1/face_swap_photo/README.md

@@ -9,7 +9,7 @@ Create a face swap photo. Each photo costs 5 credits. The height/width of the ou
 
 | Parameter | Required | Description | Example |
 |-----------|:--------:|-------------|--------|
-| `assets` | ✓ | Provide the assets for face swap photo | `{"source_file_path": "api-assets/id/1234.png", "target_file_path": "api-assets/id/1234.png"}` |
+| `assets` | ✓ | Provide the assets for face swap photo | `{"face_mappings": [{"new_face": "api-assets/id/1234.png", "original_face": "api-assets/id/0-0.png"}], "face_swap_mode": "all-faces", "source_file_path": "api-assets/id/1234.png", "target_file_path": "api-assets/id/1234.png"}` |
 | `name` | ✗ | The name of image | `"Face Swap image"` |
 
 #### Synchronous Client
@@ -21,6 +21,13 @@ from os import getenv
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.face_swap_photo.create(
     assets={
+        "face_mappings": [
+            {
+                "new_face": "api-assets/id/1234.png",
+                "original_face": "api-assets/id/0-0.png",
+            }
+        ],
+        "face_swap_mode": "all-faces",
         "source_file_path": "api-assets/id/1234.png",
         "target_file_path": "api-assets/id/1234.png",
     },
@@ -38,6 +45,13 @@ from os import getenv
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.face_swap_photo.create(
     assets={
+        "face_mappings": [
+            {
+                "new_face": "api-assets/id/1234.png",
+                "original_face": "api-assets/id/0-0.png",
+            }
+        ],
+        "face_swap_mode": "all-faces",
         "source_file_path": "api-assets/id/1234.png",
         "target_file_path": "api-assets/id/1234.png",
     },

{magic_hour-0.27.0 → magic_hour-0.29.0}/magic_hour/resources/v1/face_swap_photo/client.py

@@ -47,6 +47,13 @@ class FaceSwapPhotoClient:
         ```py
         client.v1.face_swap_photo.create(
             assets={
+                "face_mappings": [
+                    {
+                        "new_face": "api-assets/id/1234.png",
+                        "original_face": "api-assets/id/0-0.png",
+                    }
+                ],
+                "face_swap_mode": "all-faces",
                 "source_file_path": "api-assets/id/1234.png",
                 "target_file_path": "api-assets/id/1234.png",
             },
@@ -104,6 +111,13 @@ class AsyncFaceSwapPhotoClient:
         ```py
         await client.v1.face_swap_photo.create(
             assets={
+                "face_mappings": [
+                    {
+                        "new_face": "api-assets/id/1234.png",
+                        "original_face": "api-assets/id/0-0.png",
+                    }
+                ],
+                "face_swap_mode": "all-faces",
                 "source_file_path": "api-assets/id/1234.png",
                 "target_file_path": "api-assets/id/1234.png",
             },

{magic_hour-0.27.0 → magic_hour-0.29.0}/magic_hour/types/params/__init__.py

@@ -154,6 +154,10 @@ from .v1_face_swap_photo_create_body_assets import (
     V1FaceSwapPhotoCreateBodyAssets,
     _SerializerV1FaceSwapPhotoCreateBodyAssets,
 )
+from .v1_face_swap_photo_create_body_assets_face_mappings_item import (
+    V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem,
+    _SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem,
+)
 from .v1_files_upload_urls_create_body import (
     V1FilesUploadUrlsCreateBody,
     _SerializerV1FilesUploadUrlsCreateBody,
@@ -257,6 +261,7 @@ __all__ = [
     "V1FaceSwapCreateBodyAssets",
     "V1FaceSwapPhotoCreateBody",
     "V1FaceSwapPhotoCreateBodyAssets",
+    "V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem",
     "V1FilesUploadUrlsCreateBody",
     "V1FilesUploadUrlsCreateBodyItemsItem",
     "V1ImageBackgroundRemoverCreateBody",
@@ -312,6 +317,7 @@ __all__ = [
     "_SerializerV1FaceSwapCreateBodyAssets",
     "_SerializerV1FaceSwapPhotoCreateBody",
     "_SerializerV1FaceSwapPhotoCreateBodyAssets",
+    "_SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem",
     "_SerializerV1FilesUploadUrlsCreateBody",
     "_SerializerV1FilesUploadUrlsCreateBodyItemsItem",
     "_SerializerV1ImageBackgroundRemoverCreateBody",

{magic_hour-0.27.0 → magic_hour-0.29.0}/magic_hour/types/params/v1_ai_talking_photo_create_body.py

@@ -24,7 +24,7 @@ class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
 
     end_seconds: typing_extensions.Required[float]
     """
-    The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+    The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
     """
 
     name: typing_extensions.NotRequired[str]
@@ -34,7 +34,7 @@ class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
 
     start_seconds: typing_extensions.Required[float]
     """
-    The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+    The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
     """
 
     style: typing_extensions.NotRequired[V1AiTalkingPhotoCreateBodyStyle]

magic_hour-0.29.0/magic_hour/types/params/v1_face_swap_photo_create_body_assets.py

@@ -0,0 +1,66 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_face_swap_photo_create_body_assets_face_mappings_item import (
+    V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem,
+    _SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem,
+)
+
+
+class V1FaceSwapPhotoCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for face swap photo
+    """
+
+    face_mappings: typing_extensions.NotRequired[
+        typing.List[V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem]
+    ]
+    """
+    This is the array of face mappings used for multiple face swap. The value is required if `face_swap_mode` is `individual-faces`.
+    """
+
+    face_swap_mode: typing_extensions.NotRequired[
+        typing_extensions.Literal["all-faces", "individual-faces"]
+    ]
+    """
+    The mode of face swap.
+    * `all-faces` - Swap all faces in the target image. `source_file_path` is required.
+    * `individual-faces` - Swap individual faces in the target image. `source_faces` is required.
+    """
+
+    source_file_path: typing_extensions.NotRequired[str]
+    """
+    This is the image from which the face is extracted. The value is required if `face_swap_mode` is `all-faces`.
+    
+    This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    """
+
+    target_file_path: typing_extensions.Required[str]
+    """
+    This is the image where the face from the source image will be placed. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    """
+
+
+class _SerializerV1FaceSwapPhotoCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1FaceSwapPhotoCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    face_mappings: typing.Optional[
+        typing.List[_SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem]
+    ] = pydantic.Field(alias="face_mappings", default=None)
+    face_swap_mode: typing.Optional[
+        typing_extensions.Literal["all-faces", "individual-faces"]
+    ] = pydantic.Field(alias="face_swap_mode", default=None)
+    source_file_path: typing.Optional[str] = pydantic.Field(
+        alias="source_file_path", default=None
+    )
+    target_file_path: str = pydantic.Field(
+        alias="target_file_path",
+    )

magic_hour-0.29.0/magic_hour/types/params/v1_face_swap_photo_create_body_assets_face_mappings_item.py

@@ -0,0 +1,39 @@
+import pydantic
+import typing_extensions
+
+
+class V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem(typing_extensions.TypedDict):
+    """
+    V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem
+    """
+
+    new_face: typing_extensions.Required[str]
+    """
+    The face image that will be used to replace the face in the `original_face`. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    """
+
+    original_face: typing_extensions.Required[str]
+    """
+    The face detected from the image in `target_file_path`. The file name is in the format of `<face_frame>-<face_index>.png`. This value is corresponds to the response in the face detection API [COMING SOON].
+    
+    * The face_frame is the frame number of the face in the target image. For images, the frame number is always 0.
+    * The face_index is the index of the face in the target image, starting from 0 going left to right.
+    """
+
+
+class _SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem(pydantic.BaseModel):
+    """
+    Serializer for V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    new_face: str = pydantic.Field(
+        alias="new_face",
+    )
+    original_face: str = pydantic.Field(
+        alias="original_face",
+    )

{magic_hour-0.27.0 → magic_hour-0.29.0}/pyproject.toml

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

magic_hour-0.27.0/magic_hour/types/params/v1_face_swap_photo_create_body_assets.py

@@ -1,36 +0,0 @@
-import pydantic
-import typing_extensions
-
-
-class V1FaceSwapPhotoCreateBodyAssets(typing_extensions.TypedDict):
-    """
-    Provide the assets for face swap photo
-    """
-
-    source_file_path: typing_extensions.Required[str]
-    """
-    This is the image from which the face is extracted. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
-    """
-
-    target_file_path: typing_extensions.Required[str]
-    """
-    This is the image where the face from the source image will be placed. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
-    """
-
-
-class _SerializerV1FaceSwapPhotoCreateBodyAssets(pydantic.BaseModel):
-    """
-    Serializer for V1FaceSwapPhotoCreateBodyAssets handling case conversions
-    and file omissions as dictated by the API
-    """
-
-    model_config = pydantic.ConfigDict(
-        populate_by_name=True,
-    )
-
-    source_file_path: str = pydantic.Field(
-        alias="source_file_path",
-    )
-    target_file_path: str = pydantic.Field(
-        alias="target_file_path",
-    )