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

magic_hour/resources/v1/video_to_video/README.md

@@ -2,8 +2,6 @@
 
 ## Module Functions
 
-
-
 <!-- CUSTOM DOCS START -->
 
 ### Video To Video Generate Workflow <a name="generate"></a>
@@ -79,35 +77,35 @@ res = await client.v1.video_to_video.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
+
 ### Video-to-Video <a name="create"></a>
 
 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](https://magichour.ai/products/video-to-video).
-  
 
 **API Endpoint**: `POST /v1/video-to-video`
 
 #### Parameters
 
-| Parameter | Required | Deprecated | Description | Example |
-|-----------|:--------:|:----------:|-------------|--------|
-| `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 | `{"video_file_path": "api-assets/id/1234.mp4", "video_source": "file"}` |
-| `└─ video_file_path` | ✗ | — | Required if `video_source` is `file`. This value is either - a direct URL to the video file - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).  Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.  | `"api-assets/id/1234.mp4"` |
-| `└─ video_source` | ✓ | — |  | `"file"` |
-| `└─ 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_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"` |
-| `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"` |
-| `width` | ✗ | ✓ | `width` 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` |
+| Parameter            | Required | Deprecated | Description                                                                                                                                                                                                                                                                                                                                                                                                  | Example                                                                                          |
+| -------------------- | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| `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                                                                                                                                                                                                                                                               | `{"video_file_path": "api-assets/id/1234.mp4", "video_source": "file"}`                          |
+| `└─ video_file_path` |    ✗     |     —      | Required if `video_source` is `file`. This value is either - a direct URL to the video file - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls). Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.                     | `"api-assets/id/1234.mp4"`                                                                       |
+| `└─ video_source`    |    ✓     |     —      |                                                                                                                                                                                                                                                                                                                                                                                                              | `"file"`                                                                                         |
+| `└─ 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_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"`                                                                                      |
+| `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"`                                                                         |
+| `width`              |    ✗     |     ✓      | `width` 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`                                                                                            |
 
 #### Synchronous Client
 
@@ -129,7 +127,6 @@ res = client.v1.video_to_video.create(
     fps_resolution="HALF",
     name="Video To Video video",
 )
-
 ```
 
 #### Asynchronous Client
@@ -152,15 +149,16 @@ res = await client.v1.video_to_video.create(
     fps_resolution="HALF",
     name="Video To Video video",
 )
