magic_hour 0.8.0__py3-none-any.whl

magic_hour/resources/v1/ai_photo_editor/README.md

@@ -0,0 +1,53 @@
+
+### create <a name="create"></a>
+AI Photo Editor
+
+> **NOTE**: this API is still in early development stages, and should be avoided. Please reach out to us if you're interested in this API. 
+
+Edit photo using AI. Each photo costs 10 frames.
+
+**API Endpoint**: `POST /v1/ai-photo-editor`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.ai_photo_editor.create(
+    assets={"image_file_path": "api-assets/id/1234.png"},
+    resolution=768,
+    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",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.ai_photo_editor.create(
+    assets={"image_file_path": "api-assets/id/1234.png"},
+    resolution=768,
+    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/resources/v1/ai_photo_editor/__init__.py

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

magic_hour/resources/v1/ai_photo_editor/client.py

@@ -0,0 +1,167 @@
+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 AiPhotoEditorClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1AiPhotoEditorBodyAssets,
+        resolution: int,
+        style: params.PostV1AiPhotoEditorBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        steps: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1AiPhotoEditorResponse:
+        """
+        AI Photo Editor
+
+        > **NOTE**: this API is still in early development stages, and should be avoided. Please reach out to us if you're interested in this API.
+
+        Edit photo using AI. Each photo costs 10 frames.
+
+        POST /v1/ai-photo-editor
+
+        Args:
+            name: The name of image
+            steps: Deprecated: Please use `.style.steps` instead. Number of iterations used to generate the output. Higher values improve quality and increase the strength of the prompt but increase processing time.
+            assets: Provide the assets for photo editor
+            resolution: The resolution of the final output image. The allowed value is based on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
+            style: PostV1AiPhotoEditorBodyStyle
+            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_photo_editor.create(
+            assets={"image_file_path": "api-assets/id/1234.png"},
+            resolution=768,
+            style={
+                "image_description": "A photo of a person",
+                "likeness_strength": 5.2,
+                "prompt": "A photo portrait of a person wearing a hat",
+                "prompt_strength": 3.75,
+            },
+            name="Photo Editor image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "steps": steps,
+                "assets": assets,
+                "resolution": resolution,
+                "style": style,
+            },
+            dump_with=params._SerializerPostV1AiPhotoEditorBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/ai-photo-editor",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1AiPhotoEditorResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAiPhotoEditorClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1AiPhotoEditorBodyAssets,
+        resolution: int,
+        style: params.PostV1AiPhotoEditorBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        steps: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1AiPhotoEditorResponse:
+        """
+        AI Photo Editor
+
+        > **NOTE**: this API is still in early development stages, and should be avoided. Please reach out to us if you're interested in this API.
+
+        Edit photo using AI. Each photo costs 10 frames.
+
+        POST /v1/ai-photo-editor
+
+        Args:
+            name: The name of image
+            steps: Deprecated: Please use `.style.steps` instead. Number of iterations used to generate the output. Higher values improve quality and increase the strength of the prompt but increase processing time.
+            assets: Provide the assets for photo editor
+            resolution: The resolution of the final output image. The allowed value is based on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
+            style: PostV1AiPhotoEditorBodyStyle
+            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_photo_editor.create(
+            assets={"image_file_path": "api-assets/id/1234.png"},
+            resolution=768,
+            style={
+                "image_description": "A photo of a person",
+                "likeness_strength": 5.2,
+                "prompt": "A photo portrait of a person wearing a hat",
+                "prompt_strength": 3.75,
+            },
+            name="Photo Editor image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "steps": steps,
+                "assets": assets,
+                "resolution": resolution,
+                "style": style,
+            },
+            dump_with=params._SerializerPostV1AiPhotoEditorBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/ai-photo-editor",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1AiPhotoEditorResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/ai_qr_code_generator/README.md

@@ -0,0 +1,35 @@
+
+### create <a name="create"></a>
+AI QR Code
+
+Create an AI QR code. Each QR code costs 20 frames.
+
+**API Endpoint**: `POST /v1/ai-qr-code-generator`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.ai_qr_code_generator.create(
+    content="https://magichour.ai",
+    style={"art_style": "Watercolor"},
+    name="Qr Code image",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.ai_qr_code_generator.create(
+    content="https://magichour.ai",
+    style={"art_style": "Watercolor"},
+    name="Qr Code image",
+)
+```

magic_hour/resources/v1/ai_qr_code_generator/__init__.py

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

magic_hour/resources/v1/ai_qr_code_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 AiQrCodeGeneratorClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        content: str,
+        style: params.PostV1AiQrCodeGeneratorBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1AiQrCodeGeneratorResponse:
+        """
+        AI QR Code
+
+        Create an AI QR code. Each QR code costs 20 frames.
+
+        POST /v1/ai-qr-code-generator
+
+        Args:
+            name: The name of image
+            content: The content of the QR code.
+            style: PostV1AiQrCodeGeneratorBodyStyle
+            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_qr_code_generator.create(
+            content="https://magichour.ai",
+            style={"art_style": "Watercolor"},
+            name="Qr Code image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={"name": name, "content": content, "style": style},
+            dump_with=params._SerializerPostV1AiQrCodeGeneratorBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/ai-qr-code-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1AiQrCodeGeneratorResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAiQrCodeGeneratorClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        content: str,
+        style: params.PostV1AiQrCodeGeneratorBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1AiQrCodeGeneratorResponse:
+        """
+        AI QR Code
+
+        Create an AI QR code. Each QR code costs 20 frames.
+
+        POST /v1/ai-qr-code-generator
+
+        Args:
+            name: The name of image
+            content: The content of the QR code.
+            style: PostV1AiQrCodeGeneratorBodyStyle
+            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_qr_code_generator.create(
+            content="https://magichour.ai",
+            style={"art_style": "Watercolor"},
+            name="Qr Code image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={"name": name, "content": content, "style": style},
+            dump_with=params._SerializerPostV1AiQrCodeGeneratorBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/ai-qr-code-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1AiQrCodeGeneratorResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/animation/README.md

@@ -0,0 +1,63 @@
+
+### create <a name="create"></a>
+Animation
+
+Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
+
+**API Endpoint**: `POST /v1/animation`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.animation.create(
+    assets={
+        "audio_file_path": "api-assets/id/1234.mp3",
+        "audio_source": "file",
+        "image_file_path": "api-assets/id/1234.png",
+    },
+    end_seconds=15,
+    fps=12,
+    height=960,
+    style={
+        "art_style": "Painterly Illustration",
+        "camera_effect": "Accelerate",
+        "prompt": "Cyberpunk city",
+        "prompt_type": "ai_choose",
+        "transition_speed": 5,
+    },
+    width=512,
+    name="Animation video",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.animation.create(
+    assets={
+        "audio_file_path": "api-assets/id/1234.mp3",
+        "audio_source": "file",
+        "image_file_path": "api-assets/id/1234.png",
+    },
+    end_seconds=15,
+    fps=12,
+    height=960,
+    style={
+        "art_style": "Painterly Illustration",
+        "camera_effect": "Accelerate",
+        "prompt": "Cyberpunk city",
+        "prompt_type": "ai_choose",
+        "transition_speed": 5,
+    },
+    width=512,
+    name="Animation video",
+)
+```

magic_hour/resources/v1/animation/__init__.py

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

magic_hour/resources/v1/animation/client.py

@@ -0,0 +1,179 @@
+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 AnimationClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1AnimationBodyAssets,
+        end_seconds: float,
+        fps: float,
+        height: int,
+        style: params.PostV1AnimationBodyStyle,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1AnimationResponse:
+        """
+        Animation
+
+        Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
+
+        POST /v1/animation
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for animation.
+            end_seconds: The end time of the input video in seconds
+            fps: The desire output video frame rate
+            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
+            style: Defines the style of the output video
+            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
+            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.animation.create(
+            assets={"audio_source": "file"},
+            end_seconds=15,
+            fps=12,
+            height=960,
+            style={
+                "art_style": "Painterly Illustration",
+                "camera_effect": "Accelerate",
+                "prompt": "Cyberpunk city",
+                "prompt_type": "ai_choose",
+                "transition_speed": 5,
+            },
+            width=512,
+            name="Animation video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "fps": fps,
+                "height": height,
+                "style": style,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1AnimationBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/animation",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1AnimationResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAnimationClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1AnimationBodyAssets,
+        end_seconds: float,
+        fps: float,
+        height: int,
+        style: params.PostV1AnimationBodyStyle,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1AnimationResponse:
+        """
+        Animation
+
+        Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
+
+        POST /v1/animation
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for animation.
+            end_seconds: The end time of the input video in seconds
+            fps: The desire output video frame rate
+            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
+            style: Defines the style of the output video
+            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
+            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.animation.create(
+            assets={"audio_source": "file"},
+            end_seconds=15,
+            fps=12,
+            height=960,
+            style={
+                "art_style": "Painterly Illustration",
+                "camera_effect": "Accelerate",
+                "prompt": "Cyberpunk city",
+                "prompt_type": "ai_choose",
+                "transition_speed": 5,
+            },
+            width=512,
+            name="Animation video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "fps": fps,
+                "height": height,
+                "style": style,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1AnimationBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/animation",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1AnimationResponse,
+            request_options=request_options or default_request_options(),
+        )