magic_hour 0.11.0__tar.gz → 0.12.1__tar.gz

{magic_hour-0.11.0 → magic_hour-0.12.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.11.0
+Version: 0.12.1
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -83,6 +83,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/ai_qr_code_generator/README.md#create) - AI QR Code
 
+### [v1.ai_talking_photo](magic_hour/resources/v1/ai_talking_photo/README.md)
+
+* [create](magic_hour/resources/v1/ai_talking_photo/README.md#create) - AI Talking Photo
+
 ### [v1.animation](magic_hour/resources/v1/animation/README.md)
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation

{magic_hour-0.11.0 → magic_hour-0.12.1}/README.md

@@ -65,6 +65,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/ai_qr_code_generator/README.md#create) - AI QR Code
 
+### [v1.ai_talking_photo](magic_hour/resources/v1/ai_talking_photo/README.md)
+
+* [create](magic_hour/resources/v1/ai_talking_photo/README.md#create) - AI Talking Photo
+
 ### [v1.animation](magic_hour/resources/v1/animation/README.md)
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation

{magic_hour-0.11.0 → magic_hour-0.12.1}/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.11.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.12.1"

magic_hour-0.12.1/magic_hour/resources/v1/ai_talking_photo/README.md

@@ -0,0 +1,43 @@
+
+### create <a name="create"></a>
+AI Talking Photo
+
+Create a talking photo from an image and audio or text input.
+
+**API Endpoint**: `POST /v1/ai-talking-photo`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.ai_talking_photo.create(
+    assets={
+        "audio_file_path": "api-assets/id/1234.mp3",
+        "image_file_path": "api-assets/id/1234.png",
+    },
+    end_seconds=15.0,
+    start_seconds=0.0,
+    name="Talking Photo image",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.ai_talking_photo.create(
+    assets={
+        "audio_file_path": "api-assets/id/1234.mp3",
+        "image_file_path": "api-assets/id/1234.png",
+    },
+    end_seconds=15.0,
+    start_seconds=0.0,
+    name="Talking Photo image",
+)
+```

magic_hour-0.12.1/magic_hour/resources/v1/ai_talking_photo/__init__.py

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

magic_hour-0.12.1/magic_hour/resources/v1/ai_talking_photo/client.py

@@ -0,0 +1,147 @@
+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 AiTalkingPhotoClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.V1AiTalkingPhotoCreateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiTalkingPhotoCreateResponse:
+        """
+        AI Talking Photo
+
+        Create a talking photo from an image and audio or text input.
+
+        POST /v1/ai-talking-photo
+
+        Args:
+            name: The name of image
+            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
+            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_talking_photo.create(
+            assets={
+                "audio_file_path": "api-assets/id/1234.mp3",
+                "image_file_path": "api-assets/id/1234.png",
+            },
+            end_seconds=15.0,
+            start_seconds=0.0,
+            name="Talking Photo image",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "start_seconds": start_seconds,
+            },
+            dump_with=params._SerializerV1AiTalkingPhotoCreateBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/ai-talking-photo",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiTalkingPhotoCreateResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAiTalkingPhotoClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.V1AiTalkingPhotoCreateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiTalkingPhotoCreateResponse:
+        """
+        AI Talking Photo
+
+        Create a talking photo from an image and audio or text input.
+
+        POST /v1/ai-talking-photo
+
+        Args:
+            name: The name of image
+            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
+            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_talking_photo.create(
+            assets={
+                "audio_file_path": "api-assets/id/1234.mp3",
+                "image_file_path": "api-assets/id/1234.png",
+            },
+            end_seconds=15.0,
+            start_seconds=0.0,
+            name="Talking Photo image",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "start_seconds": start_seconds,
+            },
+            dump_with=params._SerializerV1AiTalkingPhotoCreateBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/ai-talking-photo",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiTalkingPhotoCreateResponse,
+            request_options=request_options or default_request_options(),
+        )

{magic_hour-0.11.0 → magic_hour-0.12.1}/magic_hour/resources/v1/client.py

@@ -23,6 +23,10 @@ from magic_hour.resources.v1.ai_qr_code_generator import (
     AiQrCodeGeneratorClient,
     AsyncAiQrCodeGeneratorClient,
 )
+from magic_hour.resources.v1.ai_talking_photo import (
+    AiTalkingPhotoClient,
+    AsyncAiTalkingPhotoClient,
+)
 from magic_hour.resources.v1.animation import AnimationClient, AsyncAnimationClient
 from magic_hour.resources.v1.face_swap import AsyncFaceSwapClient, FaceSwapClient
 from magic_hour.resources.v1.face_swap_photo import (
@@ -72,6 +76,7 @@ class V1Client:
         self.ai_qr_code_generator = AiQrCodeGeneratorClient(
             base_client=self._base_client
         )
+        self.ai_talking_photo = AiTalkingPhotoClient(base_client=self._base_client)
         self.animation = AnimationClient(base_client=self._base_client)
         self.face_swap = FaceSwapClient(base_client=self._base_client)
         self.face_swap_photo = FaceSwapPhotoClient(base_client=self._base_client)
@@ -106,6 +111,7 @@ class AsyncV1Client:
         self.ai_qr_code_generator = AsyncAiQrCodeGeneratorClient(
             base_client=self._base_client
         )
+        self.ai_talking_photo = AsyncAiTalkingPhotoClient(base_client=self._base_client)
         self.animation = AsyncAnimationClient(base_client=self._base_client)
         self.face_swap = AsyncFaceSwapClient(base_client=self._base_client)
         self.face_swap_photo = AsyncFaceSwapPhotoClient(base_client=self._base_client)

{magic_hour-0.11.0 → magic_hour-0.12.1}/magic_hour/types/models/__init__.py

@@ -6,6 +6,7 @@ from .v1_ai_image_generator_create_response import V1AiImageGeneratorCreateRespo
 from .v1_ai_image_upscaler_create_response import V1AiImageUpscalerCreateResponse
 from .v1_ai_photo_editor_create_response import V1AiPhotoEditorCreateResponse
 from .v1_ai_qr_code_generator_create_response import V1AiQrCodeGeneratorCreateResponse
+from .v1_ai_talking_photo_create_response import V1AiTalkingPhotoCreateResponse
 from .v1_animation_create_response import V1AnimationCreateResponse
 from .v1_face_swap_create_response import V1FaceSwapCreateResponse
 from .v1_face_swap_photo_create_response import V1FaceSwapPhotoCreateResponse
@@ -40,6 +41,7 @@ __all__ = [
     "V1AiImageUpscalerCreateResponse",
     "V1AiPhotoEditorCreateResponse",
     "V1AiQrCodeGeneratorCreateResponse",
+    "V1AiTalkingPhotoCreateResponse",
     "V1AnimationCreateResponse",
     "V1FaceSwapCreateResponse",
     "V1FaceSwapPhotoCreateResponse",

magic_hour-0.12.1/magic_hour/types/models/v1_ai_talking_photo_create_response.py

@@ -0,0 +1,25 @@
+import pydantic
+
+
+class V1AiTalkingPhotoCreateResponse(pydantic.BaseModel):
+    """
+    Success
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    estimated_frame_cost: int = pydantic.Field(
+        alias="estimated_frame_cost",
+    )
+    """
+    Estimated cost of the video in terms of number of frames needed to render the video. Frames will be adjusted when the video completes
+    """
+    id: str = pydantic.Field(
+        alias="id",
+    )
+    """
+    Unique ID of the video. This value can be used in the [get video project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch additional details such as status
+    """

{magic_hour-0.11.0 → magic_hour-0.12.1}/magic_hour/types/models/v1_video_projects_get_response.py

@@ -59,7 +59,7 @@ class V1VideoProjectsGetResponse(pydantic.BaseModel):
         alias="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
+    The height of the final output video. A value of -1 indicates the height can be ignored.
     """
     id: str = pydantic.Field(
         alias="id",
@@ -109,5 +109,5 @@ class V1VideoProjectsGetResponse(pydantic.BaseModel):
         alias="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
+    The width of the final output video. A value of -1 indicates the width can be ignored.
     """

{magic_hour-0.11.0 → magic_hour-0.12.1}/magic_hour/types/params/__init__.py

@@ -58,6 +58,14 @@ from .v1_ai_qr_code_generator_create_body_style import (
     V1AiQrCodeGeneratorCreateBodyStyle,
     _SerializerV1AiQrCodeGeneratorCreateBodyStyle,
 )
+from .v1_ai_talking_photo_create_body import (
+    V1AiTalkingPhotoCreateBody,
+    _SerializerV1AiTalkingPhotoCreateBody,
+)
+from .v1_ai_talking_photo_create_body_assets import (
+    V1AiTalkingPhotoCreateBodyAssets,
+    _SerializerV1AiTalkingPhotoCreateBodyAssets,
+)
 from .v1_animation_create_body import (
     V1AnimationCreateBody,
     _SerializerV1AnimationCreateBody,
@@ -157,6 +165,8 @@ __all__ = [
     "V1AiPhotoEditorCreateBodyStyle",
     "V1AiQrCodeGeneratorCreateBody",
     "V1AiQrCodeGeneratorCreateBodyStyle",
+    "V1AiTalkingPhotoCreateBody",
+    "V1AiTalkingPhotoCreateBodyAssets",
     "V1AnimationCreateBody",
     "V1AnimationCreateBodyAssets",
     "V1AnimationCreateBodyStyle",
@@ -193,6 +203,8 @@ __all__ = [
     "_SerializerV1AiPhotoEditorCreateBodyStyle",
     "_SerializerV1AiQrCodeGeneratorCreateBody",
     "_SerializerV1AiQrCodeGeneratorCreateBodyStyle",
+    "_SerializerV1AiTalkingPhotoCreateBody",
+    "_SerializerV1AiTalkingPhotoCreateBodyAssets",
     "_SerializerV1AnimationCreateBody",
     "_SerializerV1AnimationCreateBodyAssets",
     "_SerializerV1AnimationCreateBodyStyle",

magic_hour-0.12.1/magic_hour/types/params/v1_ai_talking_photo_create_body.py

@@ -0,0 +1,56 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_talking_photo_create_body_assets import (
+    V1AiTalkingPhotoCreateBodyAssets,
+    _SerializerV1AiTalkingPhotoCreateBodyAssets,
+)
+
+
+class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    assets: typing_extensions.Required[V1AiTalkingPhotoCreateBodyAssets]
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    end_seconds: typing_extensions.Required[float]
+    """
+    The end time of the input video in seconds
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of image
+    """
+
+    start_seconds: typing_extensions.Required[float]
+    """
+    The start time of the input video in seconds
+    """
+
+
+class _SerializerV1AiTalkingPhotoCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiTalkingPhotoCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1AiTalkingPhotoCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    end_seconds: float = pydantic.Field(
+        alias="end_seconds",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    start_seconds: float = pydantic.Field(
+        alias="start_seconds",
+    )

magic_hour-0.12.1/magic_hour/types/params/v1_ai_talking_photo_create_body_assets.py

@@ -0,0 +1,36 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiTalkingPhotoCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio file to sync with the image. 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.
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The source image to animate. 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 _SerializerV1AiTalkingPhotoCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiTalkingPhotoCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: str = pydantic.Field(
+        alias="audio_file_path",
+    )
+    image_file_path: str = pydantic.Field(
+        alias="image_file_path",
+    )

{magic_hour-0.11.0 → magic_hour-0.12.1}/magic_hour/types/params/v1_video_to_video_create_body_style.py

@@ -20,6 +20,7 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
             "Black Spiderman",
             "Boba Fett",
             "Celestial Skin",
+            "Chinese Swordsmen",
             "Clay",
             "Comic",
             "Cyberpunk",
@@ -41,14 +42,17 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
             "Lego",
             "Link",
             "Marble",
+            "Mario",
             "Master Chief",
             "Mech",
             "Minecraft",
+            "Mystique",
             "Naruto",
             "Neon Dream",
             "Oil Painting",
             "On Fire",
             "Origami",
+            "Pixar",
             "Pixel",
             "Power Armor",
             "Power Ranger",
@@ -63,6 +67,7 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
             "Studio Ghibli",
             "Sub-Zero",
             "The Void",
+            "Tomb Raider",
             "Underwater",
             "Van Gogh",
             "Viking",
@@ -129,6 +134,7 @@ class _SerializerV1VideoToVideoCreateBodyStyle(pydantic.BaseModel):
         "Black Spiderman",
         "Boba Fett",
         "Celestial Skin",
+        "Chinese Swordsmen",
         "Clay",
         "Comic",
         "Cyberpunk",
@@ -150,14 +156,17 @@ class _SerializerV1VideoToVideoCreateBodyStyle(pydantic.BaseModel):
         "Lego",
         "Link",
         "Marble",
+        "Mario",
         "Master Chief",
         "Mech",
         "Minecraft",
+        "Mystique",
         "Naruto",
         "Neon Dream",
         "Oil Painting",
         "On Fire",
         "Origami",
+        "Pixar",
         "Pixel",
         "Power Armor",
         "Power Ranger",
@@ -172,6 +181,7 @@ class _SerializerV1VideoToVideoCreateBodyStyle(pydantic.BaseModel):
         "Studio Ghibli",
         "Sub-Zero",
         "The Void",
+        "Tomb Raider",
         "Underwater",
         "Van Gogh",
         "Viking",

{magic_hour-0.11.0 → magic_hour-0.12.1}/pyproject.toml

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