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

magic_hour/resources/v1/image_to_video/client.py

@@ -1,6 +1,14 @@
 import typing
+import typing_extensions
 
-from magic_hour.core import (
+from magic_hour.helpers.logger import get_sdk_logger
+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
+from make_api_request import (
     AsyncBaseClient,
     RequestOptions,
     SyncBaseClient,
@@ -8,43 +16,163 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
-from magic_hour.types import models, params
+
+
+logger = get_sdk_logger(__name__)
 
 
 class ImageToVideoClient:
     def __init__(self, *, base_client: SyncBaseClient):
         self._base_client = base_client
 
+    def generate(
+        self,
+        *,
+        assets: params.V1ImageToVideoGenerateBodyAssets,
+        end_seconds: float,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["1080p", "480p", "720p"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1ImageToVideoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], 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 image-to-video (alias for create with additional functionality).
+
+        Create a Image 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.
+
+        Args:
+            height: `height` is deprecated and no longer influences the output video's resolution.
+            name: The name of video. This value is mainly used for your own identification of the video.
+            resolution: Controls the output video resolution. Defaults to `720p` if not specified.
+            style: Attributed used to dictate the style of the output
+            width: `width` is deprecated and no longer influences the output video's resolution.
+            assets: Provide the assets for image-to-video.
+            end_seconds: The total duration of the output video in 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 Image-to-Video API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = client.v1.image_to_video.generate(
+            assets={"image_file_path": "path/to/image.png"},
+            end_seconds=5.0,
+            resolution="720p",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = FilesClient(base_client=self._base_client)
+
+        # Upload image file
+        image_file_path = assets["image_file_path"]
+        assets["image_file_path"] = file_client.upload_file(file=image_file_path)
+
+        create_response = self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            height=height,
+            name=name,
+            resolution=resolution,
+            style=style,
+            width=width,
+            request_options=request_options,
+        )
+        logger.info(f"Image-to-Video 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,
         *,
-        assets: params.PostV1ImageToVideoBodyAssets,
+        assets: params.V1ImageToVideoCreateBodyAssets,
         end_seconds: float,
-        height: int,
-        style: params.PostV1ImageToVideoBodyStyle,
-        width: int,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
+        resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["1080p", "480p", "720p"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1ImageToVideoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> models.PostV1ImageToVideoResponse:
+    ) -> models.V1ImageToVideoCreateResponse:
         """
         Image-to-Video
 
         Create a Image 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](/products/image-to-video).
+        Get more information about this mode at our [product page](https://magichour.ai/products/image-to-video).
 
 
         POST /v1/image-to-video
 
         Args:
-            name: The name of video
+            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.
+            name: The name of video. This value is mainly used for your own identification of the video.
+            resolution: Controls the output video resolution. Defaults to `720p` if not specified.
+
+        480p and 720p are available on Creator, Pro, or Business tiers. However, 1080p require Pro or Business tier.
+
+        **Options:**
+        - `480p` - Supports only 5 or 10 second videos. Output: 24fps. Cost: 120 credits per 5 seconds.
+        - `720p` - Supports videos between 5-60 seconds. Output: 30fps. Cost: 300 credits per 5 seconds.
+        - `1080p` - Supports videos between 5-60 seconds. Output: 30fps. Cost: 600 credits per 5 seconds.
+            style: Attributed used to dictate the style of the output
+            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.
             assets: Provide the assets for image-to-video.
             end_seconds: The total duration of the output video in seconds.
-            height: The height of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
-            style: PostV1ImageToVideoBodyStyle
-            width: The width of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -59,30 +187,29 @@ class ImageToVideoClient:
         client.v1.image_to_video.create(
             assets={"image_file_path": "api-assets/id/1234.png"},
             end_seconds=5.0,
-            height=960,
-            style={"prompt": "string"},
-            width=512,
             name="Image To Video video",
+            resolution="720p",
         )
         ```
         """
         _json = to_encodable(
             item={
-                "name": name,
-                "assets": assets,
-                "end_seconds": end_seconds,
                 "height": height,
+                "name": name,
+                "resolution": resolution,
                 "style": style,
                 "width": width,
+                "assets": assets,
+                "end_seconds": end_seconds,
             },
-            dump_with=params._SerializerPostV1ImageToVideoBody,
+            dump_with=params._SerializerV1ImageToVideoCreateBody,
         )
         return self._base_client.request(
             method="POST",
             path="/v1/image-to-video",
             auth_names=["bearerAuth"],
             json=_json,
-            cast_to=models.PostV1ImageToVideoResponse,
+            cast_to=models.V1ImageToVideoCreateResponse,
             request_options=request_options or default_request_options(),
         )
 
@@ -91,36 +218,154 @@ class AsyncImageToVideoClient:
     def __init__(self, *, base_client: AsyncBaseClient):
         self._base_client = base_client
 
+    async def generate(
+        self,
+        *,
+        assets: params.V1ImageToVideoGenerateBodyAssets,
+        end_seconds: float,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["1080p", "480p", "720p"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1ImageToVideoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], 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 image-to-video (alias for create with additional functionality).
+
+        Create a Image 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.
+
+        Args:
+            height: `height` is deprecated and no longer influences the output video's resolution.
+            name: The name of video. This value is mainly used for your own identification of the video.
+            resolution: Controls the output video resolution. Defaults to `720p` if not specified.
+            style: Attributed used to dictate the style of the output
+            width: `width` is deprecated and no longer influences the output video's resolution.
+            assets: Provide the assets for image-to-video.
+            end_seconds: The total duration of the output video in 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 Image-to-Video API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = await client.v1.image_to_video.generate(
+            assets={"image_file_path": "path/to/image.png"},
+            end_seconds=5.0,
+            resolution="720p",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = AsyncFilesClient(base_client=self._base_client)
+
+        # Upload image file
+        image_file_path = assets["image_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,
+            height=height,
+            name=name,
+            resolution=resolution,
+            style=style,
+            width=width,
+            request_options=request_options,
+        )
+        logger.info(f"Image-to-Video 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,
         *,
-        assets: params.PostV1ImageToVideoBodyAssets,
+        assets: params.V1ImageToVideoCreateBodyAssets,
         end_seconds: float,
-        height: int,
-        style: params.PostV1ImageToVideoBodyStyle,
-        width: int,
+        height: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
+        resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["1080p", "480p", "720p"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        style: typing.Union[
+            typing.Optional[params.V1ImageToVideoCreateBodyStyle], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> models.PostV1ImageToVideoResponse:
+    ) -> models.V1ImageToVideoCreateResponse:
         """
         Image-to-Video
 
         Create a Image 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](/products/image-to-video).
+        Get more information about this mode at our [product page](https://magichour.ai/products/image-to-video).
 
 
         POST /v1/image-to-video
 
         Args:
-            name: The name of video
+            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.
+            name: The name of video. This value is mainly used for your own identification of the video.
+            resolution: Controls the output video resolution. Defaults to `720p` if not specified.
+
+        480p and 720p are available on Creator, Pro, or Business tiers. However, 1080p require Pro or Business tier.
+
+        **Options:**
+        - `480p` - Supports only 5 or 10 second videos. Output: 24fps. Cost: 120 credits per 5 seconds.
+        - `720p` - Supports videos between 5-60 seconds. Output: 30fps. Cost: 300 credits per 5 seconds.
+        - `1080p` - Supports videos between 5-60 seconds. Output: 30fps. Cost: 600 credits per 5 seconds.
+            style: Attributed used to dictate the style of the output
+            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.
             assets: Provide the assets for image-to-video.
             end_seconds: The total duration of the output video in seconds.
-            height: The height of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
-            style: PostV1ImageToVideoBodyStyle
-            width: The width of the input video. This value will help determine the final orientation of the output video. The output video resolution may not match the input.
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -135,29 +380,28 @@ class AsyncImageToVideoClient:
         await client.v1.image_to_video.create(
             assets={"image_file_path": "api-assets/id/1234.png"},
             end_seconds=5.0,
-            height=960,
-            style={"prompt": "string"},
-            width=512,
             name="Image To Video video",
+            resolution="720p",
         )
         ```
         """
         _json = to_encodable(
             item={
-                "name": name,
-                "assets": assets,
-                "end_seconds": end_seconds,
                 "height": height,
+                "name": name,
+                "resolution": resolution,
                 "style": style,
                 "width": width,
+                "assets": assets,
+                "end_seconds": end_seconds,
             },
-            dump_with=params._SerializerPostV1ImageToVideoBody,
+            dump_with=params._SerializerV1ImageToVideoCreateBody,
         )
         return await self._base_client.request(
             method="POST",
             path="/v1/image-to-video",
             auth_names=["bearerAuth"],
             json=_json,
-            cast_to=models.PostV1ImageToVideoResponse,
+            cast_to=models.V1ImageToVideoCreateResponse,
             request_options=request_options or default_request_options(),
         )

magic_hour/resources/v1/lip_sync/README.md

@@ -1,14 +1,109 @@
+# v1.lip_sync
 
-### create <a name="create"></a>
-Lip Sync
+## Module Functions
+
+<!-- CUSTOM DOCS START -->
+
+### Lip Sync 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.lip_sync.generate(
+    assets={
+        "audio_file_path": "/path/to/1234.mp3",
+        "video_file_path": "/path/to/1234.mp4",
+        "video_source": "file",
+    },
+    style={
+        "generation_mode": "lite",
+    },
+    end_seconds=15.0,
+    start_seconds=0.0,
+    max_fps_limit=12.0,
+    name="Lip Sync 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.lip_sync.generate(
+    assets={
+        "audio_file_path": "/path/to/1234.mp3",
+        "video_file_path": "/path/to/1234.mp4",
+        "video_source": "file",
+    },
+    style={
+        "generation_mode": "lite",
+    },
+    end_seconds=15.0,
+    start_seconds=0.0,
+    max_fps_limit=12.0,
+    name="Lip Sync video",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs"
+)
+```
+
+<!-- CUSTOM DOCS END -->
+
+### Lip Sync <a name="create"></a>
 
 Create a Lip Sync 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](/products/lip-sync).
-  
+
+Get more information about this mode at our [product page](https://magichour.ai/products/lip-sync).
 
 **API Endpoint**: `POST /v1/lip-sync`
 
+#### Parameters
+
+| Parameter            | Required | Deprecated | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Example                                                                                                              |
+| -------------------- | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `assets`             |    ✓     |     ✗      | Provide the assets for lip-sync. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used                                                                                                                                                                                                                                                                                                                                                         | `{"audio_file_path": "api-assets/id/1234.mp3", "video_file_path": "api-assets/id/1234.mp4", "video_source": "file"}` |
+| `└─ audio_file_path` |    ✓     |     —      | The path of the audio 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"`                                                                                           |
+| `└─ 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`                                                                                                                |
+| `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`                                                                                                                |
+| `max_fps_limit`      |    ✗     |     ✗      | Defines the maximum FPS (frames per second) for the output video. If the input video's FPS is lower than this limit, the output video will retain the input FPS. This is useful for reducing unnecessary frame usage in scenarios where high FPS is not required.                                                                                                                                                                                                                                | `12.0`                                                                                                               |
+| `name`               |    ✗     |     ✗      | The name of video. This value is mainly used for your own identification of the video.                                                                                                                                                                                                                                                                                                                                                                                                           | `"Lip Sync video"`                                                                                                   |
+| `style`              |    ✗     |     ✗      | Attributes used to dictate the style of the output                                                                                                                                                                                                                                                                                                                                                                                                                                               | `{"generation_mode": "lite"}`                                                                                        |
+| `└─ generation_mode` |    ✗     |     —      | A specific version of our lip sync system, optimized for different needs. * `lite` - Fast and affordable lip sync - best for simple videos. Costs 1 credit per frame of video. * `standard` - Natural, accurate lip sync - best for most creators. Costs 1 credit per frame of video. * `pro` - Premium fidelity with enhanced detail - best for professionals. Costs 2 credits per frame of video. Note: `standard` and `pro` are only available for users on Creator, Pro, and Business tiers. | `"lite"`                                                                                                             |
+| `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
 
 ```python
@@ -23,9 +118,7 @@ res = client.v1.lip_sync.create(
         "video_source": "file",
     },
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
-    width=512,
     max_fps_limit=12.0,
     name="Lip Sync video",
 )
@@ -45,10 +138,20 @@ res = await client.v1.lip_sync.create(
         "video_source": "file",
     },
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
-    width=512,
     max_fps_limit=12.0,
     name="Lip Sync video",
 )
 ```
+
+#### Response
+
+##### Type
+
+[V1LipSyncCreateResponse](/magic_hour/types/models/v1_lip_sync_create_response.py)
+
+##### Example
+
+```python
+{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}
+```