magic_hour 0.8.0__py3-none-any.whl

magic_hour/resources/v1/video_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 VideoProjectsClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def delete(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> None:
+        """
+        Delete video
+
+        Permanently delete the rendered video. This action is not reversible, please be sure before deleting.
+
+        DELETE /v1/video-projects/{id}
+
+        Args:
+            id: The id of the video 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.video_projects.delete(id="string")
+        ```
+
+        """
+        self._base_client.request(
+            method="DELETE",
+            path=f"/v1/video-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.GetV1VideoProjectsIdResponse:
+        """
+        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
+
+
+        GET /v1/video-projects/{id}
+
+        Args:
+            id: The id of the video
+            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.video_projects.get(id="string")
+        ```
+
+        """
+        return self._base_client.request(
+            method="GET",
+            path=f"/v1/video-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=models.GetV1VideoProjectsIdResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncVideoProjectsClient:
+    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 video
+
+        Permanently delete the rendered video. This action is not reversible, please be sure before deleting.
+
+        DELETE /v1/video-projects/{id}
+
+        Args:
+            id: The id of the video 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.video_projects.delete(id="string")
+        ```
+
+        """
+        await self._base_client.request(
+            method="DELETE",
+            path=f"/v1/video-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.GetV1VideoProjectsIdResponse:
+        """
+        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
+
+
+        GET /v1/video-projects/{id}
+
+        Args:
+            id: The id of the video
+            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.video_projects.get(id="string")
+        ```
+
+        """
+        return await self._base_client.request(
+            method="GET",
+            path=f"/v1/video-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=models.GetV1VideoProjectsIdResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/video_to_video/README.md

@@ -0,0 +1,60 @@
+
+### create <a name="create"></a>
+Video-to-Video
+
+Create a Video 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/video-to-video).
+  
+
+**API Endpoint**: `POST /v1/video-to-video`
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.video_to_video.create(
+    assets={"video_file_path": "video/id/1234.mp4", "video_source": "file"},
+    end_seconds=15,
+    height=960,
+    start_seconds=0,
+    style={
+        "art_style": "3D Render",
+        "model": "Absolute Reality",
+        "prompt": None,
+        "prompt_type": "append_default",
+        "version": "default",
+    },
+    width=512,
+    fps_resolution="HALF",
+    name="Video 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.video_to_video.create(
+    assets={"video_file_path": "video/id/1234.mp4", "video_source": "file"},
+    end_seconds=15,
+    height=960,
+    start_seconds=0,
+    style={
+        "art_style": "3D Render",
+        "model": "Absolute Reality",
+        "prompt": None,
+        "prompt_type": "append_default",
+        "version": "default",
+    },
+    width=512,
+    fps_resolution="HALF",
+    name="Video To Video video",
+)
+```

magic_hour/resources/v1/video_to_video/__init__.py

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

magic_hour/resources/v1/video_to_video/client.py

@@ -0,0 +1,204 @@
+import typing
+import typing_extensions
+
+from magic_hour.core import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+    to_encodable,
+    type_utils,
+)
+from magic_hour.types import models, params
+
+
+class VideoToVideoClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.PostV1VideoToVideoBodyAssets,
+        end_seconds: float,
+        height: int,
+        start_seconds: float,
+        style: params.PostV1VideoToVideoBodyStyle,
+        width: int,
+        fps_resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
+            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.PostV1VideoToVideoResponse:
+        """
+        Video-to-Video
+
+        Create a Video 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/video-to-video).
+
+
+        POST /v1/video-to-video
+
+        Args:
+            fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
+        * `FULL` - the result video will have the same FPS as the input video
+        * `HALF` - the result video will have half the FPS as the input video
+            name: The name of video
+            assets: Provide the assets for video-to-video. 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. Must be divisible by 64. 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
+            style: PostV1VideoToVideoBodyStyle
+            width: The width of the final output video. Must be divisible by 64. 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.video_to_video.create(
+            assets={"video_source": "file"},
+            end_seconds=15,
+            height=960,
+            start_seconds=0,
+            style={
+                "art_style": "3D Render",
+                "model": "Absolute Reality",
+                "prompt": "string",
+                "prompt_type": "append_default",
+                "version": "default",
+            },
+            width=512,
+            fps_resolution="HALF",
+            name="Video To Video video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "fps_resolution": fps_resolution,
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "start_seconds": start_seconds,
+                "style": style,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1VideoToVideoBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/video-to-video",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1VideoToVideoResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncVideoToVideoClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.PostV1VideoToVideoBodyAssets,
+        end_seconds: float,
+        height: int,
+        start_seconds: float,
+        style: params.PostV1VideoToVideoBodyStyle,
+        width: int,
+        fps_resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
+            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.PostV1VideoToVideoResponse:
+        """
+        Video-to-Video
+
+        Create a Video 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/video-to-video).
+
+
+        POST /v1/video-to-video
+
+        Args:
+            fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
+        * `FULL` - the result video will have the same FPS as the input video
+        * `HALF` - the result video will have half the FPS as the input video
+            name: The name of video
+            assets: Provide the assets for video-to-video. 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. Must be divisible by 64. 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
+            style: PostV1VideoToVideoBodyStyle
+            width: The width of the final output video. Must be divisible by 64. 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.video_to_video.create(
+            assets={"video_source": "file"},
+            end_seconds=15,
+            height=960,
+            start_seconds=0,
+            style={
+                "art_style": "3D Render",
+                "model": "Absolute Reality",
+                "prompt": "string",
+                "prompt_type": "append_default",
+                "version": "default",
+            },
+            width=512,
+            fps_resolution="HALF",
+            name="Video To Video video",
+        )
+        ```
+
+        """
+        _json = to_encodable(
+            item={
+                "fps_resolution": fps_resolution,
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "height": height,
+                "start_seconds": start_seconds,
+                "style": style,
+                "width": width,
+            },
+            dump_with=params._SerializerPostV1VideoToVideoBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/video-to-video",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.PostV1VideoToVideoResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/types/models/__init__.py

@@ -0,0 +1,60 @@
+from .get_v1_image_projects_id_response_downloads_item import (
+    GetV1ImageProjectsIdResponseDownloadsItem,
+)
+from .get_v1_image_projects_id_response_error import GetV1ImageProjectsIdResponseError
+from .get_v1_video_projects_id_response_download import (
+    GetV1VideoProjectsIdResponseDownload,
+)
+from .get_v1_video_projects_id_response_downloads_item import (
+    GetV1VideoProjectsIdResponseDownloadsItem,
+)
+from .get_v1_video_projects_id_response_error import GetV1VideoProjectsIdResponseError
+from .post_v1_ai_clothes_changer_response import PostV1AiClothesChangerResponse
+from .post_v1_ai_headshot_generator_response import PostV1AiHeadshotGeneratorResponse
+from .post_v1_ai_image_generator_response import PostV1AiImageGeneratorResponse
+from .post_v1_ai_image_upscaler_response import PostV1AiImageUpscalerResponse
+from .post_v1_ai_photo_editor_response import PostV1AiPhotoEditorResponse
+from .post_v1_ai_qr_code_generator_response import PostV1AiQrCodeGeneratorResponse
+from .post_v1_animation_response import PostV1AnimationResponse
+from .post_v1_face_swap_response import PostV1FaceSwapResponse
+from .post_v1_face_swap_photo_response import PostV1FaceSwapPhotoResponse
+from .post_v1_files_upload_urls_response_items_item import (
+    PostV1FilesUploadUrlsResponseItemsItem,
+)
+from .post_v1_image_background_remover_response import (
+    PostV1ImageBackgroundRemoverResponse,
+)
+from .post_v1_image_to_video_response import PostV1ImageToVideoResponse
+from .post_v1_lip_sync_response import PostV1LipSyncResponse
+from .post_v1_text_to_video_response import PostV1TextToVideoResponse
+from .post_v1_video_to_video_response import PostV1VideoToVideoResponse
+from .get_v1_image_projects_id_response import GetV1ImageProjectsIdResponse
+from .get_v1_video_projects_id_response import GetV1VideoProjectsIdResponse
+from .post_v1_files_upload_urls_response import PostV1FilesUploadUrlsResponse
+
+
+__all__ = [
+    "GetV1ImageProjectsIdResponse",
+    "GetV1ImageProjectsIdResponseDownloadsItem",
+    "GetV1ImageProjectsIdResponseError",
+    "GetV1VideoProjectsIdResponse",
+    "GetV1VideoProjectsIdResponseDownload",
+    "GetV1VideoProjectsIdResponseDownloadsItem",
+    "GetV1VideoProjectsIdResponseError",
+    "PostV1AiClothesChangerResponse",
+    "PostV1AiHeadshotGeneratorResponse",
+    "PostV1AiImageGeneratorResponse",
+    "PostV1AiImageUpscalerResponse",
+    "PostV1AiPhotoEditorResponse",
+    "PostV1AiQrCodeGeneratorResponse",
+    "PostV1AnimationResponse",
+    "PostV1FaceSwapPhotoResponse",
+    "PostV1FaceSwapResponse",
+    "PostV1FilesUploadUrlsResponse",
+    "PostV1FilesUploadUrlsResponseItemsItem",
+    "PostV1ImageBackgroundRemoverResponse",
+    "PostV1ImageToVideoResponse",
+    "PostV1LipSyncResponse",
+    "PostV1TextToVideoResponse",
+    "PostV1VideoToVideoResponse",
+]

magic_hour/types/models/get_v1_image_projects_id_response.py

@@ -0,0 +1,82 @@
+import typing
+import typing_extensions
+import pydantic
+
+from .get_v1_image_projects_id_response_downloads_item import (
+    GetV1ImageProjectsIdResponseDownloadsItem,
+)
+from .get_v1_image_projects_id_response_error import GetV1ImageProjectsIdResponseError
+
+
+class GetV1ImageProjectsIdResponse(pydantic.BaseModel):
+    """
+    Success
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    created_at: str = pydantic.Field(
+        alias="created_at",
+    )
+    downloads: typing.List[GetV1ImageProjectsIdResponseDownloadsItem] = pydantic.Field(
+        alias="downloads",
+    )
+    enabled: bool = pydantic.Field(
+        alias="enabled",
+    )
+    """
+    Indicates whether the resource is deleted
+    """
+    error: typing.Optional[GetV1ImageProjectsIdResponseError] = pydantic.Field(
+        alias="error",
+    )
+    """
+    In the case of an error, this object will contain the error encountered during video render
+    """
+    id: str = pydantic.Field(
+        alias="id",
+    )
+    """
+    Unique ID of the image. This value can be used in the [get image project API](/api/tag/image-projects/get/v1/image-projects/{id}) to fetch additional details such as status
+    """
+    image_count: int = pydantic.Field(
+        alias="image_count",
+    )
+    """
+    Number of images generated
+    """
+    name: typing.Optional[str] = pydantic.Field(
+        alias="name",
+    )
+    """
+    The name of the image.
+    """
+    status: typing_extensions.Literal[
+        "canceled", "complete", "draft", "error", "queued", "rendering"
+    ] = pydantic.Field(
+        alias="status",
+    )
+    """
+    The status of the image.
+    """
+    total_frame_cost: int = pydantic.Field(
+        alias="total_frame_cost",
+    )
+    """
+    The amount of frames used to generate the image.
+    """
+    type_field: typing_extensions.Literal[
+        "AI_HEADSHOT",
+        "AI_IMAGE",
+        "BACKGROUND_REMOVER",
+        "CLOTHES_CHANGER",
+        "FACE_SWAP",
+        "IMAGE_UPSCALER",
+        "PHOTO_EDITOR",
+        "QR_CODE",
+    ] = pydantic.Field(
+        alias="type",
+    )

magic_hour/types/models/get_v1_image_projects_id_response_downloads_item.py

@@ -0,0 +1,19 @@
+import pydantic
+
+
+class GetV1ImageProjectsIdResponseDownloadsItem(pydantic.BaseModel):
+    """
+    The download url and expiration date of the image project
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    expires_at: str = pydantic.Field(
+        alias="expires_at",
+    )
+    url: str = pydantic.Field(
+        alias="url",
+    )

magic_hour/types/models/get_v1_image_projects_id_response_error.py

@@ -0,0 +1,25 @@
+import pydantic
+
+
+class GetV1ImageProjectsIdResponseError(pydantic.BaseModel):
+    """
+    In the case of an error, this object will contain the error encountered during video render
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    code_field: str = pydantic.Field(
+        alias="code",
+    )
+    """
+    An error code to indicate why a failure happened.
+    """
+    message: str = pydantic.Field(
+        alias="message",
+    )
+    """
+    Details on the reason why a failure happened.
+    """