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

magic_hour/resources/v1/video_to_video/README.md

@@ -1,14 +1,112 @@
+# v1.video_to_video
 
-### create <a name="create"></a>
-Video-to-Video
+## Module Functions
+
+<!-- CUSTOM DOCS START -->
+
+### Video To Video 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.video_to_video.generate(
+    assets={"video_file_path": "/path/to/1234.mp4", "video_source": "file"},
+    end_seconds=15.0,
+    start_seconds=0.0,
+    style={
+        "art_style": "3D Render",
+        "model": "default",
+        "prompt": "string",
+        "prompt_type": "default",
+        "version": "default",
+    },
+    fps_resolution="HALF",
+    name="Video To Video 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.video_to_video.generate(
+    assets={"video_file_path": "/path/to/1234.mp4", "video_source": "file"},
+    end_seconds=15.0,
+    start_seconds=0.0,
+    style={
+        "art_style": "3D Render",
+        "model": "default",
+        "prompt": "string",
+        "prompt_type": "default",
+        "version": "default",
+    },
+    fps_resolution="HALF",
+    name="Video To Video video",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs"
+)
+```
+
+<!-- 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](/products/video-to-video).
-  
+
+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`                                                                                            |
+
 #### Synchronous Client
 
 ```python
@@ -19,16 +117,13 @@ client = Client(token=getenv("API_TOKEN"))
 res = client.v1.video_to_video.create(
     assets={"video_file_path": "api-assets/id/1234.mp4", "video_source": "file"},
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
     style={
         "art_style": "3D Render",
-        "model": "Absolute Reality",
-        "prompt": None,
-        "prompt_type": "append_default",
+        "model": "default",
+        "prompt_type": "default",
         "version": "default",
     },
-    width=512,
     fps_resolution="HALF",
     name="Video To Video video",
 )
@@ -44,17 +139,26 @@ client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.video_to_video.create(
     assets={"video_file_path": "api-assets/id/1234.mp4", "video_source": "file"},
     end_seconds=15.0,
-    height=960,
     start_seconds=0.0,
     style={
         "art_style": "3D Render",
-        "model": "Absolute Reality",
-        "prompt": None,
-        "prompt_type": "append_default",
+        "model": "default",
+        "prompt_type": "default",
         "version": "default",
     },
-    width=512,
     fps_resolution="HALF",
     name="Video To Video video",
 )
 ```
+
+#### Response
+
+##### Type
+
+[V1VideoToVideoCreateResponse](/magic_hour/types/models/v1_video_to_video_create_response.py)
+
+##### Example
+
+```python
+{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}
+```

magic_hour/resources/v1/video_to_video/client.py

@@ -1,7 +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,
@@ -9,37 +16,148 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
-from magic_hour.types import models, params
+
+
+logger = get_sdk_logger(__name__)
 
 
 class VideoToVideoClient:
     def __init__(self, *, base_client: SyncBaseClient):
         self._base_client = base_client
 
