magic_hour 0.8.0__py3-none-any.whl

magic_hour/resources/v1/client.py

@@ -0,0 +1,153 @@
+from magic_hour.core import AsyncBaseClient, SyncBaseClient
+from magic_hour.resources.v1.image_projects import (
+    AsyncImageProjectsClient,
+    ImageProjectsClient,
+)
+from magic_hour.resources.v1.video_projects import (
+    AsyncVideoProjectsClient,
+    VideoProjectsClient,
+)
+from magic_hour.resources.v1.ai_clothes_changer import (
+    AiClothesChangerClient,
+    AsyncAiClothesChangerClient,
+)
+from magic_hour.resources.v1.ai_headshot_generator import (
+    AiHeadshotGeneratorClient,
+    AsyncAiHeadshotGeneratorClient,
+)
+from magic_hour.resources.v1.ai_image_generator import (
+    AiImageGeneratorClient,
+    AsyncAiImageGeneratorClient,
+)
+from magic_hour.resources.v1.ai_image_upscaler import (
+    AiImageUpscalerClient,
+    AsyncAiImageUpscalerClient,
+)
+from magic_hour.resources.v1.ai_photo_editor import (
+    AiPhotoEditorClient,
+    AsyncAiPhotoEditorClient,
+)
+from magic_hour.resources.v1.ai_qr_code_generator import (
+    AiQrCodeGeneratorClient,
+    AsyncAiQrCodeGeneratorClient,
+)
+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 (
+    AsyncFaceSwapPhotoClient,
+    FaceSwapPhotoClient,
+)
+from magic_hour.resources.v1.files import AsyncFilesClient, FilesClient
+from magic_hour.resources.v1.image_background_remover import (
+    AsyncImageBackgroundRemoverClient,
+    ImageBackgroundRemoverClient,
+)
+from magic_hour.resources.v1.image_to_video import (
+    AsyncImageToVideoClient,
+    ImageToVideoClient,
+)
+from magic_hour.resources.v1.lip_sync import AsyncLipSyncClient, LipSyncClient
+from magic_hour.resources.v1.text_to_video import (
+    AsyncTextToVideoClient,
+    TextToVideoClient,
+)
+from magic_hour.resources.v1.video_to_video import (
+    AsyncVideoToVideoClient,
+    VideoToVideoClient,
+)
+
+
+class V1Client:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+        self.image_projects = ImageProjectsClient(base_client=self._base_client)
+
+        self.video_projects = VideoProjectsClient(base_client=self._base_client)
+
+        self.ai_clothes_changer = AiClothesChangerClient(base_client=self._base_client)
+
+        self.ai_headshot_generator = AiHeadshotGeneratorClient(
+            base_client=self._base_client
+        )
+
+        self.ai_image_generator = AiImageGeneratorClient(base_client=self._base_client)
+
+        self.ai_image_upscaler = AiImageUpscalerClient(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
+        )
+
+        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)
+
+        self.files = FilesClient(base_client=self._base_client)
+
+        self.image_background_remover = ImageBackgroundRemoverClient(
+            base_client=self._base_client
+        )
+
+        self.image_to_video = ImageToVideoClient(base_client=self._base_client)
+
+        self.lip_sync = LipSyncClient(base_client=self._base_client)
+
+        self.text_to_video = TextToVideoClient(base_client=self._base_client)
+
+        self.video_to_video = VideoToVideoClient(base_client=self._base_client)
+
+
+class AsyncV1Client:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+        self.image_projects = AsyncImageProjectsClient(base_client=self._base_client)
+
+        self.video_projects = AsyncVideoProjectsClient(base_client=self._base_client)
+
+        self.ai_clothes_changer = AsyncAiClothesChangerClient(
+            base_client=self._base_client
+        )
+
+        self.ai_headshot_generator = AsyncAiHeadshotGeneratorClient(
+            base_client=self._base_client
+        )
+
+        self.ai_image_generator = AsyncAiImageGeneratorClient(
+            base_client=self._base_client
+        )
+
+        self.ai_image_upscaler = AsyncAiImageUpscalerClient(
+            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
+        )
+
+        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)
+
+        self.files = AsyncFilesClient(base_client=self._base_client)
+
+        self.image_background_remover = AsyncImageBackgroundRemoverClient(
+            base_client=self._base_client
+        )
+
+        self.image_to_video = AsyncImageToVideoClient(base_client=self._base_client)
+
+        self.lip_sync = AsyncLipSyncClient(base_client=self._base_client)
+
+        self.text_to_video = AsyncTextToVideoClient(base_client=self._base_client)
+
+        self.video_to_video = AsyncVideoToVideoClient(base_client=self._base_client)

magic_hour/resources/v1/face_swap/README.md

