magic_hour 0.8.0__py3-none-any.whl

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

@@ -0,0 +1,142 @@
+import typing
+
+from magic_hour.core import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+    to_encodable,
+)
+from magic_hour.types import models, params
+
+
+class UploadUrlsClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        items: typing.List[params.PostV1FilesUploadUrlsBodyItemsItem],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1FilesUploadUrlsResponse:
+        """
+        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
+        ```
+        
+        
+        POST /v1/files/upload-urls
+        
+        Args:
+            items: typing.List[PostV1FilesUploadUrlsBodyItemsItem]
+            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.files.upload_urls.create(items=[{"extension": "mp4", "type_field": "video"}, {"extension": "mp3", "type_field": "audio"}])
+        ```
+        
+        """
+        _json = to_encodable(
+            item={"items": items}, dump_with=params._SerializerPostV1FilesUploadUrlsBody
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/files/upload-urls",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1FilesUploadUrlsResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncUploadUrlsClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        items: typing.List[params.PostV1FilesUploadUrlsBodyItemsItem],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1FilesUploadUrlsResponse:
+        """
+        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
+        ```
+        
+        
+        POST /v1/files/upload-urls
+        
+        Args:
+            items: typing.List[PostV1FilesUploadUrlsBodyItemsItem]
+            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.files.upload_urls.create(items=[{"extension": "mp4", "type_field": "video"}, {"extension": "mp3", "type_field": "audio"}])
+        ```
+        
+        """
+        _json = to_encodable(
+            item={"items": items}, dump_with=params._SerializerPostV1FilesUploadUrlsBody
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/files/upload-urls",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1FilesUploadUrlsResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/image_background_remover/README.md

@@ -0,0 +1,31 @@
+
+### create <a name="create"></a>
+Image Background Remover
+
+Remove background from image. Each image costs 5 frames.
+
+**API Endpoint**: `POST /v1/image-background-remover`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.image_background_remover.create(
+    assets={"image_file_path": "image/id/1234.png"}, name="Background Remover image"
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.image_background_remover.create(
+    assets={"image_file_path": "image/id/1234.png"}, name="Background Remover image"
+)
+```

magic_hour/resources/v1/image_background_remover/__init__.py

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

magic_hour/resources/v1/image_background_remover/client.py

@@ -0,0 +1,121 @@
+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 ImageBackgroundRemoverClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1ImageBackgroundRemoverBodyAssets,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1ImageBackgroundRemoverResponse:
+        """
+        Image Background Remover
+
+        Remove background from image. Each image costs 5 frames.
+
+        POST /v1/image-background-remover
+
+        Args:
+            name: The name of image
+            assets: Provide the assets for background removal
+            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.image_background_remover.create(
+            assets={"image_file_path": "image/id/1234.png"},
+            name="Background Remover image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={"name": name, "assets": assets},
+            dump_with=params._SerializerPostV1ImageBackgroundRemoverBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/image-background-remover",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1ImageBackgroundRemoverResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncImageBackgroundRemoverClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1ImageBackgroundRemoverBodyAssets,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1ImageBackgroundRemoverResponse:
+        """
+        Image Background Remover
+
+        Remove background from image. Each image costs 5 frames.
+
+        POST /v1/image-background-remover
+
+        Args:
+            name: The name of image
+            assets: Provide the assets for background removal
+            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.image_background_remover.create(
+            assets={"image_file_path": "image/id/1234.png"},
+            name="Background Remover image",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={"name": name, "assets": assets},
+            dump_with=params._SerializerPostV1ImageBackgroundRemoverBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/image-background-remover",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1ImageBackgroundRemoverResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/image_projects/README.md

@@ -0,0 +1,63 @@
+
+### delete <a name="delete"></a>
+Delete image
+
+Permanently delete the rendered image. This action is not reversible, please be sure before deleting.
+
+**API Endpoint**: `DELETE /v1/image-projects/{id}`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.image_projects.delete(id="string")
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.image_projects.delete(id="string")
+```
+
+### get <a name="get"></a>
+Get image details
+
+Get the details of a image project. The `download` field will be `null` unless the image was successfully rendered.
+
+The image can be one of the following status
+- `draft` - not currently used
+- `queued` - the job is queued and waiting for a GPU
+- `rendering` - the generation is in progress
+- `complete` - the image is successful created
+- `error` - an error occurred during rendering
+- `canceled` - image render is canceled by the user
+
+
+**API Endpoint**: `GET /v1/image-projects/{id}`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.image_projects.get(id="string")
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.image_projects.get(id="string")
+```

magic_hour/resources/v1/image_projects/__init__.py

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

magic_hour/resources/v1/image_projects/client.py

@@ -0,0 +1,177 @@
+import typing
+
+from magic_hour.core import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+)
+from magic_hour.types import models
+
+
+class ImageProjectsClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def delete(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> None:
+        """
+        Delete image
+
+        Permanently delete the rendered image. This action is not reversible, please be sure before deleting.
+
+        DELETE /v1/image-projects/{id}
+
+        Args:
+            id: The id of the image project
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            204
+
+        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.image_projects.delete(id="string")
+        ```
+
+        """
+        self._base_client.request(
+            method="DELETE",
+            path=f"/v1/image-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=type(None),
+            request_options=request_options or default_request_options(),
+        )
+
+    def get(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> models.GetV1ImageProjectsIdResponse:
+        """
+        Get image details
+
+        Get the details of a image project. The `download` field will be `null` unless the image was successfully rendered.
+
+        The image can be one of the following status
+        - `draft` - not currently used
+        - `queued` - the job is queued and waiting for a GPU
+        - `rendering` - the generation is in progress
+        - `complete` - the image is successful created
+        - `error` - an error occurred during rendering
+        - `canceled` - image render is canceled by the user
+
+
+        GET /v1/image-projects/{id}
+
+        Args:
+            id: The id of the image project
+            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.image_projects.get(id="string")
+        ```
+
+        """
+        return self._base_client.request(
+            method="GET",
+            path=f"/v1/image-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=models.GetV1ImageProjectsIdResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncImageProjectsClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def delete(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> None:
+        """
+        Delete image
+
+        Permanently delete the rendered image. This action is not reversible, please be sure before deleting.
+
+        DELETE /v1/image-projects/{id}
+
+        Args:
+            id: The id of the image project
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            204
+
+        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.image_projects.delete(id="string")
+        ```
+
+        """
+        await self._base_client.request(
+            method="DELETE",
+            path=f"/v1/image-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=type(None),
+            request_options=request_options or default_request_options(),
+        )
+
+    async def get(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> models.GetV1ImageProjectsIdResponse:
+        """
+        Get image details
+
+        Get the details of a image project. The `download` field will be `null` unless the image was successfully rendered.
+
+        The image can be one of the following status
+        - `draft` - not currently used
+        - `queued` - the job is queued and waiting for a GPU
+        - `rendering` - the generation is in progress
+        - `complete` - the image is successful created
+        - `error` - an error occurred during rendering
+        - `canceled` - image render is canceled by the user
+
+
+        GET /v1/image-projects/{id}
+
+        Args:
+            id: The id of the image project
+            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.image_projects.get(id="string")
+        ```
+
+        """
+        return await self._base_client.request(
+            method="GET",
+            path=f"/v1/image-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=models.GetV1ImageProjectsIdResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/image_to_video/README.md

@@ -0,0 +1,44 @@
+
+### create <a name="create"></a>
+Image-to-Video
+
+Create a Image To Video 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/image-to-video).
+  
+
+**API Endpoint**: `POST /v1/image-to-video`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.image_to_video.create(
+    assets={"image_file_path": "image/id/1234.png"},
+    end_seconds=5,
+    height=960,
+    style={"prompt": None},
+    width=512,
+    name="Image To Video video",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.image_to_video.create(
+    assets={"image_file_path": "image/id/1234.png"},
+    end_seconds=5,
+    height=960,
+    style={"prompt": None},
+    width=512,
+    name="Image To Video video",
+)
+```

magic_hour/resources/v1/image_to_video/__init__.py

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