+    def generate(
+        self,
+        *,
+        assets: params.V1VideoToVideoGenerateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        style: params.V1VideoToVideoCreateBodyStyle,
+        fps_resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        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,
+        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 video-to-video (alias for create with additional functionality).
+
+        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.
+
+        Args:
+            fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
+            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.
+            width: `width` is deprecated and no longer influences the output video's resolution.
+            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
+            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.
+            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.
+            style: V1VideoToVideoCreateBodyStyle
+            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 Video-to-Video API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = client.v1.video_to_video.generate(
+            assets={
+                "video_file_path": "path/to/video.mp4",
+                "video_source": "file",
+            },
+            end_seconds=15.0,
+            start_seconds=0.0,
+            style={
+                "art_style": "3D Render",
+                "model": "default",
+                "prompt": "cyberpunk city",
+                "prompt_type": "default",
+                "version": "default",
+            },
+            fps_resolution="HALF",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = FilesClient(base_client=self._base_client)
+
+        # Upload video file if video_source is "file" and video_file_path is provided
+        if (
+            assets.get("video_source") == "file"
+            and "video_file_path" in assets
+            and assets["video_file_path"]
+        ):
+            video_file_path = assets["video_file_path"]
+            assets["video_file_path"] = file_client.upload_file(file=video_file_path)
+
+        create_response = self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            start_seconds=start_seconds,
+            style=style,
+            fps_resolution=fps_resolution,
+            height=height,
+            name=name,
+            width=width,
+            request_options=request_options,
+        )
+        logger.info(f"Video-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.PostV1VideoToVideoBodyAssets,
+        assets: params.V1VideoToVideoCreateBodyAssets,
         end_seconds: float,
-        height: int,
         start_seconds: float,
-        style: params.PostV1VideoToVideoBodyStyle,
-        width: int,
+        style: params.V1VideoToVideoCreateBodyStyle,
         fps_resolution: typing.Union[
             typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
             type_utils.NotGiven,
         ] = type_utils.NOT_GIVEN,
+        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,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> models.PostV1VideoToVideoResponse:
+    ) -> models.V1VideoToVideoCreateResponse:
         """
         Video-to-Video
 
         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](/products/video-to-video).
+        Get more information about this mode at our [product page](https://magichour.ai/products/video-to-video).
 
 
         POST /v1/video-to-video
@@ -48,13 +166,25 @@ class VideoToVideoClient:
             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
-            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.
+            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 video-to-video. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
-            end_seconds: The end time of the input video in seconds
-            height: The height of the final output video. Must be divisible by 64. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
-            start_seconds: The start time of the input video in seconds
-            style: PostV1VideoToVideoBodyStyle
-            width: The width of the final output video. Must be divisible by 64. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
+            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.
+            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.
+            style: V1VideoToVideoCreateBodyStyle
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -67,18 +197,18 @@ class VideoToVideoClient:
         Examples:
         ```py
         client.v1.video_to_video.create(
-            assets={"video_source": "file"},
+            assets={
+                "video_file_path": "api-assets/id/1234.mp4",
+                "video_source": "file",
+            },
             end_seconds=15.0,
-            height=960,
             start_seconds=0.0,
             style={
                 "art_style": "3D Render",
-                "model": "Absolute Reality",
-                "prompt": "string",
-                "prompt_type": "append_default",
+                "model": "default",
+                "prompt_type": "default",
                 "version": "default",
             },
-            width=512,
             fps_resolution="HALF",
             name="Video To Video video",
         )
@@ -87,22 +217,22 @@ class VideoToVideoClient:
         _json = to_encodable(
             item={
                 "fps_resolution": fps_resolution,
+                "height": height,
                 "name": name,
+                "width": width,
                 "assets": assets,
                 "end_seconds": end_seconds,
-                "height": height,
                 "start_seconds": start_seconds,
                 "style": style,
-                "width": width,
             },
-            dump_with=params._SerializerPostV1VideoToVideoBody,
+            dump_with=params._SerializerV1VideoToVideoCreateBody,
         )
         return self._base_client.request(
             method="POST",
             path="/v1/video-to-video",
             auth_names=["bearerAuth"],
             json=_json,
-            cast_to=models.PostV1VideoToVideoResponse,
+            cast_to=models.V1VideoToVideoCreateResponse,
             request_options=request_options or default_request_options(),
         )
 
@@ -111,30 +241,141 @@ class AsyncVideoToVideoClient:
     def __init__(self, *, base_client: AsyncBaseClient):
         self._base_client = base_client
 
+    async def generate(
+        self,
+        *,
+        assets: params.V1VideoToVideoGenerateBodyAssets,
+        end_seconds: float,
+        start_seconds: float,
+        style: params.V1VideoToVideoCreateBodyStyle,
+        fps_resolution: typing.Union[
+            typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
+            type_utils.NotGiven,
+        ] = type_utils.NOT_GIVEN,
+        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,
+        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 video-to-video (alias for create with additional functionality).
+
+        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.
+
+        Args:
+            fps_resolution: Determines whether the resulting video will have the same frame per second as the original video, or half.
+            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.
+            width: `width` is deprecated and no longer influences the output video's resolution.
+            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
+            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.
+            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.
+            style: V1VideoToVideoCreateBodyStyle
+            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 Video-to-Video API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = await client.v1.video_to_video.generate(
+            assets={
+                "video_file_path": "path/to/video.mp4",
+                "video_source": "file",
+            },
+            end_seconds=15.0,
+            start_seconds=0.0,
+            style={
+                "art_style": "3D Render",
+                "model": "default",
+                "prompt": "cyberpunk city",
+                "prompt_type": "default",
+                "version": "default",
+            },
+            fps_resolution="HALF",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = AsyncFilesClient(base_client=self._base_client)
+
+        # Upload video file if video_source is "file" and video_file_path is provided
+        if (
+            assets.get("video_source") == "file"
+            and "video_file_path" in assets
+            and assets["video_file_path"]
+        ):
+            video_file_path = assets["video_file_path"]
+            assets["video_file_path"] = await file_client.upload_file(
+                file=video_file_path
+            )
+
+        create_response = await self.create(
+            assets=assets,
+            end_seconds=end_seconds,
+            start_seconds=start_seconds,
+            style=style,
+            fps_resolution=fps_resolution,
+            height=height,
+            name=name,
+            width=width,
+            request_options=request_options,
+        )
+        logger.info(f"Video-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.PostV1VideoToVideoBodyAssets,
+        assets: params.V1VideoToVideoCreateBodyAssets,
         end_seconds: float,
-        height: int,
         start_seconds: float,
-        style: params.PostV1VideoToVideoBodyStyle,
-        width: int,
+        style: params.V1VideoToVideoCreateBodyStyle,
         fps_resolution: typing.Union[
             typing.Optional[typing_extensions.Literal["FULL", "HALF"]],
             type_utils.NotGiven,
         ] = type_utils.NOT_GIVEN,
+        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,
+        width: typing.Union[
+            typing.Optional[int], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> models.PostV1VideoToVideoResponse:
+    ) -> models.V1VideoToVideoCreateResponse:
         """
         Video-to-Video
 
         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](/products/video-to-video).
