magic_hour 0.35.0__py3-none-any.whl → 0.36.0__py3-none-any.whl

magic_hour/resources/v1/video_to_video/client.py

@@ -1,3 +1,4 @@
+import logging
 import typing
 import typing_extensions
 
@@ -9,13 +10,127 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
+from magic_hour.resources.v1.files.client import AsyncFilesClient, FilesClient
+from magic_hour.resources.v1.video_projects.client import (
+    AsyncVideoProjectsClient,
+    VideoProjectsClient,
+)
 from magic_hour.types import models, params
 
 
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+
 class VideoToVideoClient:
     def __init__(self, *, base_client: SyncBaseClient):
         self._base_client = base_client
 
+    def generate(
+        self,
+        *,
+        assets: params.V1VideoToVideoGenerateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        style: params.V1VideoToVideoCreateBodyStyle,
+        fps_resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        wait_for_completion: bool = True,
+        download_outputs: bool = True,
+        download_directory: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ):
+        """
+        Generate video-to-video (alias for create with additional functionality).
+
+        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.
+
+        Args:
+            fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
+            height: `height` is deprecated and no longer influences the output video's resolution.
+            name: The name of video. This value is mainly used for your own identification of the video.
+            width: `width` is deprecated and no longer influences the output video's resolution.
+            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. This value is used to trim the input video. The value must be greater than 0.1, and more than the start_seconds.
+            start_seconds: The start time of the input video in seconds. This value is used to trim the input video. The value must be greater than 0.
+            style: V1VideoToVideoCreateBodyStyle
+            wait_for_completion: Whether to wait for the video project to complete
+            download_outputs: Whether to download the outputs
+            download_directory: The directory to download the outputs to. If not provided, the outputs will be downloaded to the current working directory
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            V1VideoProjectsGetResponseWithDownloads: The response from the Video-to-Video API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = client.v1.video_to_video.generate(
+            assets={
+                "video_file_path": "path/to/video.mp4",
+                "video_source": "file",
+            },
+            end_seconds=15.0,
+            start_seconds=0.0,
+            style={
+                "art_style": "3D Render",
+                "model": "default",
+                "prompt": "cyberpunk city",
+                "prompt_type": "default",
+                "version": "default",
+            },
+            fps_resolution="HALF",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = FilesClient(base_client=self._base_client)
+
+        # Upload video file if video_source is "file" and video_file_path is provided
+        if (
+            assets.get("video_source") == "file"
+            and "video_file_path" in assets
+            and assets["video_file_path"]
+        ):
+            video_file_path = assets["video_file_path"]
+            assets["video_file_path"] = file_client.upload_file(file=video_file_path)
+
+        create_response = self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            start_seconds=start_seconds,
+            style=style,
+            fps_resolution=fps_resolution,
+            height=height,
+            name=name,
+            width=width,
+            request_options=request_options,
+        )
+        logger.info(f"Video-to-Video response: {create_response}")
+
+        video_projects_client = VideoProjectsClient(base_client=self._base_client)
+        response = video_projects_client.check_result(
+            id=create_response.id,
+            wait_for_completion=wait_for_completion,
+            download_outputs=download_outputs,
+            download_directory=download_directory,
+        )
+
+        return response
+
     def create(
         self,
         *,
@@ -128,6 +243,113 @@ class AsyncVideoToVideoClient:
     def __init__(self, *, base_client: AsyncBaseClient):
         self._base_client = base_client
 
+    async def generate(
+        self,
+        *,
+        assets: params.V1VideoToVideoGenerateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        style: params.V1VideoToVideoCreateBodyStyle,
+        fps_resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        wait_for_completion: bool = True,
+        download_outputs: bool = True,
+        download_directory: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ):
+        """
+        Generate video-to-video (alias for create with additional functionality).
+
+        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.
+
+        Args:
+            fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
+            height: `height` is deprecated and no longer influences the output video's resolution.
+            name: The name of video. This value is mainly used for your own identification of the video.
+            width: `width` is deprecated and no longer influences the output video's resolution.
+            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. This value is used to trim the input video. The value must be greater than 0.1, and more than the start_seconds.
+            start_seconds: The start time of the input video in seconds. This value is used to trim the input video. The value must be greater than 0.
+            style: V1VideoToVideoCreateBodyStyle
+            wait_for_completion: Whether to wait for the video project to complete
+            download_outputs: Whether to download the outputs
+            download_directory: The directory to download the outputs to. If not provided, the outputs will be downloaded to the current working directory
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            V1VideoProjectsGetResponseWithDownloads: The response from the Video-to-Video API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = await client.v1.video_to_video.generate(
+            assets={
+                "video_file_path": "path/to/video.mp4",
+                "video_source": "file",
+            },
+            end_seconds=15.0,
+            start_seconds=0.0,
+            style={
+                "art_style": "3D Render",
+                "model": "default",
+                "prompt": "cyberpunk city",
+                "prompt_type": "default",
+                "version": "default",
+            },
+            fps_resolution="HALF",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = AsyncFilesClient(base_client=self._base_client)
+
+        # Upload video file if video_source is "file" and video_file_path is provided
+        if (
+            assets.get("video_source") == "file"
+            and "video_file_path" in assets
+            and assets["video_file_path"]
+        ):
+            video_file_path = assets["video_file_path"]
+            assets["video_file_path"] = await file_client.upload_file(
+                file=video_file_path
+            )
+
+        create_response = await self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            start_seconds=start_seconds,
+            style=style,
+            fps_resolution=fps_resolution,
+            height=height,
+            name=name,
+            width=width,
+            request_options=request_options,
+        )
+        logger.info(f"Video-to-Video response: {create_response}")
+
+        video_projects_client = AsyncVideoProjectsClient(base_client=self._base_client)
+        response = await video_projects_client.check_result(
+            id=create_response.id,
+            wait_for_completion=wait_for_completion,
+            download_outputs=download_outputs,
+            download_directory=download_directory,
+        )
+
+        return response
+
     async def create(
         self,
         *,

magic_hour/types/params/__init__.py

@@ -6,6 +6,9 @@ from .v1_ai_clothes_changer_create_body_assets import (
     V1AiClothesChangerCreateBodyAssets,
     _SerializerV1AiClothesChangerCreateBodyAssets,
 )
+from .v1_ai_clothes_changer_generate_body_assets import (
+    V1AiClothesChangerGenerateBodyAssets,
+)
 from .v1_ai_face_editor_create_body import (
     V1AiFaceEditorCreateBody,
     _SerializerV1AiFaceEditorCreateBody,
@@ -18,6 +21,7 @@ from .v1_ai_face_editor_create_body_style import (
     V1AiFaceEditorCreateBodyStyle,
     _SerializerV1AiFaceEditorCreateBodyStyle,
 )
+from .v1_ai_face_editor_generate_body_assets import V1AiFaceEditorGenerateBodyAssets
 from .v1_ai_gif_generator_create_body import (
     V1AiGifGeneratorCreateBody,
     _SerializerV1AiGifGeneratorCreateBody,
@@ -38,6 +42,9 @@ from .v1_ai_headshot_generator_create_body_style import (
     V1AiHeadshotGeneratorCreateBodyStyle,
     _SerializerV1AiHeadshotGeneratorCreateBodyStyle,
 )
+from .v1_ai_headshot_generator_generate_body_assets import (
+    V1AiHeadshotGeneratorGenerateBodyAssets,
+)
 from .v1_ai_image_editor_create_body import (
     V1AiImageEditorCreateBody,
     _SerializerV1AiImageEditorCreateBody,
@@ -50,6 +57,7 @@ from .v1_ai_image_editor_create_body_style import (
     V1AiImageEditorCreateBodyStyle,
     _SerializerV1AiImageEditorCreateBodyStyle,
 )
+from .v1_ai_image_editor_generate_body_assets import V1AiImageEditorGenerateBodyAssets
 from .v1_ai_image_generator_create_body import (
     V1AiImageGeneratorCreateBody,
     _SerializerV1AiImageGeneratorCreateBody,
@@ -70,6 +78,9 @@ from .v1_ai_image_upscaler_create_body_style import (
     V1AiImageUpscalerCreateBodyStyle,
     _SerializerV1AiImageUpscalerCreateBodyStyle,
 )
+from .v1_ai_image_upscaler_generate_body_assets import (
+    V1AiImageUpscalerGenerateBodyAssets,
+)
 from .v1_ai_meme_generator_create_body import (
     V1AiMemeGeneratorCreateBody,
     _SerializerV1AiMemeGeneratorCreateBody,
@@ -90,6 +101,7 @@ from .v1_ai_photo_editor_create_body_style import (
     V1AiPhotoEditorCreateBodyStyle,
     _SerializerV1AiPhotoEditorCreateBodyStyle,
 )
+from .v1_ai_photo_editor_generate_body_assets import V1AiPhotoEditorGenerateBodyAssets
 from .v1_ai_qr_code_generator_create_body import (
     V1AiQrCodeGeneratorCreateBody,
     _SerializerV1AiQrCodeGeneratorCreateBody,
@@ -110,6 +122,7 @@ from .v1_ai_talking_photo_create_body_style import (
     V1AiTalkingPhotoCreateBodyStyle,
     _SerializerV1AiTalkingPhotoCreateBodyStyle,
 )
+from .v1_ai_talking_photo_generate_body_assets import V1AiTalkingPhotoGenerateBodyAssets
 from .v1_animation_create_body import (
     V1AnimationCreateBody,
     _SerializerV1AnimationCreateBody,
@@ -122,6 +135,7 @@ from .v1_animation_create_body_style import (
     V1AnimationCreateBodyStyle,
     _SerializerV1AnimationCreateBodyStyle,
 )
+from .v1_animation_generate_body_assets import V1AnimationGenerateBodyAssets
 from .v1_auto_subtitle_generator_create_body import (
     V1AutoSubtitleGeneratorCreateBody,
     _SerializerV1AutoSubtitleGeneratorCreateBody,
@@ -138,6 +152,9 @@ from .v1_auto_subtitle_generator_create_body_style_custom_config import (
     V1AutoSubtitleGeneratorCreateBodyStyleCustomConfig,
     _SerializerV1AutoSubtitleGeneratorCreateBodyStyleCustomConfig,
 )
+from .v1_auto_subtitle_generator_generate_body_assets import (
+    V1AutoSubtitleGeneratorGenerateBodyAssets,
+)
 from .v1_face_detection_create_body import (
     V1FaceDetectionCreateBody,
     _SerializerV1FaceDetectionCreateBody,
@@ -146,6 +163,7 @@ from .v1_face_detection_create_body_assets import (
     V1FaceDetectionCreateBodyAssets,
     _SerializerV1FaceDetectionCreateBodyAssets,
 )
+from .v1_face_detection_generate_body_assets import V1FaceDetectionGenerateBodyAssets
 from .v1_face_swap_create_body import (
     V1FaceSwapCreateBody,
     _SerializerV1FaceSwapCreateBody,
@@ -158,6 +176,14 @@ from .v1_face_swap_create_body_assets_face_mappings_item import (
     V1FaceSwapCreateBodyAssetsFaceMappingsItem,
     _SerializerV1FaceSwapCreateBodyAssetsFaceMappingsItem,
 )
+from .v1_face_swap_create_body_style import (
+    V1FaceSwapCreateBodyStyle,
+    _SerializerV1FaceSwapCreateBodyStyle,
+)
+from .v1_face_swap_generate_body_assets import V1FaceSwapGenerateBodyAssets
+from .v1_face_swap_generate_body_assets_face_mappings_item import (
+    V1FaceSwapGenerateBodyAssetsFaceMappingsItem,
+)
 from .v1_face_swap_photo_create_body import (
     V1FaceSwapPhotoCreateBody,
     _SerializerV1FaceSwapPhotoCreateBody,
@@ -170,6 +196,10 @@ from .v1_face_swap_photo_create_body_assets_face_mappings_item import (
     V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem,
     _SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem,
 )
+from .v1_face_swap_photo_generate_body_assets import V1FaceSwapPhotoGenerateBodyAssets
+from .v1_face_swap_photo_generate_body_assets_face_mappings_item import (
+    V1FaceSwapPhotoGenerateBodyAssetsFaceMappingsItem,
+)
 from .v1_files_upload_urls_create_body import (
     V1FilesUploadUrlsCreateBody,
     _SerializerV1FilesUploadUrlsCreateBody,
@@ -186,6 +216,9 @@ from .v1_image_background_remover_create_body_assets import (
     V1ImageBackgroundRemoverCreateBodyAssets,
     _SerializerV1ImageBackgroundRemoverCreateBodyAssets,
 )
+from .v1_image_background_remover_generate_body_assets import (
+    V1ImageBackgroundRemoverGenerateBodyAssets,
+)
 from .v1_image_to_video_create_body import (
     V1ImageToVideoCreateBody,
     _SerializerV1ImageToVideoCreateBody,
@@ -198,11 +231,13 @@ from .v1_image_to_video_create_body_style import (
     V1ImageToVideoCreateBodyStyle,
     _SerializerV1ImageToVideoCreateBodyStyle,
 )
+from .v1_image_to_video_generate_body_assets import V1ImageToVideoGenerateBodyAssets
 from .v1_lip_sync_create_body import V1LipSyncCreateBody, _SerializerV1LipSyncCreateBody
 from .v1_lip_sync_create_body_assets import (
     V1LipSyncCreateBodyAssets,
     _SerializerV1LipSyncCreateBodyAssets,
 )
+from .v1_lip_sync_generate_body_assets import V1LipSyncGenerateBodyAssets
 from .v1_photo_colorizer_create_body import (
     V1PhotoColorizerCreateBody,
     _SerializerV1PhotoColorizerCreateBody,
@@ -211,6 +246,7 @@ from .v1_photo_colorizer_create_body_assets import (
     V1PhotoColorizerCreateBodyAssets,
     _SerializerV1PhotoColorizerCreateBodyAssets,
 )
+from .v1_photo_colorizer_generate_body_assets import V1PhotoColorizerGenerateBodyAssets
 from .v1_text_to_video_create_body import (
     V1TextToVideoCreateBody,
     _SerializerV1TextToVideoCreateBody,
@@ -231,68 +267,89 @@ from .v1_video_to_video_create_body_style import (
     V1VideoToVideoCreateBodyStyle,
     _SerializerV1VideoToVideoCreateBodyStyle,
 )
+from .v1_video_to_video_generate_body_assets import V1VideoToVideoGenerateBodyAssets
 
 
 __all__ = [
     "V1AiClothesChangerCreateBody",
     "V1AiClothesChangerCreateBodyAssets",
+    "V1AiClothesChangerGenerateBodyAssets",
     "V1AiFaceEditorCreateBody",
     "V1AiFaceEditorCreateBodyAssets",
     "V1AiFaceEditorCreateBodyStyle",
+    "V1AiFaceEditorGenerateBodyAssets",
     "V1AiGifGeneratorCreateBody",
     "V1AiGifGeneratorCreateBodyStyle",
     "V1AiHeadshotGeneratorCreateBody",
     "V1AiHeadshotGeneratorCreateBodyAssets",
     "V1AiHeadshotGeneratorCreateBodyStyle",
+    "V1AiHeadshotGeneratorGenerateBodyAssets",
     "V1AiImageEditorCreateBody",
     "V1AiImageEditorCreateBodyAssets",
     "V1AiImageEditorCreateBodyStyle",
+    "V1AiImageEditorGenerateBodyAssets",
     "V1AiImageGeneratorCreateBody",
     "V1AiImageGeneratorCreateBodyStyle",
     "V1AiImageUpscalerCreateBody",
     "V1AiImageUpscalerCreateBodyAssets",
     "V1AiImageUpscalerCreateBodyStyle",
+    "V1AiImageUpscalerGenerateBodyAssets",
     "V1AiMemeGeneratorCreateBody",
     "V1AiMemeGeneratorCreateBodyStyle",
     "V1AiPhotoEditorCreateBody",
     "V1AiPhotoEditorCreateBodyAssets",
     "V1AiPhotoEditorCreateBodyStyle",
+    "V1AiPhotoEditorGenerateBodyAssets",
     "V1AiQrCodeGeneratorCreateBody",
     "V1AiQrCodeGeneratorCreateBodyStyle",
     "V1AiTalkingPhotoCreateBody",
     "V1AiTalkingPhotoCreateBodyAssets",
     "V1AiTalkingPhotoCreateBodyStyle",
+    "V1AiTalkingPhotoGenerateBodyAssets",
     "V1AnimationCreateBody",
     "V1AnimationCreateBodyAssets",
     "V1AnimationCreateBodyStyle",
+    "V1AnimationGenerateBodyAssets",
     "V1AutoSubtitleGeneratorCreateBody",
     "V1AutoSubtitleGeneratorCreateBodyAssets",
     "V1AutoSubtitleGeneratorCreateBodyStyle",
     "V1AutoSubtitleGeneratorCreateBodyStyleCustomConfig",
+    "V1AutoSubtitleGeneratorGenerateBodyAssets",
     "V1FaceDetectionCreateBody",
     "V1FaceDetectionCreateBodyAssets",
+    "V1FaceDetectionGenerateBodyAssets",
     "V1FaceSwapCreateBody",
     "V1FaceSwapCreateBodyAssets",
     "V1FaceSwapCreateBodyAssetsFaceMappingsItem",
+    "V1FaceSwapCreateBodyStyle",
+    "V1FaceSwapGenerateBodyAssets",
+    "V1FaceSwapGenerateBodyAssetsFaceMappingsItem",
     "V1FaceSwapPhotoCreateBody",
     "V1FaceSwapPhotoCreateBodyAssets",
     "V1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem",
+    "V1FaceSwapPhotoGenerateBodyAssets",
+    "V1FaceSwapPhotoGenerateBodyAssetsFaceMappingsItem",
     "V1FilesUploadUrlsCreateBody",
     "V1FilesUploadUrlsCreateBodyItemsItem",
     "V1ImageBackgroundRemoverCreateBody",
     "V1ImageBackgroundRemoverCreateBodyAssets",
+    "V1ImageBackgroundRemoverGenerateBodyAssets",
     "V1ImageToVideoCreateBody",
     "V1ImageToVideoCreateBodyAssets",
     "V1ImageToVideoCreateBodyStyle",
+    "V1ImageToVideoGenerateBodyAssets",
     "V1LipSyncCreateBody",
     "V1LipSyncCreateBodyAssets",
+    "V1LipSyncGenerateBodyAssets",
     "V1PhotoColorizerCreateBody",
     "V1PhotoColorizerCreateBodyAssets",
+    "V1PhotoColorizerGenerateBodyAssets",
     "V1TextToVideoCreateBody",
     "V1TextToVideoCreateBodyStyle",
     "V1VideoToVideoCreateBody",
     "V1VideoToVideoCreateBodyAssets",
     "V1VideoToVideoCreateBodyStyle",
+    "V1VideoToVideoGenerateBodyAssets",
     "_SerializerV1AiClothesChangerCreateBody",
     "_SerializerV1AiClothesChangerCreateBodyAssets",
     "_SerializerV1AiFaceEditorCreateBody",
@@ -333,6 +390,7 @@ __all__ = [
     "_SerializerV1FaceSwapCreateBody",
     "_SerializerV1FaceSwapCreateBodyAssets",
     "_SerializerV1FaceSwapCreateBodyAssetsFaceMappingsItem",
+    "_SerializerV1FaceSwapCreateBodyStyle",
     "_SerializerV1FaceSwapPhotoCreateBody",
     "_SerializerV1FaceSwapPhotoCreateBodyAssets",
     "_SerializerV1FaceSwapPhotoCreateBodyAssetsFaceMappingsItem",

magic_hour/types/params/v1_ai_clothes_changer_generate_body_assets.py

@@ -0,0 +1,33 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiClothesChangerGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for clothes changer
+    """
+
+    garment_file_path: typing_extensions.Required[str]
+    """
+    The image of the outfit. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    garment_type: typing_extensions.Required[
+        typing_extensions.Literal["dresses", "lower_body", "upper_body"]
+    ]
+    """
+    The type of the outfit.
+    """
+
+    person_file_path: typing_extensions.Required[str]
+    """
+    The image with the person. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_face_editor_generate_body_assets.py

@@ -0,0 +1,17 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiFaceEditorGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for face editor
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    This is the image whose face will be edited. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_headshot_generator_generate_body_assets.py

@@ -0,0 +1,17 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiHeadshotGeneratorGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for headshot photo
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The image used to generate the headshot. This image must contain one detectable face. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_image_editor_generate_body_assets.py

@@ -0,0 +1,17 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiImageEditorGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for image edit
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The image used in the edit. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_image_upscaler_generate_body_assets.py

@@ -0,0 +1,17 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiImageUpscalerGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for upscaling
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The image to upscale. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_photo_editor_generate_body_assets.py

@@ -0,0 +1,17 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiPhotoEditorGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for photo editor
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The image used to generate the output. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_ai_talking_photo_generate_body_assets.py

@@ -0,0 +1,26 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiTalkingPhotoGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for creating a talking photo
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio file to sync with the image. This value is either
+    - a direct URL to the video file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The source image to animate. This value is either
+    - a direct URL to the video file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """

magic_hour/types/params/v1_animation_generate_body_assets.py

@@ -0,0 +1,39 @@
+import pydantic
+import typing
+import typing_extensions
+
+
+class V1AnimationGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for animation.
+    """
+
+    audio_file_path: typing_extensions.NotRequired[str]
+    """
+    The path of the input audio. This field is required if `audio_source` is `file`. This value is either
+    - a direct URL to the video file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    audio_source: typing_extensions.Required[
+        typing_extensions.Literal["file", "none", "youtube"]
+    ]
+    """
+    Optionally add an audio source if you'd like to incorporate audio into your video
+    """
+
+    image_file_path: typing_extensions.NotRequired[str]
+    """
+    An initial image to use a the first frame of the video. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    youtube_url: typing_extensions.NotRequired[str]
+    """
+    Using a youtube video as the input source. This field is required if `audio_source` is `youtube`
+    """