-
 ```
 
 #### Response
 
 ##### Type
+
 [V1VideoToVideoCreateResponse](/magic_hour/types/models/v1_video_to_video_create_response.py)
 
 ##### Example
-`{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}`
-
 
+```python
+{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}
+```

magic_hour/types/models/__init__.py

@@ -11,6 +11,7 @@ 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_cloner_create_response import V1AiVoiceClonerCreateResponse
 from .v1_ai_voice_generator_create_response import V1AiVoiceGeneratorCreateResponse
 from .v1_animation_create_response import V1AnimationCreateResponse
 from .v1_audio_projects_get_response import V1AudioProjectsGetResponse
@@ -65,6 +66,7 @@ __all__ = [
     "V1AiPhotoEditorCreateResponse",
     "V1AiQrCodeGeneratorCreateResponse",
     "V1AiTalkingPhotoCreateResponse",
+    "V1AiVoiceClonerCreateResponse",
     "V1AiVoiceGeneratorCreateResponse",
     "V1AnimationCreateResponse",
     "V1AudioProjectsGetResponse",

magic_hour/types/models/v1_ai_voice_cloner_create_response.py

@@ -0,0 +1,27 @@
+import pydantic
+
+
+class V1AiVoiceClonerCreateResponse(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

@@ -68,5 +68,5 @@ class V1AudioProjectsGetResponse(pydantic.BaseModel):
         alias="type",
     )
     """
-    The type of the audio project. Possible values are VOICE_GENERATOR
+    The type of the audio project. Possible values are VOICE_GENERATOR, VOICE_CHANGER, VOICE_CLONER
     """

magic_hour/types/models/v1_video_projects_get_response.py

@@ -107,7 +107,7 @@ class V1VideoProjectsGetResponse(pydantic.BaseModel):
         alias="type",
     )
     """
-    The type of the video project. Possible values are ANIMATION, IMAGE_TO_VIDEO, VIDEO_TO_VIDEO, TEXT_TO_VIDEO, FACE_SWAP, LIP_SYNC, AUTO_SUBTITLE, TALKING_PHOTO
+    The type of the video project. Possible values are ANIMATION, IMAGE_TO_VIDEO, VIDEO_TO_VIDEO, TEXT_TO_VIDEO, FACE_SWAP, LIP_SYNC, AUTO_SUBTITLE, TALKING_PHOTO, UGC_AD
     """
     width: int = pydantic.Field(
         alias="width",

magic_hour/types/params/__init__.py

@@ -123,6 +123,19 @@ from .v1_ai_talking_photo_create_body_style import (
     _SerializerV1AiTalkingPhotoCreateBodyStyle,
 )
 from .v1_ai_talking_photo_generate_body_assets import V1AiTalkingPhotoGenerateBodyAssets
+from .v1_ai_voice_cloner_create_body import (
+    V1AiVoiceClonerCreateBody,
+    _SerializerV1AiVoiceClonerCreateBody,
+)
+from .v1_ai_voice_cloner_create_body_assets import (
+    V1AiVoiceClonerCreateBodyAssets,
+    _SerializerV1AiVoiceClonerCreateBodyAssets,
+)
+from .v1_ai_voice_cloner_create_body_style import (
+    V1AiVoiceClonerCreateBodyStyle,
+    _SerializerV1AiVoiceClonerCreateBodyStyle,
+)
+from .v1_ai_voice_cloner_generate_body_assets import V1AiVoiceClonerGenerateBodyAssets
 from .v1_ai_voice_generator_create_body import (
     V1AiVoiceGeneratorCreateBody,
     _SerializerV1AiVoiceGeneratorCreateBody,
@@ -245,6 +258,10 @@ from .v1_lip_sync_create_body_assets import (
     V1LipSyncCreateBodyAssets,
     _SerializerV1LipSyncCreateBodyAssets,
 )
+from .v1_lip_sync_create_body_style import (
+    V1LipSyncCreateBodyStyle,
+    _SerializerV1LipSyncCreateBodyStyle,
+)
 from .v1_lip_sync_generate_body_assets import V1LipSyncGenerateBodyAssets
 from .v1_photo_colorizer_create_body import (
     V1PhotoColorizerCreateBody,
@@ -314,6 +331,10 @@ __all__ = [
     "V1AiTalkingPhotoCreateBodyAssets",
     "V1AiTalkingPhotoCreateBodyStyle",
     "V1AiTalkingPhotoGenerateBodyAssets",
+    "V1AiVoiceClonerCreateBody",
+    "V1AiVoiceClonerCreateBodyAssets",
+    "V1AiVoiceClonerCreateBodyStyle",
+    "V1AiVoiceClonerGenerateBodyAssets",
     "V1AiVoiceGeneratorCreateBody",
     "V1AiVoiceGeneratorCreateBodyStyle",
     "V1AnimationCreateBody",
@@ -350,6 +371,7 @@ __all__ = [
     "V1ImageToVideoGenerateBodyAssets",
     "V1LipSyncCreateBody",
     "V1LipSyncCreateBodyAssets",
+    "V1LipSyncCreateBodyStyle",
     "V1LipSyncGenerateBodyAssets",
     "V1PhotoColorizerCreateBody",
     "V1PhotoColorizerCreateBodyAssets",
@@ -388,6 +410,9 @@ __all__ = [
     "_SerializerV1AiTalkingPhotoCreateBody",
     "_SerializerV1AiTalkingPhotoCreateBodyAssets",
     "_SerializerV1AiTalkingPhotoCreateBodyStyle",
+    "_SerializerV1AiVoiceClonerCreateBody",
+    "_SerializerV1AiVoiceClonerCreateBodyAssets",
+    "_SerializerV1AiVoiceClonerCreateBodyStyle",
     "_SerializerV1AiVoiceGeneratorCreateBody",
     "_SerializerV1AiVoiceGeneratorCreateBodyStyle",
     "_SerializerV1AnimationCreateBody",
@@ -415,6 +440,7 @@ __all__ = [
     "_SerializerV1ImageToVideoCreateBodyStyle",
     "_SerializerV1LipSyncCreateBody",
     "_SerializerV1LipSyncCreateBodyAssets",
+    "_SerializerV1LipSyncCreateBodyStyle",
     "_SerializerV1PhotoColorizerCreateBody",
     "_SerializerV1PhotoColorizerCreateBodyAssets",
     "_SerializerV1TextToVideoCreateBody",

magic_hour/types/params/v1_ai_image_editor_create_body_assets.py

@@ -1,4 +1,5 @@
 import pydantic
+import typing
 import typing_extensions
 
 
@@ -7,9 +8,19 @@ class V1AiImageEditorCreateBodyAssets(typing_extensions.TypedDict):
     Provide the assets for image edit
     """
 
-    image_file_path: typing_extensions.Required[str]
+    image_file_path: typing_extensions.NotRequired[str]
     """
-    The image used in the edit. This value is either
+    Deprecated: Please use `image_file_paths` instead as edits with multiple images are now supported. The image used in the edit. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
+    """
+
+    image_file_paths: typing_extensions.NotRequired[typing.List[str]]
+    """
+    The image(s) used in the edit, maximum of 10 images. This value is either
     - a direct URL to the video file
     - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
     
@@ -28,6 +39,9 @@ class _SerializerV1AiImageEditorCreateBodyAssets(pydantic.BaseModel):
         populate_by_name=True,
     )
 
-    image_file_path: str = pydantic.Field(
-        alias="image_file_path",
+    image_file_path: typing.Optional[str] = pydantic.Field(
+        alias="image_file_path", default=None
+    )
+    image_file_paths: typing.Optional[typing.List[str]] = pydantic.Field(
+        alias="image_file_paths", default=None
     )

magic_hour/types/params/v1_ai_image_editor_create_body_style.py

@@ -1,4 +1,5 @@
 import pydantic
+import typing
 import typing_extensions
 
 
@@ -7,6 +8,15 @@ class V1AiImageEditorCreateBodyStyle(typing_extensions.TypedDict):
     V1AiImageEditorCreateBodyStyle
     """
 
+    model: typing_extensions.NotRequired[
+        typing_extensions.Literal["Nano Banana", "Seedream", "default"]
+    ]
+    """
+    The AI model to use for image editing. * `Nano Banana` - Precise, realistic edits with consistent results
+    * `Seedream` - Creative, imaginative images with artistic freedom
+    * `default` - Use the model we recommend, which will change over time. This is recommended unless you need a specific model. This is the default behavior.
+    """
+
     prompt: typing_extensions.Required[str]
     """
     The prompt used to edit the image.
@@ -23,6 +33,9 @@ class _SerializerV1AiImageEditorCreateBodyStyle(pydantic.BaseModel):
         populate_by_name=True,
     )
 
+    model: typing.Optional[
+        typing_extensions.Literal["Nano Banana", "Seedream", "default"]
+    ] = pydantic.Field(alias="model", default=None)
     prompt: str = pydantic.Field(
         alias="prompt",
     )

magic_hour/types/params/v1_ai_image_editor_generate_body_assets.py

@@ -7,11 +7,22 @@ class V1AiImageEditorGenerateBodyAssets(typing_extensions.TypedDict):
     Provide the assets for image edit
     """
 
-    image_file_path: typing_extensions.Required[str]
+    image_file_path: typing_extensions.NotRequired[str]
     """
+    Deprecated: Please use `image_file_paths` instead as edits with multiple images are now supported.
+
     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.
     """
+
+    image_file_paths: typing_extensions.NotRequired[typing_extensions.List[str]]
+    """
+    The image(s) used in the edit, maximum of 10 images. 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_ai_image_generator_create_body_style.py

@@ -13,6 +13,19 @@ class V1AiImageGeneratorCreateBodyStyle(typing_extensions.TypedDict):
     The prompt used for the image(s).
     """
 
+    quality_mode: typing_extensions.NotRequired[
+        typing_extensions.Literal["pro", "standard"]
+    ]
+    """
+    Controls the quality of the generated image. Defaults to 'standard' if not specified.
+    
+    **Options:**
+    - `standard` - Standard quality generation. Cost: 5 credits per image.
+    - `pro` - Pro quality generation with enhanced details and quality. Cost: 30 credits per image.
+    
+    Note: Pro mode is available for users on Creator, Pro, or Business tier.
+    """
+
     tool: typing_extensions.NotRequired[
         typing_extensions.Literal[
             "ai-anime-generator",
@@ -70,6 +83,9 @@ class _SerializerV1AiImageGeneratorCreateBodyStyle(pydantic.BaseModel):
     prompt: str = pydantic.Field(
         alias="prompt",
     )
+    quality_mode: typing.Optional[typing_extensions.Literal["pro", "standard"]] = (
+        pydantic.Field(alias="quality_mode", default=None)
+    )
     tool: typing.Optional[
         typing_extensions.Literal[
             "ai-anime-generator",

magic_hour/types/params/v1_ai_talking_photo_create_body_style.py

@@ -9,12 +9,14 @@ class V1AiTalkingPhotoCreateBodyStyle(typing_extensions.TypedDict):
     """
 
     generation_mode: typing_extensions.NotRequired[
-        typing_extensions.Literal["expressive", "pro", "stable"]
+        typing_extensions.Literal["expressive", "pro", "stable", "standard"]
     ]
     """
     Controls overall motion style.
-    * `pro` -  Realistic, high fidelity, accurate lip sync, slower.
-    * `expressive` - More motion and facial expressiveness; may introduce visual artifacts.
+    * `pro` -  Higher fidelity, realistic detail, accurate lip sync, and faster generation.
+    * `standard` -  More expressive motion, but lower visual fidelity.
+    
+    * `expressive` - More motion and facial expressiveness; may introduce visual artifacts. (Deprecated: passing this value will be treated as `standard`)
     * `stable` -  Reduced motion for cleaner output; may result in minimal animation. (Deprecated: passing this value will be treated as `pro`)
     """
 
@@ -37,6 +39,6 @@ class _SerializerV1AiTalkingPhotoCreateBodyStyle(pydantic.BaseModel):
     )
 
     generation_mode: typing.Optional[
-        typing_extensions.Literal["expressive", "pro", "stable"]
+        typing_extensions.Literal["expressive", "pro", "stable", "standard"]
     ] = pydantic.Field(alias="generation_mode", default=None)
     intensity: typing.Optional[float] = pydantic.Field(alias="intensity", default=None)

magic_hour/types/params/v1_ai_voice_cloner_create_body.py

@@ -0,0 +1,49 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_voice_cloner_create_body_assets import (
+    V1AiVoiceClonerCreateBodyAssets,
+    _SerializerV1AiVoiceClonerCreateBodyAssets,
+)
+from .v1_ai_voice_cloner_create_body_style import (
+    V1AiVoiceClonerCreateBodyStyle,
+    _SerializerV1AiVoiceClonerCreateBodyStyle,
+)
+
+
+class V1AiVoiceClonerCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiVoiceClonerCreateBody
+    """
+
+    assets: typing_extensions.Required[V1AiVoiceClonerCreateBodyAssets]
+    """
+    Provide the assets for voice cloning.
+    """
+
+    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[V1AiVoiceClonerCreateBodyStyle]
+
+
+class _SerializerV1AiVoiceClonerCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1AiVoiceClonerCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerV1AiVoiceClonerCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour/types/params/v1_ai_voice_cloner_create_body_assets.py

@@ -0,0 +1,33 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceClonerCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for voice cloning.
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio used to clone the voice. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
+    """
+
+
+class _SerializerV1AiVoiceClonerCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: str = pydantic.Field(
+        alias="audio_file_path",
+    )

magic_hour/types/params/v1_ai_voice_cloner_create_body_style.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceClonerCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    V1AiVoiceClonerCreateBodyStyle
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    Text used to generate speech from the cloned voice. The character limit is 1000 characters.
+    """
+
+
+class _SerializerV1AiVoiceClonerCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerCreateBodyStyle 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",
+    )

magic_hour/types/params/v1_ai_voice_cloner_generate_body_assets.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceClonerGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for voice cloning.
+    """
+
+    audio_file_path: typing_extensions.Required[str]
+    """
+    The audio used to clone the voice. This can be a local file path or URL.
+    """
+
+
+class _SerializerV1AiVoiceClonerGenerateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceClonerGenerateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    audio_file_path: str = pydantic.Field(
+        alias="audio_file_path",
+    )