@@ -0,0 +1,52 @@
+
+### create <a name="create"></a>
+Face Swap video
+
+Create a Face Swap video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
+  
+Get more information about this mode at our [product page](/products/face-swap).
+  
+
+**API Endpoint**: `POST /v1/face-swap`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.face_swap.create(
+    assets={
+        "image_file_path": "image/id/1234.png",
+        "video_file_path": "video/id/1234.mp4",
+        "video_source": "file",
+    },
+    end_seconds=15,
+    height=960,
+    start_seconds=0,
+    width=512,
+    name="Face Swap video",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.face_swap.create(
+    assets={
+        "image_file_path": "image/id/1234.png",
+        "video_file_path": "video/id/1234.mp4",
+        "video_source": "file",
+    },
+    end_seconds=15,
+    height=960,
+    start_seconds=0,
+    width=512,
+    name="Face Swap video",
+)
+```

magic_hour/resources/v1/face_swap/__init__.py

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

magic_hour/resources/v1/face_swap/client.py

@@ -0,0 +1,165 @@
+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 FaceSwapClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1FaceSwapBodyAssets,
+        end_seconds: float,
+        height: int,
+        start_seconds: float,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1FaceSwapResponse:
+        """
+        Face Swap video
+
+        Create a Face Swap video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
+
+        Get more information about this mode at our [product page](/products/face-swap).
+
+
+        POST /v1/face-swap
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for face swap. 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. 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
+            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.face_swap.create(
+            assets={"image_file_path": "image/id/1234.png", "video_source": "file"},
+            end_seconds=15,
+            height=960,
+            start_seconds=0,
+            width=512,
+            name="Face Swap video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "start_seconds": start_seconds,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1FaceSwapBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/face-swap",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1FaceSwapResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncFaceSwapClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1FaceSwapBodyAssets,
+        end_seconds: float,
+        height: int,
+        start_seconds: float,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1FaceSwapResponse:
+        """
+        Face Swap video
+
+        Create a Face Swap video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
+
+        Get more information about this mode at our [product page](/products/face-swap).
+
+
+        POST /v1/face-swap
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for face swap. 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. 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
+            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.face_swap.create(
+            assets={"image_file_path": "image/id/1234.png", "video_source": "file"},
+            end_seconds=15,
+            height=960,
+            start_seconds=0,
+            width=512,
+            name="Face Swap video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "start_seconds": start_seconds,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1FaceSwapBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/face-swap",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1FaceSwapResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/face_swap_photo/README.md

@@ -0,0 +1,39 @@
+
+### create <a name="create"></a>
+Face Swap Photo
+
+Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
+
+**API Endpoint**: `POST /v1/face-swap-photo`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.face_swap_photo.create(
+    assets={
+        "source_file_path": "api-assets/id/1234.png",
+        "target_file_path": "api-assets/id/1234.png",
+    },
+    name="Face Swap image",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.face_swap_photo.create(
+    assets={
+        "source_file_path": "api-assets/id/1234.png",
+        "target_file_path": "api-assets/id/1234.png",
+    },
+    name="Face Swap image",
+)
+```

magic_hour/resources/v1/face_swap_photo/__init__.py

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

magic_hour/resources/v1/face_swap_photo/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 FaceSwapPhotoClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1FaceSwapPhotoBodyAssets,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1FaceSwapPhotoResponse:
+        """
+        Face Swap Photo
+
+        Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
+
+        POST /v1/face-swap-photo
+
+        Args:
+            name: The name of image
+            assets: Provide the assets for face swap photo
+            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.face_swap_photo.create(
+            assets={
+                "source_file_path": "api-assets/id/1234.png",
+                "target_file_path": "api-assets/id/1234.png",
+            },
+            name="Face Swap image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={"name": name, "assets": assets},
+            dump_with=params._SerializerPostV1FaceSwapPhotoBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/face-swap-photo",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1FaceSwapPhotoResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncFaceSwapPhotoClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1FaceSwapPhotoBodyAssets,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1FaceSwapPhotoResponse:
+        """
+        Face Swap Photo
+
+        Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
+
+        POST /v1/face-swap-photo
+
+        Args:
+            name: The name of image
+            assets: Provide the assets for face swap photo
+            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.face_swap_photo.create(
+            assets={
+                "source_file_path": "api-assets/id/1234.png",
+                "target_file_path": "api-assets/id/1234.png",
+            },
+            name="Face Swap image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={"name": name, "assets": assets},
+            dump_with=params._SerializerPostV1FaceSwapPhotoBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/face-swap-photo",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1FaceSwapPhotoResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/files/__init__.py

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

magic_hour/resources/v1/files/client.py

@@ -0,0 +1,19 @@
+from magic_hour.core import AsyncBaseClient, SyncBaseClient
+from magic_hour.resources.v1.files.upload_urls import (
+    AsyncUploadUrlsClient,
+    UploadUrlsClient,
+)
+
+
+class FilesClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+        self.upload_urls = UploadUrlsClient(base_client=self._base_client)
+
+
+class AsyncFilesClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+        self.upload_urls = AsyncUploadUrlsClient(base_client=self._base_client)

magic_hour/resources/v1/files/upload_urls/README.md

@@ -0,0 +1,56 @@
+
+### create <a name="create"></a>
+Generate asset upload urls
+
+Create a list of urls used to upload the assets needed to generate a video. Each video type has their own requirements on what assets are required. Please refer to the specific mode API for more details. The response array will be in the same order as the request body.
+
+Below is the list of valid extensions for each asset type:
+
+- video: mp4, mov, webm
+- audio: mp3, mpeg, wav, aac, aiff, flac
+- image: png, jpg, jpeg, webp, avif, jp2, tiff, bmp
+
+Note: `.gif` is supported for face swap API `video_file_path` field.
+
+After receiving the upload url, you can upload the file by sending a PUT request with the header `'Content-Type: application/octet-stream'`.
+
+For example using curl
+
+```
+curl -X PUT -H 'Content-Type: application/octet-stream' \
+  --data '@/path/to/file/video.mp4' \
+  https://videos.magichour.ai/api-assets/id/video.mp4?auth-value=1234567890
+```
+
+
+**API Endpoint**: `POST /v1/files/upload-urls`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.files.upload_urls.create(
+    items=[
+        {"extension": "mp4", "type_field": "video"},
+        {"extension": "mp3", "type_field": "audio"},
+    ]
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.files.upload_urls.create(
+    items=[
+        {"extension": "mp4", "type_field": "video"},
+        {"extension": "mp3", "type_field": "audio"},
+    ]
+)
+```

magic_hour/resources/v1/files/upload_urls/__init__.py

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