magic_hour 0.12.1__tar.gz → 0.13.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.12.1
+Version: 0.13.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -75,6 +75,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/ai_image_upscaler/README.md#create) - AI Image Upscaler
 
+### [v1.ai_meme_generator](magic_hour/resources/v1/ai_meme_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_meme_generator/README.md#create) - AI Meme Generator
+
 ### [v1.ai_photo_editor](magic_hour/resources/v1/ai_photo_editor/README.md)
 
 * [create](magic_hour/resources/v1/ai_photo_editor/README.md#create) - AI Photo Editor

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

@@ -57,6 +57,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/ai_image_upscaler/README.md#create) - AI Image Upscaler
 
+### [v1.ai_meme_generator](magic_hour/resources/v1/ai_meme_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_meme_generator/README.md#create) - AI Meme Generator
+
 ### [v1.ai_photo_editor](magic_hour/resources/v1/ai_photo_editor/README.md)
 
 * [create](magic_hour/resources/v1/ai_photo_editor/README.md#create) - AI Photo Editor

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

magic_hour-0.13.0/magic_hour/resources/v1/ai_meme_generator/README.md

@@ -0,0 +1,41 @@
+
+### create <a name="create"></a>
+AI Meme Generator
+
+Create an AI generated meme. Each meme costs 10 frames.
+
+**API Endpoint**: `POST /v1/ai-meme-generator`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.ai_meme_generator.create(
+    style={
+        "search_web": False,
+        "template": "Drake Hotline Bling",
+        "topic": "When the code finally works",
+    },
+    name="My Funny Meme",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.ai_meme_generator.create(
+    style={
+        "search_web": False,
+        "template": "Drake Hotline Bling",
+        "topic": "When the code finally works",
+    },
+    name="My Funny Meme",
+)
+```

magic_hour-0.13.0/magic_hour/resources/v1/ai_meme_generator/__init__.py

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

magic_hour-0.13.0/magic_hour/resources/v1/ai_meme_generator/client.py

@@ -0,0 +1,127 @@
+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 AiMemeGeneratorClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        style: params.V1AiMemeGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiMemeGeneratorCreateResponse:
+        """
+        AI Meme Generator
+
+        Create an AI generated meme. Each meme costs 10 frames.
+
+        POST /v1/ai-meme-generator
+
+        Args:
+            name: The name of the meme.
+            style: V1AiMemeGeneratorCreateBodyStyle
+            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_meme_generator.create(
+            style={
+                "search_web": False,
+                "template": "Drake Hotline Bling",
+                "topic": "When the code finally works",
+            },
+            name="My Funny Meme",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={"name": name, "style": style},
+            dump_with=params._SerializerV1AiMemeGeneratorCreateBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/ai-meme-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiMemeGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAiMemeGeneratorClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        style: params.V1AiMemeGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiMemeGeneratorCreateResponse:
+        """
+        AI Meme Generator
+
+        Create an AI generated meme. Each meme costs 10 frames.
+
+        POST /v1/ai-meme-generator
+
+        Args:
+            name: The name of the meme.
+            style: V1AiMemeGeneratorCreateBodyStyle
+            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_meme_generator.create(
+            style={
+                "search_web": False,
+                "template": "Drake Hotline Bling",
+                "topic": "When the code finally works",
+            },
+            name="My Funny Meme",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={"name": name, "style": style},
+            dump_with=params._SerializerV1AiMemeGeneratorCreateBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/ai-meme-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiMemeGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )

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

@@ -61,8 +61,10 @@ class AiPhotoEditorClient:
             style={
                 "image_description": "A photo of a person",
                 "likeness_strength": 5.2,
+                "negative_prompt": "painting, cartoon, sketch",
                 "prompt": "A photo portrait of a person wearing a hat",
                 "prompt_strength": 3.75,
+                "steps": 4,
             },
             name="Photo Editor image",
         )
@@ -138,8 +140,10 @@ class AsyncAiPhotoEditorClient:
             style={
                 "image_description": "A photo of a person",
                 "likeness_strength": 5.2,
+                "negative_prompt": "painting, cartoon, sketch",
                 "prompt": "A photo portrait of a person wearing a hat",
                 "prompt_strength": 3.75,
+                "steps": 4,
             },
             name="Photo Editor image",
         )

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

@@ -56,7 +56,11 @@ class AnimationClient:
         Examples:
         ```py
         client.v1.animation.create(
-            assets={"audio_source": "file"},
+            assets={
+                "audio_file_path": "api-assets/id/1234.mp3",
+                "audio_source": "file",
+                "image_file_path": "api-assets/id/1234.png",
+            },
             end_seconds=15.0,
             fps=12.0,
             height=960,
@@ -139,7 +143,11 @@ class AsyncAnimationClient:
         Examples:
         ```py
         await client.v1.animation.create(
-            assets={"audio_source": "file"},
+            assets={
+                "audio_file_path": "api-assets/id/1234.mp3",
+                "audio_source": "file",
+                "image_file_path": "api-assets/id/1234.png",
+            },
             end_seconds=15.0,
             fps=12.0,
             height=960,

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

@@ -15,6 +15,10 @@ from magic_hour.resources.v1.ai_image_upscaler import (
     AiImageUpscalerClient,
     AsyncAiImageUpscalerClient,
 )
+from magic_hour.resources.v1.ai_meme_generator import (
+    AiMemeGeneratorClient,
+    AsyncAiMemeGeneratorClient,
+)
 from magic_hour.resources.v1.ai_photo_editor import (
     AiPhotoEditorClient,
     AsyncAiPhotoEditorClient,
@@ -72,6 +76,7 @@ class V1Client:
         )
         self.ai_image_generator = AiImageGeneratorClient(base_client=self._base_client)
         self.ai_image_upscaler = AiImageUpscalerClient(base_client=self._base_client)
+        self.ai_meme_generator = AiMemeGeneratorClient(base_client=self._base_client)
         self.ai_photo_editor = AiPhotoEditorClient(base_client=self._base_client)
         self.ai_qr_code_generator = AiQrCodeGeneratorClient(
             base_client=self._base_client
@@ -107,6 +112,9 @@ class AsyncV1Client:
         self.ai_image_upscaler = AsyncAiImageUpscalerClient(
             base_client=self._base_client
         )
+        self.ai_meme_generator = AsyncAiMemeGeneratorClient(
+            base_client=self._base_client
+        )
         self.ai_photo_editor = AsyncAiPhotoEditorClient(base_client=self._base_client)
         self.ai_qr_code_generator = AsyncAiQrCodeGeneratorClient(
             base_client=self._base_client

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

@@ -57,7 +57,11 @@ class FaceSwapClient:
         Examples:
         ```py
         client.v1.face_swap.create(
-            assets={"image_file_path": "image/id/1234.png", "video_source": "file"},
+            assets={
+                "image_file_path": "image/id/1234.png",
+                "video_file_path": "api-assets/id/1234.mp4",
+                "video_source": "file",
+            },
             end_seconds=15.0,
             height=960,
             start_seconds=0.0,
@@ -133,7 +137,11 @@ class AsyncFaceSwapClient:
         Examples:
         ```py
         await client.v1.face_swap.create(
-            assets={"image_file_path": "image/id/1234.png", "video_source": "file"},
+            assets={
+                "image_file_path": "image/id/1234.png",
+                "video_file_path": "api-assets/id/1234.mp4",
+                "video_source": "file",
+            },
             end_seconds=15.0,
             height=960,
             start_seconds=0.0,

{magic_hour-0.12.1 → magic_hour-0.13.0}/magic_hour/resources/v1/image_to_video/README.md

@@ -20,7 +20,7 @@ res = client.v1.image_to_video.create(
     assets={"image_file_path": "api-assets/id/1234.png"},
     end_seconds=5.0,
     height=960,
-    style={"prompt": None},
+    style={"prompt": "string"},
     width=512,
     name="Image To Video video",
 )
@@ -37,7 +37,7 @@ res = await client.v1.image_to_video.create(
     assets={"image_file_path": "api-assets/id/1234.png"},
     end_seconds=5.0,
     height=960,
-    style={"prompt": None},
+    style={"prompt": "string"},
     width=512,
     name="Image To Video video",
 )

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

@@ -63,6 +63,7 @@ class LipSyncClient:
         client.v1.lip_sync.create(
             assets={
                 "audio_file_path": "api-assets/id/1234.mp3",
+                "video_file_path": "api-assets/id/1234.mp4",
                 "video_source": "file",
             },
             end_seconds=15.0,
@@ -148,6 +149,7 @@ class AsyncLipSyncClient:
         await client.v1.lip_sync.create(
             assets={
                 "audio_file_path": "api-assets/id/1234.mp3",
+                "video_file_path": "api-assets/id/1234.mp4",
                 "video_source": "file",
             },
             end_seconds=15.0,

{magic_hour-0.12.1 → magic_hour-0.13.0}/magic_hour/resources/v1/video_to_video/README.md

@@ -24,7 +24,7 @@ res = client.v1.video_to_video.create(
     style={
         "art_style": "3D Render",
         "model": "Absolute Reality",
-        "prompt": None,
+        "prompt": "string",
         "prompt_type": "append_default",
         "version": "default",
     },
@@ -49,7 +49,7 @@ res = await client.v1.video_to_video.create(
     style={
         "art_style": "3D Render",
         "model": "Absolute Reality",
-        "prompt": None,
+        "prompt": "string",
         "prompt_type": "append_default",
         "version": "default",
     },

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

@@ -67,7 +67,10 @@ class VideoToVideoClient:
         Examples:
         ```py
         client.v1.video_to_video.create(
-            assets={"video_source": "file"},
+            assets={
+                "video_file_path": "api-assets/id/1234.mp4",
+                "video_source": "file",
+            },
             end_seconds=15.0,
             height=960,
             start_seconds=0.0,
@@ -162,7 +165,10 @@ class AsyncVideoToVideoClient:
         Examples:
         ```py
         await client.v1.video_to_video.create(
-            assets={"video_source": "file"},
+            assets={
+                "video_file_path": "api-assets/id/1234.mp4",
+                "video_source": "file",
+            },
             end_seconds=15.0,
             height=960,
             start_seconds=0.0,

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

@@ -4,6 +4,7 @@ from .v1_ai_headshot_generator_create_response import (
 )
 from .v1_ai_image_generator_create_response import V1AiImageGeneratorCreateResponse
 from .v1_ai_image_upscaler_create_response import V1AiImageUpscalerCreateResponse
+from .v1_ai_meme_generator_create_response import V1AiMemeGeneratorCreateResponse
 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
@@ -39,6 +40,7 @@ __all__ = [
     "V1AiHeadshotGeneratorCreateResponse",
     "V1AiImageGeneratorCreateResponse",
     "V1AiImageUpscalerCreateResponse",
+    "V1AiMemeGeneratorCreateResponse",
     "V1AiPhotoEditorCreateResponse",
     "V1AiQrCodeGeneratorCreateResponse",
     "V1AiTalkingPhotoCreateResponse",

magic_hour-0.13.0/magic_hour/types/models/v1_ai_meme_generator_create_response.py

@@ -0,0 +1,25 @@
+import pydantic
+
+
+class V1AiMemeGeneratorCreateResponse(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-0.12.1 → magic_hour-0.13.0}/magic_hour/types/models/v1_image_projects_get_response.py

@@ -68,15 +68,9 @@ class V1ImageProjectsGetResponse(pydantic.BaseModel):
     """
     The amount of frames used to generate the image.
     """
-    type_: typing_extensions.Literal[
-        "AI_HEADSHOT",
-        "AI_IMAGE",
-        "BACKGROUND_REMOVER",
-        "CLOTHES_CHANGER",
-        "FACE_SWAP",
-        "IMAGE_UPSCALER",
-        "PHOTO_EDITOR",
-        "QR_CODE",
-    ] = pydantic.Field(
+    type_: str = pydantic.Field(
         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
+    """

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

@@ -93,18 +93,12 @@ class V1VideoProjectsGetResponse(pydantic.BaseModel):
     """
     The amount of frames used to generate the video. If the status is not 'complete', the cost is an estimate and will be adjusted when the video completes.
     """
-    type_: typing_extensions.Literal[
-        "ANIMATION",
-        "AUTO_SUBTITLE",
-        "FACE_SWAP",
-        "IMAGE_TO_VIDEO",
-        "LIP_SYNC",
-        "TALKING_PHOTO",
-        "TEXT_TO_VIDEO",
-        "VIDEO_TO_VIDEO",
-    ] = pydantic.Field(
+    type_: str = pydantic.Field(
         alias="type",
     )
+    """
+    The type of the video project. Possible values are ANIMATION, IMAGE_TO_VIDEO, VIDEO_TO_VIDEO, TEXT_TO_VIDEO, FACE_SWAP, LIP_SYNC, AUTO_SUBTITLE, TALKING_PHOTO
+    """
     width: int = pydantic.Field(
         alias="width",
     )

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

@@ -38,6 +38,14 @@ from .v1_ai_image_upscaler_create_body_style import (
     V1AiImageUpscalerCreateBodyStyle,
     _SerializerV1AiImageUpscalerCreateBodyStyle,
 )
+from .v1_ai_meme_generator_create_body import (
+    V1AiMemeGeneratorCreateBody,
+    _SerializerV1AiMemeGeneratorCreateBody,
+)
+from .v1_ai_meme_generator_create_body_style import (
+    V1AiMemeGeneratorCreateBodyStyle,
+    _SerializerV1AiMemeGeneratorCreateBodyStyle,
+)
 from .v1_ai_photo_editor_create_body import (
     V1AiPhotoEditorCreateBody,
     _SerializerV1AiPhotoEditorCreateBody,
@@ -160,6 +168,8 @@ __all__ = [
     "V1AiImageUpscalerCreateBody",
     "V1AiImageUpscalerCreateBodyAssets",
     "V1AiImageUpscalerCreateBodyStyle",
+    "V1AiMemeGeneratorCreateBody",
+    "V1AiMemeGeneratorCreateBodyStyle",
     "V1AiPhotoEditorCreateBody",
     "V1AiPhotoEditorCreateBodyAssets",
     "V1AiPhotoEditorCreateBodyStyle",
@@ -198,6 +208,8 @@ __all__ = [
     "_SerializerV1AiImageUpscalerCreateBody",
     "_SerializerV1AiImageUpscalerCreateBodyAssets",
     "_SerializerV1AiImageUpscalerCreateBodyStyle",
+    "_SerializerV1AiMemeGeneratorCreateBody",
+    "_SerializerV1AiMemeGeneratorCreateBodyStyle",
     "_SerializerV1AiPhotoEditorCreateBody",
     "_SerializerV1AiPhotoEditorCreateBodyAssets",
     "_SerializerV1AiPhotoEditorCreateBodyStyle",

magic_hour-0.13.0/magic_hour/types/params/v1_ai_meme_generator_create_body.py

@@ -0,0 +1,37 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_meme_generator_create_body_style import (
+    V1AiMemeGeneratorCreateBodyStyle,
+    _SerializerV1AiMemeGeneratorCreateBodyStyle,
+)
+
+
+class V1AiMemeGeneratorCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiMemeGeneratorCreateBody
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of the meme.
+    """
+
+    style: typing_extensions.Required[V1AiMemeGeneratorCreateBodyStyle]
+
+
+class _SerializerV1AiMemeGeneratorCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiMemeGeneratorCreateBody 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: _SerializerV1AiMemeGeneratorCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour-0.13.0/magic_hour/types/params/v1_ai_meme_generator_create_body_style.py

@@ -0,0 +1,73 @@
+import pydantic
+import typing
+import typing_extensions
+
+
+class V1AiMemeGeneratorCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    V1AiMemeGeneratorCreateBodyStyle
+    """
+
+    search_web: typing_extensions.NotRequired[bool]
+    """
+    Whether to search the web for meme content.
+    """
+
+    template: typing_extensions.Required[
+        typing_extensions.Literal[
+            "Bike Fall",
+            "Change My Mind",
+            "Disappointed Guy",
+            "Drake Hotline Bling",
+            "Galaxy Brain",
+            "Gru's Plan",
+            "Is This a Pigeon",
+            "Panik Kalm Panik",
+            "Random",
+            "Side Eyeing Chloe",
+            "Tuxedo Winnie The Pooh",
+            "Two Buttons",
+            "Waiting Skeleton",
+        ]
+    ]
+    """
+    To use our templates, pass in one of the enum values.
+    """
+
+    topic: typing_extensions.Required[str]
+    """
+    The topic of the meme.
+    """
+
+
+class _SerializerV1AiMemeGeneratorCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiMemeGeneratorCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    search_web: typing.Optional[bool] = pydantic.Field(alias="searchWeb", default=None)
+    template: typing_extensions.Literal[
+        "Bike Fall",
+        "Change My Mind",
+        "Disappointed Guy",
+        "Drake Hotline Bling",
+        "Galaxy Brain",
+        "Gru's Plan",
+        "Is This a Pigeon",
+        "Panik Kalm Panik",
+        "Random",
+        "Side Eyeing Chloe",
+        "Tuxedo Winnie The Pooh",
+        "Two Buttons",
+        "Waiting Skeleton",
+    ] = pydantic.Field(
+        alias="template",
+    )
+    topic: str = pydantic.Field(
+        alias="topic",
+    )

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

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