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

magic_hour/resources/v1/ai_talking_photo/client.py

@@ -1,3 +1,4 @@
+import logging
 import typing
 
 from magic_hour.core import (
@@ -8,13 +9,102 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
+from magic_hour.resources.v1.files.client import AsyncFilesClient, FilesClient
+from magic_hour.resources.v1.video_projects.client import (
+    AsyncVideoProjectsClient,
+    VideoProjectsClient,
+)
 from magic_hour.types import models, params
 
 
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+
 class AiTalkingPhotoClient:
     def __init__(self, *, base_client: SyncBaseClient):
         self._base_client = base_client
 
+    def generate(
+        self,
+        *,
+        assets: params.V1AiTalkingPhotoGenerateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1AiTalkingPhotoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        wait_for_completion: bool = True,
+        download_outputs: bool = True,
+        download_directory: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ):
+        """
+        Generate talking photo (alias for create with additional functionality).
+
+        Create a talking photo from an image and audio or text input. Each generation costs credits.
+
+        Args:
+            name: The name of image. This value is mainly used for your own identification of the 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 60 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+            wait_for_completion: Whether to wait for the video project to complete
+            download_outputs: Whether to download the outputs
+            download_directory: The directory to download the outputs to. If not provided, the outputs will be downloaded to the current working directory
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            V1VideoProjectsGetResponseWithDownloads: The response from the AI Talking Photo API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = client.v1.ai_talking_photo.generate(
+            assets={
+                "audio_file_path": "path/to/audio.mp3",
+                "image_file_path": "path/to/image.png",
+            },
+            end_seconds=30.0,
+            start_seconds=5.0,
+            style={"enhancement": "high"},
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = FilesClient(base_client=self._base_client)
+
+        audio_file_path = assets["audio_file_path"]
+        image_file_path = assets["image_file_path"]
+        assets["audio_file_path"] = file_client.upload_file(file=audio_file_path)
+        assets["image_file_path"] = file_client.upload_file(file=image_file_path)
+
+        create_response = self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            start_seconds=start_seconds,
+            name=name,
+            style=style,
+            request_options=request_options,
+        )
+        logger.info(f"AI Talking Photo response: {create_response}")
+
+        video_projects_client = VideoProjectsClient(base_client=self._base_client)
+        response = video_projects_client.check_result(
+            id=create_response.id,
+            wait_for_completion=wait_for_completion,
+            download_outputs=download_outputs,
+            download_directory=download_directory,
+        )
+
+        return response
+
     def create(
         self,
         *,
@@ -88,6 +178,86 @@ class AsyncAiTalkingPhotoClient:
     def __init__(self, *, base_client: AsyncBaseClient):
         self._base_client = base_client
 
+    async def generate(
+        self,
+        *,
+        assets: params.V1AiTalkingPhotoGenerateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1AiTalkingPhotoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        wait_for_completion: bool = True,
+        download_outputs: bool = True,
+        download_directory: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ):
+        """
+        Generate talking photo (alias for create with additional functionality).
+
+        Create a talking photo from an image and audio or text input. Each generation costs credits.
+
+        Args:
+            name: The name of image. This value is mainly used for your own identification of the 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 60 seconds.
+            start_seconds: The start time of the input audio in seconds. The maximum duration allowed is 60 seconds.
+            wait_for_completion: Whether to wait for the video project to complete
+            download_outputs: Whether to download the outputs
+            download_directory: The directory to download the outputs to. If not provided, the outputs will be downloaded to the current working directory
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            V1VideoProjectsGetResponseWithDownloads: The response from the AI Talking Photo API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = await client.v1.ai_talking_photo.generate(
+            assets={
+                "audio_file_path": "path/to/audio.mp3",
+                "image_file_path": "path/to/image.png",
+            },
+            end_seconds=30.0,
+            start_seconds=5.0,
+            style={"enhancement": "high"},
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = AsyncFilesClient(base_client=self._base_client)
+
+        audio_file_path = assets["audio_file_path"]
+        image_file_path = assets["image_file_path"]
+        assets["audio_file_path"] = await file_client.upload_file(file=audio_file_path)
+        assets["image_file_path"] = await file_client.upload_file(file=image_file_path)
+
+        create_response = await self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            start_seconds=start_seconds,
+            name=name,
+            style=style,
+            request_options=request_options,
+        )
+        logger.info(f"AI Talking Photo response: {create_response}")
+
+        video_projects_client = AsyncVideoProjectsClient(base_client=self._base_client)
+        response = await video_projects_client.check_result(
+            id=create_response.id,
+            wait_for_completion=wait_for_completion,
+            download_outputs=download_outputs,
+            download_directory=download_directory,
+        )
+
+        return response
+
     async def create(
         self,
         *,

magic_hour/resources/v1/animation/README.md

@@ -1,3 +1,92 @@
+# v1_animation
+
+## Module Functions
+
+<!-- CUSTOM DOCS START -->
+
+### Animation Generate Workflow <a name="generate"></a>
+
+The workflow performs the following action
+
+1. upload local assets to Magic Hour storage. So you can pass in a local path instead of having to upload files yourself
+2. trigger a generation
+3. poll for a completion status. This is configurable
+4. if success, download the output to local directory
+
+> [!TIP]
+> This is the recommended way to use the SDK unless you have specific needs where it is necessary to split up the actions.
+
+#### Parameters
+
+In Additional to the parameters listed in the `.create` section below, `.generate` introduces 3 new parameters:
+
+- `wait_for_completion` (bool, default True): Whether to wait for the project to complete.
+- `download_outputs` (bool, default True): Whether to download the generated files
+- `download_directory` (str, optional): Directory to save downloaded files (defaults to current directory)
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.animation.generate(
+    assets={
+        "audio_file_path": "/path/to/1234.mp3",
+        "audio_source": "file",
+        "image_file_path": "/path/to/1234.png",
+    },
+    end_seconds=15.0,
+    fps=12.0,
+    height=960,
+    style={
+        "art_style": "Painterly Illustration",
+        "camera_effect": "Simple Zoom In",
+        "prompt": "Cyberpunk city",
+        "prompt_type": "custom",
+        "transition_speed": 5,
+    },
+    width=512,
+    name="Animation video",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs"
+)
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.animation.generate(
+    assets={
+        "audio_file_path": "/path/to/1234.mp3",
+        "audio_source": "file",
+        "image_file_path": "/path/to/1234.png",
+    },
+    end_seconds=15.0,
+    fps=12.0,
+    height=960,
+    style={
+        "art_style": "Painterly Illustration",
+        "camera_effect": "Simple Zoom In",
+        "prompt": "Cyberpunk city",
+        "prompt_type": "custom",
+        "transition_speed": 5,
+    },
+    width=512,
+    name="Animation video",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs"
+)
+```
+
+<!-- CUSTOM DOCS END -->
 
 ### Animation <a name="create"></a>
 
@@ -10,10 +99,20 @@ Create a Animation video. The estimated frame cost is calculated based on the `f
 | Parameter | Required | Description | Example |
 |-----------|:--------:|-------------|--------|
 | `assets` | ✓ | Provide the assets for animation. | `{"audio_file_path": "api-assets/id/1234.mp3", "audio_source": "file", "image_file_path": "api-assets/id/1234.png"}` |
+| `└─ audio_file_path` | ✗ | The path of the input audio. This field is required if `audio_source` is `file`. This value is either - a direct URL to the video file - `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.mp3"` |
+| `└─ audio_source` | ✓ | Optionally add an audio source if you'd like to incorporate audio into your video | `"file"` |
+| `└─ image_file_path` | ✗ | An initial image to use a the first frame of the video. 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.png"` |
+| `└─ youtube_url` | ✗ | Using a youtube video as the input source. This field is required if `audio_source` is `youtube` | `"http://www.example.com"` |
 | `end_seconds` | ✓ | This value determines the duration of the output video. | `15.0` |
 | `fps` | ✓ | The desire output video frame rate | `12.0` |
 | `height` | ✓ | 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 | `960` |
 | `style` | ✓ | Defines the style of the output video | `{"art_style": "Painterly Illustration", "camera_effect": "Simple Zoom In", "prompt": "Cyberpunk city", "prompt_type": "custom", "transition_speed": 5}` |
+| `└─ art_style` | ✓ | The art style used to create the output video | `"Painterly Illustration"` |
+| `└─ art_style_custom` | ✗ | Describe custom art style. This field is required if `art_style` is `Custom` | `"string"` |
+| `└─ camera_effect` | ✓ | The camera effect used to create the output video | `"Simple Zoom In"` |
+| `└─ prompt` | ✗ | The prompt used for the video. Prompt is required if `prompt_type` is `custom`. Otherwise this value is ignored | `"Cyberpunk city"` |
+| `└─ prompt_type` | ✓ |  * `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`. | `"custom"` |
+| `└─ transition_speed` | ✓ | Change determines how quickly the video's content changes across frames.  * Higher = more rapid transitions. * Lower = more stable visual experience. | `5` |
 | `width` | ✓ | 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 | `512` |
 | `name` | ✗ | The name of video. This value is mainly used for your own identification of the video. | `"Animation video"` |
 
@@ -82,3 +181,4 @@ res = await client.v1.animation.create(
 
 ##### Example
 `{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}`
+

magic_hour/resources/v1/animation/client.py

@@ -1,3 +1,4 @@
+import logging
 import typing
 
 from magic_hour.core import (
@@ -8,13 +9,124 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
+from magic_hour.resources.v1.files.client import AsyncFilesClient, FilesClient
+from magic_hour.resources.v1.video_projects.client import (
+    AsyncVideoProjectsClient,
+    VideoProjectsClient,
+)
 from magic_hour.types import models, params
 
 
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+
 class AnimationClient:
     def __init__(self, *, base_client: SyncBaseClient):
         self._base_client = base_client
 
+    def generate(
+        self,
+        *,
+        assets: params.V1AnimationGenerateBodyAssets,
+        end_seconds: float,
+        fps: float,
+        height: int,
+        style: params.V1AnimationCreateBodyStyle,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        wait_for_completion: bool = True,
+        download_outputs: bool = True,
+        download_directory: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ):
+        """
+        Generate animation (alias for create with additional functionality).
+
+        Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
+
+        Args:
+            name: The name of video. This value is mainly used for your own identification of the video.
+            assets: Provide the assets for animation.
+            end_seconds: This value determines the duration of the output video.
+            fps: The desire output video frame rate
+            height: 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
+            style: Defines the style of the output video
+            width: 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
+            wait_for_completion: Whether to wait for the video project to complete
+            download_outputs: Whether to download the outputs
+            download_directory: The directory to download the outputs to. If not provided, the outputs will be downloaded to the current working directory
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            V1VideoProjectsGetResponseWithDownloads: The response from the Animation API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = client.v1.animation.generate(
+            assets={
+                "audio_file_path": "path/to/audio.mp3",
+                "audio_source": "file",
+                "image_file_path": "path/to/image.png",
+            },
+            end_seconds=15.0,
+            fps=12.0,
+            height=960,
+            style={
+                "art_style": "Painterly Illustration",
+                "camera_effect": "Simple Zoom In",
+                "prompt": "Cyberpunk city",
+                "prompt_type": "custom",
+                "transition_speed": 5,
+            },
+            width=512,
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = FilesClient(base_client=self._base_client)
+
+        # Upload image file if provided
+        if "image_file_path" in assets and assets["image_file_path"]:
+            image_file_path = assets["image_file_path"]
+            assets["image_file_path"] = file_client.upload_file(file=image_file_path)
+
+        # Upload audio file if audio_source is "file" and audio_file_path is provided
+        if (
+            assets.get("audio_source") == "file"
+            and "audio_file_path" in assets
+            and assets["audio_file_path"]
+        ):
+            audio_file_path = assets["audio_file_path"]
+            assets["audio_file_path"] = file_client.upload_file(file=audio_file_path)
+
+        create_response = self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            fps=fps,
+            height=height,
+            style=style,
+            width=width,
+            name=name,
+            request_options=request_options,
+        )
+        logger.info(f"Animation response: {create_response}")
+
+        video_projects_client = VideoProjectsClient(base_client=self._base_client)
+        response = video_projects_client.check_result(
+            id=create_response.id,
+            wait_for_completion=wait_for_completion,
+            download_outputs=download_outputs,
+            download_directory=download_directory,
+        )
+
+        return response
+
     def create(
         self,
         *,
@@ -102,6 +214,112 @@ class AsyncAnimationClient:
     def __init__(self, *, base_client: AsyncBaseClient):
         self._base_client = base_client
 
+    async def generate(
+        self,
+        *,
+        assets: params.V1AnimationGenerateBodyAssets,
+        end_seconds: float,
+        fps: float,
+        height: int,
+        style: params.V1AnimationCreateBodyStyle,
+        width: int,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        wait_for_completion: bool = True,
+        download_outputs: bool = True,
+        download_directory: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ):
+        """
+        Generate animation (alias for create with additional functionality).
+
+        Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
+
+        Args:
+            name: The name of video. This value is mainly used for your own identification of the video.
+            assets: Provide the assets for animation.
+            end_seconds: This value determines the duration of the output video.
+            fps: The desire output video frame rate
+            height: 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
+            style: Defines the style of the output video
+            width: 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
+            wait_for_completion: Whether to wait for the video project to complete
+            download_outputs: Whether to download the outputs
+            download_directory: The directory to download the outputs to. If not provided, the outputs will be downloaded to the current working directory
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            V1VideoProjectsGetResponseWithDownloads: The response from the Animation API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = await client.v1.animation.generate(
+            assets={
+                "audio_file_path": "path/to/audio.mp3",
+                "audio_source": "file",
+                "image_file_path": "path/to/image.png",
+            },
+            end_seconds=15.0,
+            fps=12.0,
+            height=960,
+            style={
+                "art_style": "Painterly Illustration",
+                "camera_effect": "Simple Zoom In",
+                "prompt": "Cyberpunk city",
+                "prompt_type": "custom",
+                "transition_speed": 5,
+            },
+            width=512,
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = AsyncFilesClient(base_client=self._base_client)
+
+        # Upload image file if provided
+        if "image_file_path" in assets and assets["image_file_path"]:
+            image_file_path = assets["image_file_path"]
+            assets["image_file_path"] = await file_client.upload_file(
+                file=image_file_path
+            )
+
+        # Upload audio file if audio_source is "file" and audio_file_path is provided
+        if (
+            assets.get("audio_source") == "file"
+            and "audio_file_path" in assets
+            and assets["audio_file_path"]
+        ):
+            audio_file_path = assets["audio_file_path"]
+            assets["audio_file_path"] = await file_client.upload_file(
+                file=audio_file_path
+            )
+
+        create_response = await self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            fps=fps,
+            height=height,
+            style=style,
+            width=width,
+            name=name,
+            request_options=request_options,
+        )
+        logger.info(f"Animation response: {create_response}")
+
+        video_projects_client = AsyncVideoProjectsClient(base_client=self._base_client)
+        response = await video_projects_client.check_result(
+            id=create_response.id,
+            wait_for_completion=wait_for_completion,
+            download_outputs=download_outputs,
+            download_directory=download_directory,
+        )
+
+        return response
+
     async def create(
         self,
         *,

magic_hour/resources/v1/auto_subtitle_generator/README.md

@@ -1,3 +1,68 @@
+# v1_auto_subtitle_generator
+
+## Module Functions
+
+<!-- CUSTOM DOCS START -->
+
+### Auto Subtitle Generator Generate Workflow <a name="generate"></a>
+
+The workflow performs the following action
+
+1. upload local assets to Magic Hour storage. So you can pass in a local path instead of having to upload files yourself
+2. trigger a generation
+3. poll for a completion status. This is configurable
+4. if success, download the output to local directory
+
+> [!TIP]
+> This is the recommended way to use the SDK unless you have specific needs where it is necessary to split up the actions.
+
+#### Parameters
+
+In Additional to the parameters listed in the `.create` section below, `.generate` introduces 3 new parameters:
+
+- `wait_for_completion` (bool, default True): Whether to wait for the project to complete.
+- `download_outputs` (bool, default True): Whether to download the generated files
+- `download_directory` (str, optional): Directory to save downloaded files (defaults to current directory)
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.auto_subtitle_generator.generate(
+    assets={"video_file_path": "/path/to/1234.mp4"},
+    end_seconds=15.0,
+    start_seconds=0.0,
+    style={},
+    name="Auto Subtitle video",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs"
+)
+```
+
+#### 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.generate(
+    assets={"video_file_path": "/path/to/1234.mp4"},
+    end_seconds=15.0,
+    start_seconds=0.0,
+    style={},
+    name="Auto Subtitle video",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs"
+)
+```
+
+<!-- CUSTOM DOCS END -->
 
 ### Auto Subtitle Generator <a name="create"></a>
 
@@ -10,9 +75,12 @@ Automatically generate subtitles for your video in multiple languages.
 | Parameter | Required | Description | Example |
 |-----------|:--------:|-------------|--------|
 | `assets` | ✓ | Provide the assets for auto subtitle generator | `{"video_file_path": "api-assets/id/1234.mp4"}` |
+| `└─ video_file_path` | ✓ | This is the video used to add subtitles. 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"` |
 | `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` | ✓ | 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` | ✗ | Custom subtitle configuration. | `{"font": "Noto Sans", "font_size": 24.0, "font_style": "normal", "highlighted_text_color": "#FFD700", "horizontal_position": "center", "stroke_color": "#000000", "stroke_width": 1.0, "text_color": "#FFFFFF", "vertical_position": "bottom"}` |
+| `└─ template` | ✗ | Preset subtitle templates. Please visit https://magichour.ai/create/auto-subtitle-generator to see the style of the existing templates. | `"cinematic"` |
 | `name` | ✗ | The name of video. This value is mainly used for your own identification of the video. | `"Auto Subtitle video"` |
 
 #### Synchronous Client
@@ -56,3 +124,4 @@ res = await client.v1.auto_subtitle_generator.create(
 
 ##### Example
 `{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}`
+