magic_hour 0.8.0__py3-none-any.whl

magic_hour/types/params/post_v1_ai_photo_editor_body_style.py

@@ -0,0 +1,67 @@
+import typing
+import typing_extensions
+import pydantic
+
+
+class PostV1AiPhotoEditorBodyStyle(typing_extensions.TypedDict):
+    """
+    PostV1AiPhotoEditorBodyStyle
+    """
+
+    image_description: typing_extensions.Required[str]
+    """
+    Use this to describe what your input image is. This helps maintain aspects of the image you don't want to change.
+    """
+
+    likeness_strength: typing_extensions.Required[float]
+    """
+    Determines the input image's influence. Higher values align the output more with the initial image.
+    """
+
+    negative_prompt: typing_extensions.NotRequired[str]
+    """
+    What you want to avoid seeing in the final output; has a minor effect.
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    What you want your final output to look like. We recommend starting with the image description and making minor edits for best results.
+    """
+
+    prompt_strength: typing_extensions.Required[float]
+    """
+    Determines the prompt's influence. Higher values align the output more with the prompt.
+    """
+
+    steps: typing_extensions.NotRequired[int]
+    """
+    Number of iterations used to generate the output. Higher values improve quality and increase the strength of the prompt but increase processing time.
+    """
+
+
+class _SerializerPostV1AiPhotoEditorBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for PostV1AiPhotoEditorBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    image_description: str = pydantic.Field(
+        alias="image_description",
+    )
+    likeness_strength: float = pydantic.Field(
+        alias="likeness_strength",
+    )
+    negative_prompt: typing.Optional[str] = pydantic.Field(
+        alias="negative_prompt", default=None
+    )
+    prompt: str = pydantic.Field(
+        alias="prompt",
+    )
+    prompt_strength: float = pydantic.Field(
+        alias="prompt_strength",
+    )
+    steps: typing.Optional[int] = pydantic.Field(alias="steps", default=None)

magic_hour/types/params/post_v1_ai_qr_code_generator_body.py

