magic_hour 0.39.0__py3-none-any.whl → 0.40.0__py3-none-any.whl

magic_hour/resources/v1/image_projects/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Check results <a name="check-result"></a>

magic_hour/resources/v1/image_to_video/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Image To Video Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/lip_sync/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Lip Sync Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/photo_colorizer/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Photo Colorizer Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/text_to_video/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Text To Video Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/video_projects/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Check results <a name="check-result"></a>

magic_hour/resources/v1/video_to_video/README.md

@@ -3,6 +3,7 @@
 ## Module Functions
 
 
+
 <!-- CUSTOM DOCS START -->
 
 ### Video To Video Generate Workflow <a name="generate"></a>
@@ -97,12 +98,12 @@ Get more information about this mode at our [product page](https://magichour.ai/
 | `└─ youtube_url` | ✗ | — | Using a youtube video as the input source. This field is required if `video_source` is `youtube` | `"http://www.example.com"` |
 | `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. | `15.0` |
 | `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. | `0.0` |
-| `style` | ✓ | ✗ |  | `{"art_style": "3D Render", "model": "default", "prompt": "string", "prompt_type": "default", "version": "default"}` |
+| `style` | ✓ | ✗ |  | `{"art_style": "3D Render", "model": "default", "prompt_type": "default", "version": "default"}` |
 | `└─ art_style` | ✓ | — |  | `"3D Render"` |
-| `└─ model` | ✓ | — | * `Dreamshaper` - a good all-around model that works for both animations as well as realism.  * `Absolute Reality` - better at realism, but you'll often get similar results with Dreamshaper as well.  * `Flat 2D Anime` - best for a flat illustration style that's common in most anime. * `default` - use the default recommended model for the selected art style. | `"default"` |
-| `└─ prompt` | ✓ | — | The prompt used for the video. Prompt is required if `prompt_type` is `custom` or `append_default`. If `prompt_type` is `default`, then the `prompt` value passed will be ignored. | `"string"` |
-| `└─ prompt_type` | ✓ | — | * `default` - Use the default recommended prompt for the art style. * `custom` - Only use the prompt passed in the API. Note: for v1, lora prompt will still be auto added to apply the art style properly. * `append_default` - Add the default recommended prompt to the end of the prompt passed in the API. | `"default"` |
-| `└─ version` | ✓ | — | * `v1` - more detail, closer prompt adherence, and frame-by-frame previews. * `v2` - faster, more consistent, and less noisy. * `default` - use the default version for the selected art style. | `"default"` |
+| `└─ model` | ✗ | — | * `Dreamshaper` - a good all-around model that works for both animations as well as realism.  * `Absolute Reality` - better at realism, but you'll often get similar results with Dreamshaper as well.  * `Flat 2D Anime` - best for a flat illustration style that's common in most anime. * `default` - use the default recommended model for the selected art style. | `"default"` |
+| `└─ prompt` | ✗ | — | The prompt used for the video. Prompt is required if `prompt_type` is `custom` or `append_default`. If `prompt_type` is `default`, then the `prompt` value passed will be ignored. | `"string"` |
+| `└─ prompt_type` | ✗ | — | * `default` - Use the default recommended prompt for the art style. * `custom` - Only use the prompt passed in the API. Note: for v1, lora prompt will still be auto added to apply the art style properly. * `append_default` - Add the default recommended prompt to the end of the prompt passed in the API. | `"default"` |
+| `└─ version` | ✗ | — | * `v1` - more detail, closer prompt adherence, and frame-by-frame previews. * `v2` - faster, more consistent, and less noisy. * `default` - use the default version for the selected art style. | `"default"` |
 | `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 | `"HALF"` |
 | `height` | ✗ | ✓ | `height` is deprecated and no longer influences the output video's resolution.  Output resolution is determined by the **minimum** of: - The resolution of the input video - The maximum resolution allowed by your subscription tier. See our [pricing page](https://magichour.ai/pricing) for more details.  This field is retained only for backward compatibility and will be removed in a future release. | `123` |
 | `name` | ✗ | ✗ | The name of video. This value is mainly used for your own identification of the video. | `"Video To Video video"` |
@@ -122,7 +123,6 @@ res = client.v1.video_to_video.create(
     style={
         "art_style": "3D Render",
         "model": "default",
-        "prompt": "string",
         "prompt_type": "default",
         "version": "default",
     },
@@ -146,7 +146,6 @@ res = await client.v1.video_to_video.create(
     style={
         "art_style": "3D Render",
         "model": "default",
-        "prompt": "string",
         "prompt_type": "default",
         "version": "default",
     },

magic_hour/resources/v1/video_to_video/client.py

@@ -206,7 +206,6 @@ class VideoToVideoClient:
             style={
                 "art_style": "3D Render",
                 "model": "default",
-                "prompt": "string",
                 "prompt_type": "default",
                 "version": "default",
             },
@@ -425,7 +424,6 @@ class AsyncVideoToVideoClient:
             style={
                 "art_style": "3D Render",
                 "model": "default",
-                "prompt": "string",
                 "prompt_type": "default",
                 "version": "default",
             },

magic_hour/types/models/__init__.py

@@ -11,7 +11,13 @@ from .v1_ai_meme_generator_create_response import V1AiMemeGeneratorCreateRespons
 from .v1_ai_photo_editor_create_response import V1AiPhotoEditorCreateResponse
 from .v1_ai_qr_code_generator_create_response import V1AiQrCodeGeneratorCreateResponse
 from .v1_ai_talking_photo_create_response import V1AiTalkingPhotoCreateResponse
+from .v1_ai_voice_generator_create_response import V1AiVoiceGeneratorCreateResponse
 from .v1_animation_create_response import V1AnimationCreateResponse
+from .v1_audio_projects_get_response import V1AudioProjectsGetResponse
+from .v1_audio_projects_get_response_downloads_item import (
+    V1AudioProjectsGetResponseDownloadsItem,
+)
+from .v1_audio_projects_get_response_error import V1AudioProjectsGetResponseError
 from .v1_auto_subtitle_generator_create_response import (
     V1AutoSubtitleGeneratorCreateResponse,
 )
@@ -59,7 +65,11 @@ __all__ = [
     "V1AiPhotoEditorCreateResponse",
     "V1AiQrCodeGeneratorCreateResponse",
     "V1AiTalkingPhotoCreateResponse",
+    "V1AiVoiceGeneratorCreateResponse",
     "V1AnimationCreateResponse",
+    "V1AudioProjectsGetResponse",
+    "V1AudioProjectsGetResponseDownloadsItem",
+    "V1AudioProjectsGetResponseError",
     "V1AutoSubtitleGeneratorCreateResponse",
     "V1FaceDetectionCreateResponse",
     "V1FaceDetectionGetResponse",

magic_hour/types/models/v1_ai_voice_generator_create_response.py

@@ -0,0 +1,27 @@
+import pydantic
+
+
+class V1AiVoiceGeneratorCreateResponse(pydantic.BaseModel):
+    """
+    Success
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    credits_charged: int = pydantic.Field(
+        alias="credits_charged",
+    )
+    """
+    The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made. 
+    
+    If an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.
+    """
+    id: str = pydantic.Field(
+        alias="id",
+    )
+    """
+    Unique ID of the audio. This value can be used in the [get audio project API](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details) to fetch additional details such as status
+    """

magic_hour/types/models/v1_audio_projects_get_response.py

@@ -0,0 +1,72 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_audio_projects_get_response_downloads_item import (
+    V1AudioProjectsGetResponseDownloadsItem,
+)
+from .v1_audio_projects_get_response_error import V1AudioProjectsGetResponseError
+
+
+class V1AudioProjectsGetResponse(pydantic.BaseModel):
+    """
+    Success
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    created_at: str = pydantic.Field(
+        alias="created_at",
+    )
+    credits_charged: int = pydantic.Field(
+        alias="credits_charged",
+    )
+    """
+    The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made. 
+    
+    If an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.
+    """
+    downloads: typing.List[V1AudioProjectsGetResponseDownloadsItem] = pydantic.Field(
+        alias="downloads",
+    )
+    enabled: bool = pydantic.Field(
+        alias="enabled",
+    )
+    """
+    Indicates whether the resource is deleted
+    """
+    error: typing.Optional[V1AudioProjectsGetResponseError] = 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 audio. This value can be used in the [get audio project API](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details) to fetch additional details such as status
+    """
+    name: typing.Optional[str] = pydantic.Field(
+        alias="name",
+    )
+    """
+    The name of the audio.
+    """
+    status: typing_extensions.Literal[
+        "canceled", "complete", "draft", "error", "queued", "rendering"
+    ] = pydantic.Field(
+        alias="status",
+    )
+    """
+    The status of the audio.
+    """
+    type_: str = pydantic.Field(
+        alias="type",
+    )
+    """
+    The type of the audio project. Possible values are VOICE_GENERATOR
+    """

magic_hour/types/models/v1_audio_projects_get_response_downloads_item.py

@@ -0,0 +1,19 @@
+import pydantic
+
+
+class V1AudioProjectsGetResponseDownloadsItem(pydantic.BaseModel):
+    """
+    The download url and expiration date of the audio 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/v1_audio_projects_get_response_error.py

@@ -0,0 +1,25 @@
+import pydantic
+
+
+class V1AudioProjectsGetResponseError(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: 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.
+    """

magic_hour/types/params/__init__.py

@@ -123,6 +123,14 @@ from .v1_ai_talking_photo_create_body_style import (
     _SerializerV1AiTalkingPhotoCreateBodyStyle,
 )
 from .v1_ai_talking_photo_generate_body_assets import V1AiTalkingPhotoGenerateBodyAssets
+from .v1_ai_voice_generator_create_body import (
+    V1AiVoiceGeneratorCreateBody,
+    _SerializerV1AiVoiceGeneratorCreateBody,
+)
+from .v1_ai_voice_generator_create_body_style import (
+    V1AiVoiceGeneratorCreateBodyStyle,
+    _SerializerV1AiVoiceGeneratorCreateBodyStyle,
+)
 from .v1_animation_create_body import (
     V1AnimationCreateBody,
     _SerializerV1AnimationCreateBody,
@@ -306,6 +314,8 @@ __all__ = [
     "V1AiTalkingPhotoCreateBodyAssets",
     "V1AiTalkingPhotoCreateBodyStyle",
     "V1AiTalkingPhotoGenerateBodyAssets",
+    "V1AiVoiceGeneratorCreateBody",
+    "V1AiVoiceGeneratorCreateBodyStyle",
     "V1AnimationCreateBody",
     "V1AnimationCreateBodyAssets",
     "V1AnimationCreateBodyStyle",
@@ -378,6 +388,8 @@ __all__ = [
     "_SerializerV1AiTalkingPhotoCreateBody",
     "_SerializerV1AiTalkingPhotoCreateBodyAssets",
     "_SerializerV1AiTalkingPhotoCreateBodyStyle",
+    "_SerializerV1AiVoiceGeneratorCreateBody",
+    "_SerializerV1AiVoiceGeneratorCreateBodyStyle",
     "_SerializerV1AnimationCreateBody",
     "_SerializerV1AnimationCreateBodyAssets",
     "_SerializerV1AnimationCreateBodyStyle",

magic_hour/types/params/v1_ai_voice_generator_create_body.py

@@ -0,0 +1,40 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_voice_generator_create_body_style import (
+    V1AiVoiceGeneratorCreateBodyStyle,
+    _SerializerV1AiVoiceGeneratorCreateBodyStyle,
+)
+
+
+class V1AiVoiceGeneratorCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiVoiceGeneratorCreateBody
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of audio. This value is mainly used for your own identification of the audio.
+    """
+
+    style: typing_extensions.Required[V1AiVoiceGeneratorCreateBodyStyle]
+    """
+    The content used to generate speech.
+    """
+
+
+class _SerializerV1AiVoiceGeneratorCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceGeneratorCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerV1AiVoiceGeneratorCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour/types/params/v1_ai_voice_generator_create_body_style.py

@@ -0,0 +1,60 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceGeneratorCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    The content used to generate speech.
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    Text used to generate speech. Starter tier users can use up to 200 characters, while Creator, Pro, or Business users can use up to 1000.
+    """
+
+    voice_name: typing_extensions.Required[
+        typing_extensions.Literal[
+            "Barack Obama",
+            "Donald Trump",
+            "Elon Musk",
+            "Joe Biden",
+            "Joe Rogan",
+            "Kanye West",
+            "Kim Kardashian",
+            "Mark Zuckerberg",
+            "Morgan Freeman",
+            "Taylor Swift",
+        ]
+    ]
+    """
+    The voice to use for the speech. Available voices: Elon Musk, Mark Zuckerberg, Joe Rogan, Barack Obama, Morgan Freeman, Kanye West, Donald Trump, Joe Biden, Kim Kardashian, Taylor Swift
+    """
+
+
+class _SerializerV1AiVoiceGeneratorCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceGeneratorCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    prompt: str = pydantic.Field(
+        alias="prompt",
+    )
+    voice_name: typing_extensions.Literal[
+        "Barack Obama",
+        "Donald Trump",
+        "Elon Musk",
+        "Joe Biden",
+        "Joe Rogan",
+        "Kanye West",
+        "Kim Kardashian",
+        "Mark Zuckerberg",
+        "Morgan Freeman",
+        "Taylor Swift",
+    ] = pydantic.Field(
+        alias="voice_name",
+    )

magic_hour/types/params/v1_video_to_video_create_body_style.py

@@ -19,6 +19,7 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
             "Avatar",
             "Black Spiderman",
             "Boba Fett",
+            "Bold Anime",
             "Celestial Skin",
             "Chinese Swordsmen",
             "Clay",
@@ -58,6 +59,7 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
             "Pixel",
             "Power Armor",
             "Power Ranger",
+            "Realistic Anime",
             "Retro Anime",
             "Retro Sci-Fi",
             "Samurai",
@@ -79,7 +81,7 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
         ]
     ]
 
-    model: typing_extensions.Required[
+    model: typing_extensions.NotRequired[
         typing_extensions.Literal[
             "Absolute Reality", "Dreamshaper", "Flat 2D Anime", "default"
         ]
@@ -91,12 +93,12 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
     * `default` - use the default recommended model for the selected art style.
     """
 
-    prompt: typing_extensions.Required[typing.Optional[str]]
+    prompt: typing_extensions.NotRequired[typing.Optional[str]]
     """
     The prompt used for the video. Prompt is required if `prompt_type` is `custom` or `append_default`. If `prompt_type` is `default`, then the `prompt` value passed will be ignored.
     """
 
-    prompt_type: typing_extensions.Required[
+    prompt_type: typing_extensions.NotRequired[
         typing_extensions.Literal["append_default", "custom", "default"]
     ]
     """
@@ -105,7 +107,7 @@ class V1VideoToVideoCreateBodyStyle(typing_extensions.TypedDict):
     * `append_default` - Add the default recommended prompt to the end of the prompt passed in the API.
     """
 
-    version: typing_extensions.Required[
+    version: typing_extensions.NotRequired[
         typing_extensions.Literal["default", "v1", "v2"]
     ]
     """
@@ -135,6 +137,7 @@ class _SerializerV1VideoToVideoCreateBodyStyle(pydantic.BaseModel):
         "Avatar",
         "Black Spiderman",
         "Boba Fett",
+        "Bold Anime",
         "Celestial Skin",
         "Chinese Swordsmen",
         "Clay",
@@ -174,6 +177,7 @@ class _SerializerV1VideoToVideoCreateBodyStyle(pydantic.BaseModel):
         "Pixel",
         "Power Armor",
         "Power Ranger",
+        "Realistic Anime",
         "Retro Anime",
         "Retro Sci-Fi",
         "Samurai",
@@ -195,19 +199,15 @@ class _SerializerV1VideoToVideoCreateBodyStyle(pydantic.BaseModel):
     ] = pydantic.Field(
         alias="art_style",
     )
-    model: typing_extensions.Literal[
-        "Absolute Reality", "Dreamshaper", "Flat 2D Anime", "default"
-    ] = pydantic.Field(
-        alias="model",
-    )
-    prompt: typing.Optional[str] = pydantic.Field(
-        alias="prompt",
-    )
-    prompt_type: typing_extensions.Literal["append_default", "custom", "default"] = (
-        pydantic.Field(
-            alias="prompt_type",
-        )
-    )
-    version: typing_extensions.Literal["default", "v1", "v2"] = pydantic.Field(
-        alias="version",
+    model: typing.Optional[
+        typing_extensions.Literal[
+            "Absolute Reality", "Dreamshaper", "Flat 2D Anime", "default"
+        ]
+    ] = pydantic.Field(alias="model", default=None)
+    prompt: typing.Optional[str] = pydantic.Field(alias="prompt", default=None)
+    prompt_type: typing.Optional[
+        typing_extensions.Literal["append_default", "custom", "default"]
+    ] = pydantic.Field(alias="prompt_type", default=None)
+    version: typing.Optional[typing_extensions.Literal["default", "v1", "v2"]] = (
+        pydantic.Field(alias="version", default=None)
     )

{magic_hour-0.39.0.dist-info → magic_hour-0.40.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.39.0
+Version: 0.40.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -223,11 +223,21 @@ download_urls = result.downloads
 * [create](magic_hour/resources/v1/ai_talking_photo/README.md#create) - AI Talking Photo
 * [generate](magic_hour/resources/v1/ai_talking_photo/README.md#generate) - Ai Talking Photo Generate Workflow
 
+### [v1.ai_voice_generator](magic_hour/resources/v1/ai_voice_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_voice_generator/README.md#create) - AI Voice Generator
+
 ### [v1.animation](magic_hour/resources/v1/animation/README.md)
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation
 * [generate](magic_hour/resources/v1/animation/README.md#generate) - Animation Generate Workflow
 
+### [v1.audio_projects](magic_hour/resources/v1/audio_projects/README.md)
+
+* [delete](magic_hour/resources/v1/audio_projects/README.md#delete) - Delete audio
+* [get](magic_hour/resources/v1/audio_projects/README.md#get) - Get audio details
+
+
 ### [v1.auto_subtitle_generator](magic_hour/resources/v1/auto_subtitle_generator/README.md)
 
 * [create](magic_hour/resources/v1/auto_subtitle_generator/README.md#create) - Auto Subtitle Generator