+        Get more information about this mode at our [product page](https://magichour.ai/products/video-to-video).
 
 
         POST /v1/video-to-video
@@ -143,13 +384,25 @@ class AsyncVideoToVideoClient:
             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
-            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.
+            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 video-to-video. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
-            end_seconds: The end time of the input video in seconds
-            height: The height of the final output video. Must be divisible by 64. The maximum height depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
-            start_seconds: The start time of the input video in seconds
-            style: PostV1VideoToVideoBodyStyle
-            width: The width of the final output video. Must be divisible by 64. The maximum width depends on your subscription. Please refer to our [pricing page](https://magichour.ai/pricing) for more details
+            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.
+            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.
+            style: V1VideoToVideoCreateBodyStyle
             request_options: Additional options to customize the HTTP request
 
         Returns:
@@ -162,18 +415,18 @@ class AsyncVideoToVideoClient:
         Examples:
         ```py
         await client.v1.video_to_video.create(
-            assets={"video_source": "file"},
+            assets={
+                "video_file_path": "api-assets/id/1234.mp4",
+                "video_source": "file",
+            },
             end_seconds=15.0,
-            height=960,
             start_seconds=0.0,
             style={
                 "art_style": "3D Render",
-                "model": "Absolute Reality",
-                "prompt": "string",
-                "prompt_type": "append_default",
+                "model": "default",
+                "prompt_type": "default",
                 "version": "default",
             },
-            width=512,
             fps_resolution="HALF",
             name="Video To Video video",
         )
@@ -182,21 +435,21 @@ class AsyncVideoToVideoClient:
         _json = to_encodable(
             item={
                 "fps_resolution": fps_resolution,
+                "height": height,
                 "name": name,
+                "width": width,
                 "assets": assets,
                 "end_seconds": end_seconds,
-                "height": height,
                 "start_seconds": start_seconds,
                 "style": style,
-                "width": width,
             },
-            dump_with=params._SerializerPostV1VideoToVideoBody,
+            dump_with=params._SerializerV1VideoToVideoCreateBody,
         )
         return await self._base_client.request(
             method="POST",
             path="/v1/video-to-video",
             auth_names=["bearerAuth"],
             json=_json,
-            cast_to=models.PostV1VideoToVideoResponse,
+            cast_to=models.V1VideoToVideoCreateResponse,
             request_options=request_options or default_request_options(),
         )