@@ -0,0 +1,45 @@
+import typing
+import typing_extensions
+import pydantic
+
+from .post_v1_ai_qr_code_generator_body_style import (
+    PostV1AiQrCodeGeneratorBodyStyle,
+    _SerializerPostV1AiQrCodeGeneratorBodyStyle,
+)
+
+
+class PostV1AiQrCodeGeneratorBody(typing_extensions.TypedDict):
+    """
+    PostV1AiQrCodeGeneratorBody
+    """
+
+    content: typing_extensions.Required[str]
+    """
+    The content of the QR code.
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of image
+    """
+
+    style: typing_extensions.Required[PostV1AiQrCodeGeneratorBodyStyle]
+
+
+class _SerializerPostV1AiQrCodeGeneratorBody(pydantic.BaseModel):
+    """
+    Serializer for PostV1AiQrCodeGeneratorBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    content: str = pydantic.Field(
+        alias="content",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerPostV1AiQrCodeGeneratorBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour/types/params/post_v1_ai_qr_code_generator_body_style.py

@@ -0,0 +1,28 @@
+import typing_extensions
+import pydantic
+
+
+class PostV1AiQrCodeGeneratorBodyStyle(typing_extensions.TypedDict):
+    """
+    PostV1AiQrCodeGeneratorBodyStyle
+    """
+
+    art_style: typing_extensions.Required[str]
+    """
+    To use our templates, pass in one of Watercolor, Cyberpunk City, Ink Landscape, Interior Painting, Japanese Street, Mech, Minecraft, Picasso Painting, Game Map, Spaceship, Chinese Painting, Winter Village, or pass any custom art style.
+    """
+
+
+class _SerializerPostV1AiQrCodeGeneratorBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for PostV1AiQrCodeGeneratorBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    art_style: str = pydantic.Field(
+        alias="art_style",
+    )

magic_hour/types/params/post_v1_animation_body.py

@@ -0,0 +1,84 @@
+import typing
+import typing_extensions
+import pydantic
+
+from .post_v1_animation_body_assets import (
+    PostV1AnimationBodyAssets,
+    _SerializerPostV1AnimationBodyAssets,
+)
+from .post_v1_animation_body_style import (
+    PostV1AnimationBodyStyle,
+    _SerializerPostV1AnimationBodyStyle,
+)
+
+
+class PostV1AnimationBody(typing_extensions.TypedDict):
+    """
+    PostV1AnimationBody
+    """
+
+    assets: typing_extensions.Required[PostV1AnimationBodyAssets]
+    """
+    Provide the assets for animation.
+    """
+
+    end_seconds: typing_extensions.Required[float]
+    """
+    The end time of the input video in seconds
+    """
+
+    fps: typing_extensions.Required[float]
+    """
+    The desire output video frame rate
+    """
+
+    height: typing_extensions.Required[int]
+    """
+    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
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of video
+    """
+
+    style: typing_extensions.Required[PostV1AnimationBodyStyle]
+    """
+    Defines the style of the output video
+    """
+
+    width: typing_extensions.Required[int]
+    """
+    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
+    """
+
+
+class _SerializerPostV1AnimationBody(pydantic.BaseModel):
+    """
+    Serializer for PostV1AnimationBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerPostV1AnimationBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    end_seconds: float = pydantic.Field(
+        alias="end_seconds",
+    )
+    fps: float = pydantic.Field(
+        alias="fps",
+    )
+    height: int = pydantic.Field(
+        alias="height",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerPostV1AnimationBodyStyle = pydantic.Field(
+        alias="style",
+    )
+    width: int = pydantic.Field(
+        alias="width",
+    )

magic_hour/types/params/post_v1_animation_body_assets.py

@@ -0,0 +1,55 @@
+import typing
+import typing_extensions
+import pydantic
+
+
+class PostV1AnimationBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for animation.
+    """
+
+    audio_file_path: typing_extensions.NotRequired[str]
+    """
+    The path of the input audio. This is the `file_path` field from the response of the [upload urls API](/docs/api/tag/files/post/v1/files/upload-urls). This field is required if `audio_source` is `file`
+    """
+
+    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 is the `file_path` field from the response of the [upload urls API](/docs/api/tag/files/post/v1/files/upload-urls)
+    """
+
+    youtube_url: typing_extensions.NotRequired[str]
+    """
+    Using a youtube video as the input source. This field is required if `audio_source` is `youtube`
+    """
+
+
+class _SerializerPostV1AnimationBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for PostV1AnimationBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: typing.Optional[str] = pydantic.Field(
+        alias="audio_file_path", default=None
+    )
+    audio_source: typing_extensions.Literal["file", "none", "youtube"] = pydantic.Field(
+        alias="audio_source",
+    )
+    image_file_path: typing.Optional[str] = pydantic.Field(
+        alias="image_file_path", default=None
+    )
+    youtube_url: typing.Optional[str] = pydantic.Field(
+        alias="youtube_url", default=None
+    )

magic_hour/types/params/post_v1_animation_body_style.py

@@ -0,0 +1,279 @@
+import typing
+import typing_extensions
+import pydantic
+
+
+class PostV1AnimationBodyStyle(typing_extensions.TypedDict):
+    """
+    Defines the style of the output video
+    """
+
+    art_style: typing_extensions.Required[
+        typing_extensions.Literal[
+            "3D Render",
+            "90s Streets",
+            "Abstract Minimalist",
+            "Arcane",
+            "Art Deco",
+            "Bold Colored Illustration",
+            "Cinematic Landscape",
+            "Cinematic Miyazaki",
+            "Cosmic",
+            "Cubist",
+            "Custom",
+            "Cyberpunk",
+            "Dark Graphic Illustration",
+            "Dark Watercolor",
+            "Directed by AI",
+            "Double Exposure",
+            "Faded Illustration",
+            "Fantasy",
+            "Futuristic Anime",
+            "Impressionism",
+            "Ink and Watercolor Portrait",
+            "Inkpunk",
+            "Intricate Abstract Lines Portrait",
+            "Jackson Pollock",
+            "Landscape Painting",
+            "Low Poly",
+            "Miniatures",
+            "Minimal Cold Futurism",
+            "Oil Painting",
+            "Old School Comic",
+            "Overgrown",
+            "Painted Cityscape",
+            "Painterly Illustration",
+            "Photograph",
+            "Pixar",
+            "Pixel Art",
+            "Postapocalyptic",
+            "Sin City",
+            "Soft Delicate Matte Portrait",
+            "Spooky",
+            "Studio Ghibli Film Still",
+            "Synthwave",
+            "Traditional Watercolor",
+            "Van Gogh",
+            "Vibrant Matte Illustration",
+            "Vintage Japanese Anime",
+            "Woodcut",
+        ]
+    ]
+    """
+    The art style of the final output video
+    """
+
+    art_style_custom: typing_extensions.NotRequired[str]
+    """
+    Describe custom art style. This field is required if `art_style` is `Custom`
+    """
+
+    camera_effect: typing_extensions.Required[
+        typing_extensions.Literal[
+            "Accelerate",
+            "Aggressive Zoom In - Audio Sync",
+            "Aggressive Zoom Out - Audio Sync",
+            "Boost Zoom In",
+            "Boost Zoom Out",
+            "Bounce In And Out",
+            "Bounce Out",
+            "Bounce Out - Audio Sync",
+            "Bounce and Spin - Audio Sync",
+            "Bounce in Place",
+            "Cog in the Machine",
+            "Devolve - Audio Sync",
+            "Directed by AI",
+            "Dramatic Zoom In",
+            "Dramatic Zoom Out",
+            "Drift Spin",
+            "Earthquake Bounce",
+            "Earthquake Bounce - Audio Sync",
+            "Evolve - Audio Sync",
+            "Heartbeat",
+            "Hesitate In",
+            "Jump",
+            "Pan Left",
+            "Pan Right",
+            "Pulse - Audio Sync",
+            "Pusher",
+            "Pusher - Audio Sync",
+            "Quadrant",
+            "Rise and Climb",
+            "Road Trip",
+            "Rodeo",
+            "Roll In",
+            "Roll In - Audio Sync",
+            "Rolling Bounces",
+            "Rubber Band",
+            "Simple Zoom In",
+            "Simple Zoom Out",
+            "Slice Bounce",
+            "Slideshow",
+            "Speed of Light",
+            "Spin Bounce",
+            "Sway Out",
+            "Sway Out - Audio Sync",
+            "Tilt Down",
+            "Tilt Up",
+            "Traverse",
+            "Tron",
+            "Vertigo",
+            "Vertigo - Audio Sync",
+            "Zoom In - Audio Sync",
+            "Zoom In and Spin - Audio Sync",
+            "Zoom Out - Audio Sync",
+        ]
+    ]
+
+    prompt: typing_extensions.Required[typing.Optional[str]]
+    """
+    The prompt used for the video. Prompt is required if `prompt_type` is `custom`. Otherwise this value is ignored
+    """
+
+    prompt_type: typing_extensions.Required[
+        typing_extensions.Literal["ai_choose", "custom", "use_lyrics"]
+    ]
+    """
+    
+    * `custom` - use your own prompt for the video.
+    * `use_lyrics` - Use the lyrics of the audio to create the prompt. If this option is selected, then `assets.audio_source` must be `file` or `youtube`.
+    * `ai_choose` - Let AI write the prompt. If this option is selected, then `assets.audio_source` must be `file` or `youtube`.
+    """
+
+    transition_speed: typing_extensions.Required[int]
+    """
+    Change determines how quickly the video's content changes across frames. Higher = more rapid transitions. Lower = more stable visual experience.
+    """
+
+
+class _SerializerPostV1AnimationBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for PostV1AnimationBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    art_style: typing_extensions.Literal[
+        "3D Render",
+        "90s Streets",
+        "Abstract Minimalist",
+        "Arcane",
+        "Art Deco",
+        "Bold Colored Illustration",
+        "Cinematic Landscape",
+        "Cinematic Miyazaki",
+        "Cosmic",
+        "Cubist",
+        "Custom",
+        "Cyberpunk",
+        "Dark Graphic Illustration",
+        "Dark Watercolor",
+        "Directed by AI",
+        "Double Exposure",
+        "Faded Illustration",
+        "Fantasy",
+        "Futuristic Anime",
+        "Impressionism",
+        "Ink and Watercolor Portrait",
+        "Inkpunk",
+        "Intricate Abstract Lines Portrait",
+        "Jackson Pollock",
+        "Landscape Painting",
+        "Low Poly",
+        "Miniatures",
+        "Minimal Cold Futurism",
+        "Oil Painting",
+        "Old School Comic",
+        "Overgrown",
+        "Painted Cityscape",
+        "Painterly Illustration",
+        "Photograph",
+        "Pixar",
+        "Pixel Art",
+        "Postapocalyptic",
+        "Sin City",
+        "Soft Delicate Matte Portrait",
+        "Spooky",
+        "Studio Ghibli Film Still",
+        "Synthwave",
+        "Traditional Watercolor",
+        "Van Gogh",
+        "Vibrant Matte Illustration",
+        "Vintage Japanese Anime",
+        "Woodcut",
+    ] = pydantic.Field(
+        alias="art_style",
+    )
+    art_style_custom: typing.Optional[str] = pydantic.Field(
+        alias="art_style_custom", default=None
+    )
+    camera_effect: typing_extensions.Literal[
+        "Accelerate",
+        "Aggressive Zoom In - Audio Sync",
+        "Aggressive Zoom Out - Audio Sync",
+        "Boost Zoom In",
+        "Boost Zoom Out",
+        "Bounce In And Out",
+        "Bounce Out",
+        "Bounce Out - Audio Sync",
+        "Bounce and Spin - Audio Sync",
+        "Bounce in Place",
+        "Cog in the Machine",
+        "Devolve - Audio Sync",
+        "Directed by AI",
+        "Dramatic Zoom In",
+        "Dramatic Zoom Out",
+        "Drift Spin",
+        "Earthquake Bounce",
+        "Earthquake Bounce - Audio Sync",
+        "Evolve - Audio Sync",
+        "Heartbeat",
+        "Hesitate In",
+        "Jump",
+        "Pan Left",
+        "Pan Right",
+        "Pulse - Audio Sync",
+        "Pusher",
+        "Pusher - Audio Sync",
+        "Quadrant",
+        "Rise and Climb",
+        "Road Trip",
+        "Rodeo",
+        "Roll In",
+        "Roll In - Audio Sync",
+        "Rolling Bounces",
+        "Rubber Band",
+        "Simple Zoom In",
+        "Simple Zoom Out",
+        "Slice Bounce",
+        "Slideshow",
+        "Speed of Light",
+        "Spin Bounce",
+        "Sway Out",
+        "Sway Out - Audio Sync",
+        "Tilt Down",
+        "Tilt Up",
+        "Traverse",
+        "Tron",
+        "Vertigo",
+        "Vertigo - Audio Sync",
+        "Zoom In - Audio Sync",
+        "Zoom In and Spin - Audio Sync",
+        "Zoom Out - Audio Sync",
+    ] = pydantic.Field(
+        alias="camera_effect",
+    )
+    prompt: typing.Optional[str] = pydantic.Field(
+        alias="prompt",
+    )
+    prompt_type: typing_extensions.Literal["ai_choose", "custom", "use_lyrics"] = (
+        pydantic.Field(
+            alias="prompt_type",
+        )
+    )
+    transition_speed: int = pydantic.Field(
+        alias="transition_speed",
+    )

magic_hour/types/params/post_v1_face_swap_body.py

@@ -0,0 +1,72 @@
+import typing
+import typing_extensions
+import pydantic
+
+from .post_v1_face_swap_body_assets import (
+    PostV1FaceSwapBodyAssets,
+    _SerializerPostV1FaceSwapBodyAssets,
+)
+
+
+class PostV1FaceSwapBody(typing_extensions.TypedDict):
+    """
+    PostV1FaceSwapBody
+    """
+
+    assets: typing_extensions.Required[PostV1FaceSwapBodyAssets]
+    """
+    Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
+    """
+
+    end_seconds: typing_extensions.Required[float]
+    """
+    The end time of the input video in seconds
+    """
+
+    height: typing_extensions.Required[int]
+    """
+    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
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of video
+    """
+
+    start_seconds: typing_extensions.Required[float]
+    """
+    The start time of the input video in seconds
+    """
+
+    width: typing_extensions.Required[int]
+    """
+    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
+    """
+
+
+class _SerializerPostV1FaceSwapBody(pydantic.BaseModel):
+    """
+    Serializer for PostV1FaceSwapBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerPostV1FaceSwapBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    end_seconds: float = pydantic.Field(
+        alias="end_seconds",
+    )
+    height: int = pydantic.Field(
+        alias="height",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    start_seconds: float = pydantic.Field(
+        alias="start_seconds",
+    )
+    width: int = pydantic.Field(
+        alias="width",
+    )

magic_hour/types/params/post_v1_face_swap_body_assets.py

@@ -0,0 +1,52 @@
+import typing
+import typing_extensions
+import pydantic
+
+
+class PostV1FaceSwapBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for face swap. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The path of the input image. This value can be either the `file_path` field from the response of the [upload urls API](/docs/api/tag/files/post/v1/files/upload-urls), or the url of the file.
+    """
+
+    video_file_path: typing_extensions.NotRequired[str]
+    """
+    The path of the input video. This is the `file_path` field from the response of the [upload urls API](/docs/api/tag/files/post/v1/files/upload-urls). This field is required if `video_source` is `file`
+    """
+
+    video_source: typing_extensions.Required[
+        typing_extensions.Literal["file", "youtube"]
+    ]
+
+    youtube_url: typing_extensions.NotRequired[str]
+    """
+    Using a youtube video as the input source. This field is required if `video_source` is `youtube`
+    """
+
+
+class _SerializerPostV1FaceSwapBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for PostV1FaceSwapBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    image_file_path: str = pydantic.Field(
+        alias="image_file_path",
+    )
+    video_file_path: typing.Optional[str] = pydantic.Field(
+        alias="video_file_path", default=None
+    )
+    video_source: typing_extensions.Literal["file", "youtube"] = pydantic.Field(
+        alias="video_source",
+    )
+    youtube_url: typing.Optional[str] = pydantic.Field(
+        alias="youtube_url", default=None
+    )