magic_hour 0.8.0__py3-none-any.whl

magic_hour/resources/v1/image_to_video/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 ImageToVideoClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1ImageToVideoBodyAssets,
+        end_seconds: float,
+        height: int,
+        style: params.PostV1ImageToVideoBodyStyle,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1ImageToVideoResponse:
+        """
+        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).
+
+
+        POST /v1/image-to-video
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for image-to-video.
+            end_seconds: The total duration of the output video in seconds.
+            height: The height of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
+            style: PostV1ImageToVideoBodyStyle
+            width: The width of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
+            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_to_video.create(
+            assets={"image_file_path": "image/id/1234.png"},
+            end_seconds=5,
+            height=960,
+            style={"prompt": "string"},
+            width=512,
+            name="Image To Video video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "style": style,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1ImageToVideoBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/image-to-video",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1ImageToVideoResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncImageToVideoClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1ImageToVideoBodyAssets,
+        end_seconds: float,
+        height: int,
+        style: params.PostV1ImageToVideoBodyStyle,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1ImageToVideoResponse:
+        """
+        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).
+
+
+        POST /v1/image-to-video
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for image-to-video.
+            end_seconds: The total duration of the output video in seconds.
+            height: The height of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
+            style: PostV1ImageToVideoBodyStyle
+            width: The width of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
+            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_to_video.create(
+            assets={"image_file_path": "image/id/1234.png"},
+            end_seconds=5,
+            height=960,
+            style={"prompt": "string"},
+            width=512,
+            name="Image To Video video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "style": style,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1ImageToVideoBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/image-to-video",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1ImageToVideoResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/lip_sync/README.md

@@ -0,0 +1,54 @@
+
+### create <a name="create"></a>
+Lip Sync
+
+Create a Lip Sync 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/lip-sync).
+  
+
+**API Endpoint**: `POST /v1/lip-sync`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.lip_sync.create(
+    assets={
+        "audio_file_path": "audio/id/1234.mp3",
+        "video_file_path": "video/id/1234.mp4",
+        "video_source": "file",
+    },
+    end_seconds=15,
+    height=960,
+    start_seconds=0,
+    width=512,
+    max_fps_limit=12,
+    name="Lip Sync video",
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.lip_sync.create(
+    assets={
+        "audio_file_path": "audio/id/1234.mp3",
+        "video_file_path": "video/id/1234.mp4",
+        "video_source": "file",
+    },
+    end_seconds=15,
+    height=960,
+    start_seconds=0,
+    width=512,
+    max_fps_limit=12,
+    name="Lip Sync video",
+)
+```

magic_hour/resources/v1/lip_sync/__init__.py

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

magic_hour/resources/v1/lip_sync/client.py

@@ -0,0 +1,177 @@
+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 LipSyncClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1LipSyncBodyAssets,
+        end_seconds: float,
+        height: int,
+        start_seconds: float,
+        width: int,
+        max_fps_limit: typing.Union[
+            typing.Optional[float], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1LipSyncResponse:
+        """
+        Lip Sync
+
+        Create a Lip Sync 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/lip-sync).
+
+
+        POST /v1/lip-sync
+
+        Args:
+            max_fps_limit: Defines the maximum FPS (frames per second) for the output video. If the input video's FPS is lower than this limit, the output video will retain the input FPS. This is useful for reducing unnecessary frame usage in scenarios where high FPS is not required.
+            name: The name of video
+            assets: Provide the assets for lip-sync. 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.lip_sync.create(
+            assets={"audio_file_path": "audio/id/1234.mp3", "video_source": "file"},
+            end_seconds=15,
+            height=960,
+            start_seconds=0,
+            width=512,
+            max_fps_limit=12,
+            name="Lip Sync video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "max_fps_limit": max_fps_limit,
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "start_seconds": start_seconds,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1LipSyncBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/lip-sync",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1LipSyncResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncLipSyncClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1LipSyncBodyAssets,
+        end_seconds: float,
+        height: int,
+        start_seconds: float,
+        width: int,
+        max_fps_limit: typing.Union[
+            typing.Optional[float], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1LipSyncResponse:
+        """
+        Lip Sync
+
+        Create a Lip Sync 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/lip-sync).
+
+
+        POST /v1/lip-sync
+
+        Args:
+            max_fps_limit: Defines the maximum FPS (frames per second) for the output video. If the input video's FPS is lower than this limit, the output video will retain the input FPS. This is useful for reducing unnecessary frame usage in scenarios where high FPS is not required.
+            name: The name of video
+            assets: Provide the assets for lip-sync. 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.lip_sync.create(
+            assets={"audio_file_path": "audio/id/1234.mp3", "video_source": "file"},
+            end_seconds=15,
+            height=960,
+            start_seconds=0,
+            width=512,
+            max_fps_limit=12,
+            name="Lip Sync video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "max_fps_limit": max_fps_limit,
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "start_seconds": start_seconds,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1LipSyncBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/lip-sync",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1LipSyncResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/text_to_video/README.md

@@ -0,0 +1,40 @@
+
+### create <a name="create"></a>
+Text-to-Video
+
+Create a Text 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/text-to-video).
+  
+
+**API Endpoint**: `POST /v1/text-to-video`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.text_to_video.create(
+    end_seconds=5,
+    orientation="landscape",
+    style={"prompt": "string"},
+    name="Text 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.text_to_video.create(
+    end_seconds=5,
+    orientation="landscape",
+    style={"prompt": "string"},
+    name="Text To Video video",
+)
+```

magic_hour/resources/v1/text_to_video/__init__.py

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

magic_hour/resources/v1/text_to_video/client.py

@@ -0,0 +1,150 @@
+import typing_extensions
+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 TextToVideoClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        end_seconds: float,
+        orientation: typing_extensions.Literal["landscape", "portrait", "square"],
+        style: params.PostV1TextToVideoBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1TextToVideoResponse:
+        """
+        Text-to-Video
+
+        Create a Text 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/text-to-video).
+
+
+        POST /v1/text-to-video
+
+        Args:
+            name: The name of video
+            end_seconds: The total duration of the output video in seconds.
+            orientation: Determines the orientation of the output video
+            style: PostV1TextToVideoBodyStyle
+            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.text_to_video.create(
+            end_seconds=5,
+            orientation="landscape",
+            style={"prompt": "string"},
+            name="Text To Video video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "end_seconds": end_seconds,
+                "orientation": orientation,
+                "style": style,
+            },
+            dump_with=params._SerializerPostV1TextToVideoBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/text-to-video",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1TextToVideoResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncTextToVideoClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        end_seconds: float,
+        orientation: typing_extensions.Literal["landscape", "portrait", "square"],
+        style: params.PostV1TextToVideoBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.PostV1TextToVideoResponse:
+        """
+        Text-to-Video
+
+        Create a Text 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/text-to-video).
+
+
+        POST /v1/text-to-video
+
+        Args:
+            name: The name of video
+            end_seconds: The total duration of the output video in seconds.
+            orientation: Determines the orientation of the output video
+            style: PostV1TextToVideoBodyStyle
+            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.text_to_video.create(
+            end_seconds=5,
+            orientation="landscape",
+            style={"prompt": "string"},
+            name="Text To Video video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "end_seconds": end_seconds,
+                "orientation": orientation,
+                "style": style,
+            },
+            dump_with=params._SerializerPostV1TextToVideoBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/text-to-video",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1TextToVideoResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/video_projects/README.md

@@ -0,0 +1,63 @@
+
+### delete <a name="delete"></a>
+Delete video
+
+Permanently delete the rendered video. This action is not reversible, please be sure before deleting.
+
+**API Endpoint**: `DELETE /v1/video-projects/{id}`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.video_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.video_projects.delete(id="string")
+```
+
+### get <a name="get"></a>
+Get video details
+
+Get the details of a video project. The `download` field will be `null` unless the video was successfully rendered.
+
+The video 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 video is successful created
+- `error` - an error occurred during rendering
+- `canceled` - video render is canceled by the user
+
+
+**API Endpoint**: `GET /v1/video-projects/{id}`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.video_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.video_projects.get(id="string")
+```

magic_hour/resources/v1/video_projects/__init__.py

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