magic_hour 0.26.1__tar.gz → 0.28.0__tar.gz

{magic_hour-0.26.1 → magic_hour-0.28.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.26.1
+Version: 0.28.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -107,6 +107,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation
 
+### [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
+
 ### [v1.face_swap](magic_hour/resources/v1/face_swap/README.md)
 
 * [create](magic_hour/resources/v1/face_swap/README.md#create) - Face Swap video

{magic_hour-0.26.1 → magic_hour-0.28.0}/README.md

@@ -89,6 +89,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation
 
+### [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
+
 ### [v1.face_swap](magic_hour/resources/v1/face_swap/README.md)
 
 * [create](magic_hour/resources/v1/face_swap/README.md#create) - Face Swap video

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/environment.py

@@ -6,7 +6,7 @@ class Environment(enum.Enum):
     """Pre-defined base URLs for the API"""
 
     ENVIRONMENT = "https://api.magichour.ai"
-    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.26.1"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.28.0"
 
 
 def _get_base_url(

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/resources/v1/ai_talking_photo/README.md

@@ -10,8 +10,8 @@ Create a talking photo from an image and audio or text input.
 | Parameter | Required | Description | Example |
 |-----------|:--------:|-------------|--------|
 | `assets` | ✓ | Provide the assets for creating a talking photo | `{"audio_file_path": "api-assets/id/1234.mp3", "image_file_path": "api-assets/id/1234.png"}` |
-| `end_seconds` | ✓ | The end time of the input audio in seconds. The maximum duration allowed is 30 seconds. | `15.0` |
-| `start_seconds` | ✓ | The start time of the input audio in seconds. The maximum duration allowed is 30 seconds. | `0.0` |
+| `end_seconds` | ✓ | The end time of the input audio in seconds. The maximum duration allowed is 60 seconds. | `15.0` |
+| `start_seconds` | ✓ | The start time of the input audio in seconds. The maximum duration allowed is 60 seconds. | `0.0` |
 | `name` | ✗ | The name of image | `"Talking Photo image"` |
 | `style` | ✗ | Attributes used to dictate the style of the output | `{"generation_mode": "expressive", "intensity": 1.5}` |
 

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/resources/v1/ai_talking_photo/client.py

@@ -40,8 +40,8 @@ class AiTalkingPhotoClient:
             name: The name of image
             style: Attributes used to dictate the style of the output
             assets: Provide the assets for creating a talking photo
-            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
-            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -113,8 +113,8 @@ class AsyncAiTalkingPhotoClient:
             name: The name of image
             style: Attributes used to dictate the style of the output
             assets: Provide the assets for creating a talking photo
-            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
-            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+            end_seconds: The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
             request_options: Additional options to customize the HTTP request
 
         Returns:

magic_hour-0.28.0/magic_hour/resources/v1/auto_subtitle_generator/README.md

@@ -0,0 +1,58 @@
+
+### Auto Subtitle Generator <a name="create"></a>
+
+Automatically generate subtitles for your video in multiple languages.
+
+**API Endpoint**: `POST /v1/auto-subtitle-generator`
+
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `assets` | ✓ | Provide the assets for auto subtitle generator | `{"video_file_path": "api-assets/id/1234.mp4"}` |
+| `end_seconds` | ✓ | The end time of the input video in seconds | `15.0` |
+| `start_seconds` | ✓ | The start time of the input video in seconds | `0.0` |
+| `style` | ✓ | Style of the subtitle. At least one of `.style.template` or `.style.custom_config` must be provided.  * If only `.style.template` is provided, default values for the template will be used. * If both are provided, the fields in `.style.custom_config` will be used to overwrite the fields in `.style.template`. * If only `.style.custom_config` is provided, then all fields in `.style.custom_config` will be used.  To use custom config only, the following `custom_config` params are required: * `.style.custom_config.font` * `.style.custom_config.text_color` * `.style.custom_config.vertical_position` * `.style.custom_config.horizontal_position`  | `{}` |
+| `name` | ✗ | The name of video | `"Auto Subtitle video"` |
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.auto_subtitle_generator.create(
+    assets={"video_file_path": "api-assets/id/1234.mp4"},
+    end_seconds=15.0,
+    start_seconds=0.0,
+    style={},
+    name="Auto Subtitle video",
+)
+
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.auto_subtitle_generator.create(
+    assets={"video_file_path": "api-assets/id/1234.mp4"},
+    end_seconds=15.0,
+    start_seconds=0.0,
+    style={},
+    name="Auto Subtitle video",
+)
+
+```
+
+#### Response
+
+##### Type
+[V1AutoSubtitleGeneratorCreateResponse](/magic_hour/types/models/v1_auto_subtitle_generator_create_response.py)
+
+##### Example
+`{"credits_charged": 450, "estimated_frame_cost": 450, "id": "clx7uu86w0a5qp55yxz315r6r"}`

magic_hour-0.28.0/magic_hour/resources/v1/auto_subtitle_generator/__init__.py

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

magic_hour-0.28.0/magic_hour/resources/v1/auto_subtitle_generator/client.py

@@ -0,0 +1,169 @@
+import typing
+
+from magic_hour.core import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+    to_encodable,
+    type_utils,
+)
+from magic_hour.types import models, params
+
+
+class AutoSubtitleGeneratorClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        assets: params.V1AutoSubtitleGeneratorCreateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        style: params.V1AutoSubtitleGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AutoSubtitleGeneratorCreateResponse:
+        """
+        Auto Subtitle Generator
+
+        Automatically generate subtitles for your video in multiple languages.
+
+        POST /v1/auto-subtitle-generator
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for auto subtitle generator
+            end_seconds: The end time of the input video in seconds
+            start_seconds: The start time of the input video in seconds
+            style: Style of the subtitle. At least one of `.style.template` or `.style.custom_config` must be provided.
+        * If only `.style.template` is provided, default values for the template will be used.
+        * If both are provided, the fields in `.style.custom_config` will be used to overwrite the fields in `.style.template`.
+        * If only `.style.custom_config` is provided, then all fields in `.style.custom_config` will be used.
+
+        To use custom config only, the following `custom_config` params are required:
+        * `.style.custom_config.font`
+        * `.style.custom_config.text_color`
+        * `.style.custom_config.vertical_position`
+        * `.style.custom_config.horizontal_position`
+
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        client.v1.auto_subtitle_generator.create(
+            assets={"video_file_path": "api-assets/id/1234.mp4"},
+            end_seconds=15.0,
+            start_seconds=0.0,
+            style={},
+            name="Auto Subtitle video",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "start_seconds": start_seconds,
+                "style": style,
+            },
+            dump_with=params._SerializerV1AutoSubtitleGeneratorCreateBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/auto-subtitle-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AutoSubtitleGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAutoSubtitleGeneratorClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        assets: params.V1AutoSubtitleGeneratorCreateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        style: params.V1AutoSubtitleGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AutoSubtitleGeneratorCreateResponse:
+        """
+        Auto Subtitle Generator
+
+        Automatically generate subtitles for your video in multiple languages.
+
+        POST /v1/auto-subtitle-generator
+
+        Args:
+            name: The name of video
+            assets: Provide the assets for auto subtitle generator
+            end_seconds: The end time of the input video in seconds
+            start_seconds: The start time of the input video in seconds
+            style: Style of the subtitle. At least one of `.style.template` or `.style.custom_config` must be provided.
+        * If only `.style.template` is provided, default values for the template will be used.
+        * If both are provided, the fields in `.style.custom_config` will be used to overwrite the fields in `.style.template`.
+        * If only `.style.custom_config` is provided, then all fields in `.style.custom_config` will be used.
+
+        To use custom config only, the following `custom_config` params are required:
+        * `.style.custom_config.font`
+        * `.style.custom_config.text_color`
+        * `.style.custom_config.vertical_position`
+        * `.style.custom_config.horizontal_position`
+
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        await client.v1.auto_subtitle_generator.create(
+            assets={"video_file_path": "api-assets/id/1234.mp4"},
+            end_seconds=15.0,
+            start_seconds=0.0,
+            style={},
+            name="Auto Subtitle video",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={
+                "name": name,
+                "assets": assets,
+                "end_seconds": end_seconds,
+                "start_seconds": start_seconds,
+                "style": style,
+            },
+            dump_with=params._SerializerV1AutoSubtitleGeneratorCreateBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/auto-subtitle-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AutoSubtitleGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/resources/v1/client.py

@@ -44,6 +44,10 @@ from magic_hour.resources.v1.ai_talking_photo import (
     AsyncAiTalkingPhotoClient,
 )
 from magic_hour.resources.v1.animation import AnimationClient, AsyncAnimationClient
+from magic_hour.resources.v1.auto_subtitle_generator import (
+    AsyncAutoSubtitleGeneratorClient,
+    AutoSubtitleGeneratorClient,
+)
 from magic_hour.resources.v1.face_swap import AsyncFaceSwapClient, FaceSwapClient
 from magic_hour.resources.v1.face_swap_photo import (
     AsyncFaceSwapPhotoClient,
@@ -102,6 +106,9 @@ class V1Client:
         )
         self.ai_talking_photo = AiTalkingPhotoClient(base_client=self._base_client)
         self.animation = AnimationClient(base_client=self._base_client)
+        self.auto_subtitle_generator = AutoSubtitleGeneratorClient(
+            base_client=self._base_client
+        )
         self.face_swap = FaceSwapClient(base_client=self._base_client)
         self.face_swap_photo = FaceSwapPhotoClient(base_client=self._base_client)
         self.files = FilesClient(base_client=self._base_client)
@@ -144,6 +151,9 @@ class AsyncV1Client:
         )
         self.ai_talking_photo = AsyncAiTalkingPhotoClient(base_client=self._base_client)
         self.animation = AsyncAnimationClient(base_client=self._base_client)
+        self.auto_subtitle_generator = AsyncAutoSubtitleGeneratorClient(
+            base_client=self._base_client
+        )
         self.face_swap = AsyncFaceSwapClient(base_client=self._base_client)
         self.face_swap_photo = AsyncFaceSwapPhotoClient(base_client=self._base_client)
         self.files = AsyncFilesClient(base_client=self._base_client)

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/types/models/__init__.py

@@ -12,6 +12,9 @@ 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_animation_create_response import V1AnimationCreateResponse
+from .v1_auto_subtitle_generator_create_response import (
+    V1AutoSubtitleGeneratorCreateResponse,
+)
 from .v1_face_swap_create_response import V1FaceSwapCreateResponse
 from .v1_face_swap_photo_create_response import V1FaceSwapPhotoCreateResponse
 from .v1_files_upload_urls_create_response import V1FilesUploadUrlsCreateResponse
@@ -52,6 +55,7 @@ __all__ = [
     "V1AiQrCodeGeneratorCreateResponse",
     "V1AiTalkingPhotoCreateResponse",
     "V1AnimationCreateResponse",
+    "V1AutoSubtitleGeneratorCreateResponse",
     "V1FaceSwapCreateResponse",
     "V1FaceSwapPhotoCreateResponse",
     "V1FilesUploadUrlsCreateResponse",

magic_hour-0.28.0/magic_hour/types/models/v1_auto_subtitle_generator_create_response.py

@@ -0,0 +1,35 @@
+import pydantic
+
+
+class V1AutoSubtitleGeneratorCreateResponse(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 video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. 
+    
+    If video generation fails, credits will be refunded, and this field will be updated to include the refund.
+    """
+    estimated_frame_cost: int = pydantic.Field(
+        alias="estimated_frame_cost",
+    )
+    """
+    Deprecated: Previously represented the number of frames (original name of our credit system) used for video generation. Use 'credits_charged' instead.
+    
+    The amount of frames used to generate the video. If the status is not 'complete', the cost is an estimate and will be adjusted when the video completes.
+    """
+    id: str = pydantic.Field(
+        alias="id",
+    )
+    """
+    Unique ID of the video. This value can be used in the [get video project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch additional details such as status
+    """

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/types/params/__init__.py

@@ -122,6 +122,22 @@ from .v1_animation_create_body_style import (
     V1AnimationCreateBodyStyle,
     _SerializerV1AnimationCreateBodyStyle,
 )
+from .v1_auto_subtitle_generator_create_body import (
+    V1AutoSubtitleGeneratorCreateBody,
+    _SerializerV1AutoSubtitleGeneratorCreateBody,
+)
+from .v1_auto_subtitle_generator_create_body_assets import (
+    V1AutoSubtitleGeneratorCreateBodyAssets,
+    _SerializerV1AutoSubtitleGeneratorCreateBodyAssets,
+)
+from .v1_auto_subtitle_generator_create_body_style import (
+    V1AutoSubtitleGeneratorCreateBodyStyle,
+    _SerializerV1AutoSubtitleGeneratorCreateBodyStyle,
+)
+from .v1_auto_subtitle_generator_create_body_style_custom_config import (
+    V1AutoSubtitleGeneratorCreateBodyStyleCustomConfig,
+    _SerializerV1AutoSubtitleGeneratorCreateBodyStyleCustomConfig,
+)
 from .v1_face_swap_create_body import (
     V1FaceSwapCreateBody,
     _SerializerV1FaceSwapCreateBody,
@@ -233,6 +249,10 @@ __all__ = [
     "V1AnimationCreateBody",
     "V1AnimationCreateBodyAssets",
     "V1AnimationCreateBodyStyle",
+    "V1AutoSubtitleGeneratorCreateBody",
+    "V1AutoSubtitleGeneratorCreateBodyAssets",
+    "V1AutoSubtitleGeneratorCreateBodyStyle",
+    "V1AutoSubtitleGeneratorCreateBodyStyleCustomConfig",
     "V1FaceSwapCreateBody",
     "V1FaceSwapCreateBodyAssets",
     "V1FaceSwapPhotoCreateBody",
@@ -284,6 +304,10 @@ __all__ = [
     "_SerializerV1AnimationCreateBody",
     "_SerializerV1AnimationCreateBodyAssets",
     "_SerializerV1AnimationCreateBodyStyle",
+    "_SerializerV1AutoSubtitleGeneratorCreateBody",
+    "_SerializerV1AutoSubtitleGeneratorCreateBodyAssets",
+    "_SerializerV1AutoSubtitleGeneratorCreateBodyStyle",
+    "_SerializerV1AutoSubtitleGeneratorCreateBodyStyleCustomConfig",
     "_SerializerV1FaceSwapCreateBody",
     "_SerializerV1FaceSwapCreateBodyAssets",
     "_SerializerV1FaceSwapPhotoCreateBody",

{magic_hour-0.26.1 → magic_hour-0.28.0}/magic_hour/types/params/v1_ai_talking_photo_create_body.py

@@ -24,7 +24,7 @@ class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
 
     end_seconds: typing_extensions.Required[float]
     """
-    The end time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+    The end time of the input audio in seconds. The maximum duration allowed is 60 seconds.
     """
 
     name: typing_extensions.NotRequired[str]
@@ -34,7 +34,7 @@ class V1AiTalkingPhotoCreateBody(typing_extensions.TypedDict):
 
     start_seconds: typing_extensions.Required[float]
     """
-    The start time of the input audio in seconds. The maximum duration allowed is 30 seconds.
+    The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
     """
 
     style: typing_extensions.NotRequired[V1AiTalkingPhotoCreateBodyStyle]

magic_hour-0.28.0/magic_hour/types/params/v1_auto_subtitle_generator_create_body.py

@@ -0,0 +1,78 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_auto_subtitle_generator_create_body_assets import (
+    V1AutoSubtitleGeneratorCreateBodyAssets,
+    _SerializerV1AutoSubtitleGeneratorCreateBodyAssets,
+)
+from .v1_auto_subtitle_generator_create_body_style import (
+    V1AutoSubtitleGeneratorCreateBodyStyle,
+    _SerializerV1AutoSubtitleGeneratorCreateBodyStyle,
+)
+
+
+class V1AutoSubtitleGeneratorCreateBody(typing_extensions.TypedDict):
+    """
+    V1AutoSubtitleGeneratorCreateBody
+    """
+
+    assets: typing_extensions.Required[V1AutoSubtitleGeneratorCreateBodyAssets]
+    """
+    Provide the assets for auto subtitle generator
+    """
+
+    end_seconds: typing_extensions.Required[float]
+    """
+    The end time of the input video in seconds
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of video
+    """
+
+    start_seconds: typing_extensions.Required[float]
+    """
+    The start time of the input video in seconds
+    """
+
+    style: typing_extensions.Required[V1AutoSubtitleGeneratorCreateBodyStyle]
+    """
+    Style of the subtitle. At least one of `.style.template` or `.style.custom_config` must be provided. 
+    * If only `.style.template` is provided, default values for the template will be used.
+    * If both are provided, the fields in `.style.custom_config` will be used to overwrite the fields in `.style.template`.
+    * If only `.style.custom_config` is provided, then all fields in `.style.custom_config` will be used.
+    
+    To use custom config only, the following `custom_config` params are required:
+    * `.style.custom_config.font`
+    * `.style.custom_config.text_color`
+    * `.style.custom_config.vertical_position`
+    * `.style.custom_config.horizontal_position`
+    
+    """
+
+
+class _SerializerV1AutoSubtitleGeneratorCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AutoSubtitleGeneratorCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1AutoSubtitleGeneratorCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    end_seconds: float = pydantic.Field(
+        alias="end_seconds",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    start_seconds: float = pydantic.Field(
+        alias="start_seconds",
+    )
+    style: _SerializerV1AutoSubtitleGeneratorCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour-0.28.0/magic_hour/types/params/v1_auto_subtitle_generator_create_body_assets.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AutoSubtitleGeneratorCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for auto subtitle generator
+    """
+
+    video_file_path: typing_extensions.Required[str]
+    """
+    This is the video used to add subtitles. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    """
+
+
+class _SerializerV1AutoSubtitleGeneratorCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AutoSubtitleGeneratorCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    video_file_path: str = pydantic.Field(
+        alias="video_file_path",
+    )

magic_hour-0.28.0/magic_hour/types/params/v1_auto_subtitle_generator_create_body_style.py

@@ -0,0 +1,56 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_auto_subtitle_generator_create_body_style_custom_config import (
+    V1AutoSubtitleGeneratorCreateBodyStyleCustomConfig,
+    _SerializerV1AutoSubtitleGeneratorCreateBodyStyleCustomConfig,
+)
+
+
+class V1AutoSubtitleGeneratorCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    Style of the subtitle. At least one of `.style.template` or `.style.custom_config` must be provided.
+    * If only `.style.template` is provided, default values for the template will be used.
+    * If both are provided, the fields in `.style.custom_config` will be used to overwrite the fields in `.style.template`.
+    * If only `.style.custom_config` is provided, then all fields in `.style.custom_config` will be used.
+
+    To use custom config only, the following `custom_config` params are required:
+    * `.style.custom_config.font`
+    * `.style.custom_config.text_color`
+    * `.style.custom_config.vertical_position`
+    * `.style.custom_config.horizontal_position`
+
+    """
+
+    custom_config: typing_extensions.NotRequired[
+        V1AutoSubtitleGeneratorCreateBodyStyleCustomConfig
+    ]
+    """
+    Custom subtitle configuration.
+    """
+
+    template: typing_extensions.NotRequired[
+        typing_extensions.Literal["cinematic", "highlight", "karaoke", "minimalist"]
+    ]
+    """
+    Preset subtitle templates. Please visit https://magichour.ai/create/auto-subtitle-generator to see the style of the existing templates.
+    """
+
+
+class _SerializerV1AutoSubtitleGeneratorCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AutoSubtitleGeneratorCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    custom_config: typing.Optional[
+        _SerializerV1AutoSubtitleGeneratorCreateBodyStyleCustomConfig
+    ] = pydantic.Field(alias="custom_config", default=None)
+    template: typing.Optional[
+        typing_extensions.Literal["cinematic", "highlight", "karaoke", "minimalist"]
+    ] = pydantic.Field(alias="template", default=None)