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

magic_hour/README.md

@@ -0,0 +1,34 @@
+# Base Client
+
+## Submodules
+
+- [ai_clothes_changer](resources/v1/ai_clothes_changer/README.md) - ai_clothes_changer
+- [ai_face_editor](resources/v1/ai_face_editor/README.md) - ai_face_editor
+- [ai_gif_generator](resources/v1/ai_gif_generator/README.md) - ai_gif_generator
+- [ai_headshot_generator](resources/v1/ai_headshot_generator/README.md) - ai_headshot_generator
+- [ai_image_editor](resources/v1/ai_image_editor/README.md) - ai_image_editor
+- [ai_image_generator](resources/v1/ai_image_generator/README.md) - ai_image_generator
+- [ai_image_upscaler](resources/v1/ai_image_upscaler/README.md) - ai_image_upscaler
+- [ai_meme_generator](resources/v1/ai_meme_generator/README.md) - ai_meme_generator
+- [ai_photo_editor](resources/v1/ai_photo_editor/README.md) - ai_photo_editor
+- [ai_qr_code_generator](resources/v1/ai_qr_code_generator/README.md) - ai_qr_code_generator
+- [ai_talking_photo](resources/v1/ai_talking_photo/README.md) - ai_talking_photo
+- [ai_voice_cloner](resources/v1/ai_voice_cloner/README.md) - ai_voice_cloner
+- [ai_voice_generator](resources/v1/ai_voice_generator/README.md) - ai_voice_generator
+- [animation](resources/v1/animation/README.md) - animation
+- [audio_projects](resources/v1/audio_projects/README.md) - audio_projects
+- [auto_subtitle_generator](resources/v1/auto_subtitle_generator/README.md) - auto_subtitle_generator
+- [face_detection](resources/v1/face_detection/README.md) - face_detection
+- [face_swap](resources/v1/face_swap/README.md) - face_swap
+- [face_swap_photo](resources/v1/face_swap_photo/README.md) - face_swap_photo
+- [upload_urls](resources/v1/files/upload_urls/README.md) - upload_urls
+- [files](resources/v1/files/README.md) - files
+- [image_background_remover](resources/v1/image_background_remover/README.md) - image_background_remover
+- [image_projects](resources/v1/image_projects/README.md) - image_projects
+- [image_to_video](resources/v1/image_to_video/README.md) - image_to_video
+- [lip_sync](resources/v1/lip_sync/README.md) - lip_sync
+- [photo_colorizer](resources/v1/photo_colorizer/README.md) - photo_colorizer
+- [text_to_video](resources/v1/text_to_video/README.md) - text_to_video
+- [video_projects](resources/v1/video_projects/README.md) - video_projects
+- [video_to_video](resources/v1/video_to_video/README.md) - video_to_video
+- [v1](resources/v1/README.md) - v1

magic_hour/__init__.py

@@ -1,6 +1,6 @@
 from .client import AsyncClient, Client
-from .core import ApiError, BinaryResponse
 from .environment import Environment
+from make_api_request import ApiError, BinaryResponse
 
 
 __all__ = ["ApiError", "AsyncClient", "BinaryResponse", "Client", "Environment"]

magic_hour/client.py

@@ -1,18 +1,18 @@
 import httpx
 import typing
 
-from magic_hour.core import AsyncBaseClient, AuthBearer, SyncBaseClient
-from magic_hour.environment import Environment
+from magic_hour.environment import Environment, _get_base_url
 from magic_hour.resources.v1 import AsyncV1Client, V1Client
+from make_api_request import AsyncBaseClient, AuthBearer, SyncBaseClient
 
 
 class Client:
     def __init__(
         self,
         *,
-        base_url: typing.Optional[str] = None,
         timeout: typing.Optional[float] = 60,
         httpx_client: typing.Optional[httpx.Client] = None,
+        base_url: typing.Optional[str] = None,
         environment: Environment = Environment.ENVIRONMENT,
         token: typing.Optional[str] = None,
     ):
@@ -22,8 +22,9 @@ class Client:
             httpx_client=httpx.Client(timeout=timeout)
             if httpx_client is None
             else httpx_client,
+            auths={"bearerAuth": AuthBearer(token=token)},
         )
-        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
+
         self.v1 = V1Client(base_client=self._base_client)
 
 
@@ -31,9 +32,9 @@ class AsyncClient:
     def __init__(
         self,
         *,
-        base_url: typing.Optional[str] = None,
         timeout: typing.Optional[float] = 60,
         httpx_client: typing.Optional[httpx.AsyncClient] = None,
+        base_url: typing.Optional[str] = None,
         environment: Environment = Environment.ENVIRONMENT,
         token: typing.Optional[str] = None,
     ):
@@ -43,17 +44,7 @@ class AsyncClient:
             httpx_client=httpx.AsyncClient(timeout=timeout)
             if httpx_client is None
             else httpx_client,
+            auths={"bearerAuth": AuthBearer(token=token)},
         )
-        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
-        self.v1 = AsyncV1Client(base_client=self._base_client)
 
-
-def _get_base_url(
-    *, base_url: typing.Optional[str] = None, environment: Environment
-) -> str:
-    if base_url is not None:
-        return base_url
-    elif environment is not None:
-        return environment.value
-    else:
-        raise Exception("Must include a base_url or environment arguments")
+        self.v1 = AsyncV1Client(base_client=self._base_client)

magic_hour/environment.py

@@ -1,8 +1,20 @@
 import enum
+import typing
 
 
 class Environment(enum.Enum):
     """Pre-defined base URLs for the API"""
 
     ENVIRONMENT = "https://api.magichour.ai"
-    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.9.5"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.43.1"
+
+
+def _get_base_url(
+    *, base_url: typing.Optional[str] = None, environment: Environment
+) -> str:
+    if base_url is not None:
+        return base_url
+    elif environment is not None:
+        return environment.value
+    else:
+        raise Exception("Must include a base_url or environment arguments")

magic_hour/helpers/__init__.py

@@ -0,0 +1,4 @@
+from .download import download_files_sync, download_files_async
+from .logger import get_sdk_logger
+
+__all__ = ["download_files_sync", "download_files_async", "get_sdk_logger"]

magic_hour/helpers/download.py

@@ -0,0 +1,77 @@
+import os
+from pathlib import Path
+from typing import Union, List
+from urllib.parse import urlparse
+import httpx
+from magic_hour.types import models
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+def _compute_download_path(
+    url: str, download_directory: Union[str, None] = None
+) -> str:
+    url_path = urlparse(url).path
+    filename = Path(url_path).name
+    if download_directory:
+        return os.path.join(download_directory, filename)
+    return filename
+
+
+def download_files_sync(
+    downloads: Union[
+        List[models.V1ImageProjectsGetResponseDownloadsItem],
+        List[models.V1VideoProjectsGetResponseDownloadsItem],
+        List[models.V1AudioProjectsGetResponseDownloadsItem],
+    ],
+    download_directory: Union[str, None] = None,
+) -> List[str]:
+    downloaded_paths: List[str] = []
+
+    for download in downloads:
+        with httpx.Client() as http_client:
+            download_response = http_client.get(download.url)
+            download_response.raise_for_status()
+
+            download_path = _compute_download_path(
+                download.url, download_directory=download_directory
+            )
+
+            with open(download_path, "wb") as f:
+                f.write(download_response.content)
+
+            downloaded_paths.append(download_path)
+
+            logger.info(f"Downloaded file saved as: {download_path}")
+
+    return downloaded_paths
+
+
+async def download_files_async(
+    downloads: Union[
+        List[models.V1ImageProjectsGetResponseDownloadsItem],
+        List[models.V1VideoProjectsGetResponseDownloadsItem],
+        List[models.V1AudioProjectsGetResponseDownloadsItem],
+    ],
+    download_directory: Union[str, None] = None,
+) -> List[str]:
+    downloaded_paths: List[str] = []
+
+    for download in downloads:
+        async with httpx.AsyncClient() as http_client:
+            download_response = await http_client.get(download.url)
+            download_response.raise_for_status()
+
+            download_path = _compute_download_path(
+                download.url, download_directory=download_directory
+            )
+
+            with open(download_path, "wb") as f:
+                f.write(download_response.content)
+
+            downloaded_paths.append(download_path)
+
+            logger.info(f"Downloaded file saved as: {download_path}")
+
+    return downloaded_paths

magic_hour/helpers/logger.py

@@ -0,0 +1,8 @@
+import logging
+
+
+def get_sdk_logger(name: str) -> logging.Logger:
+    logger = logging.getLogger(name)
+    logger.addHandler(logging.NullHandler())  # safe default
+    logger.propagate = True
+    return logger

magic_hour/resources/v1/README.md

@@ -0,0 +1,32 @@
+# v1
+
+## Submodules
+
+- [ai_clothes_changer](ai_clothes_changer/README.md) - ai_clothes_changer
+- [ai_face_editor](ai_face_editor/README.md) - ai_face_editor
+- [ai_gif_generator](ai_gif_generator/README.md) - ai_gif_generator
+- [ai_headshot_generator](ai_headshot_generator/README.md) - ai_headshot_generator
+- [ai_image_editor](ai_image_editor/README.md) - ai_image_editor
+- [ai_image_generator](ai_image_generator/README.md) - ai_image_generator
+- [ai_image_upscaler](ai_image_upscaler/README.md) - ai_image_upscaler
+- [ai_meme_generator](ai_meme_generator/README.md) - ai_meme_generator
+- [ai_photo_editor](ai_photo_editor/README.md) - ai_photo_editor
+- [ai_qr_code_generator](ai_qr_code_generator/README.md) - ai_qr_code_generator
+- [ai_talking_photo](ai_talking_photo/README.md) - ai_talking_photo
+- [ai_voice_cloner](ai_voice_cloner/README.md) - ai_voice_cloner
+- [ai_voice_generator](ai_voice_generator/README.md) - ai_voice_generator
+- [animation](animation/README.md) - animation
+- [audio_projects](audio_projects/README.md) - audio_projects
+- [auto_subtitle_generator](auto_subtitle_generator/README.md) - auto_subtitle_generator
+- [face_detection](face_detection/README.md) - face_detection
+- [face_swap](face_swap/README.md) - face_swap
+- [face_swap_photo](face_swap_photo/README.md) - face_swap_photo
+- [files](files/README.md) - files
+- [image_background_remover](image_background_remover/README.md) - image_background_remover
+- [image_projects](image_projects/README.md) - image_projects
+- [image_to_video](image_to_video/README.md) - image_to_video
+- [lip_sync](lip_sync/README.md) - lip_sync
+- [photo_colorizer](photo_colorizer/README.md) - photo_colorizer
+- [text_to_video](text_to_video/README.md) - text_to_video
+- [video_projects](video_projects/README.md) - video_projects
+- [video_to_video](video_to_video/README.md) - video_to_video

magic_hour/resources/v1/ai_clothes_changer/README.md

@@ -1,11 +1,88 @@
+# v1.ai_clothes_changer
 
-### create <a name="create"></a>
-AI Clothes Changer
+## Module Functions
 
-Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.
+<!-- CUSTOM DOCS START -->
+
+### AI Clothes Changer 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.ai_clothes_changer.generate(
+    assets={
+        "garment_file_path": "/path/to/outfit.png",
+        "garment_type": "upper_body",
+        "person_file_path": "/path/to/model.png",
+    },
+    name="Clothes Changer image",
+    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.ai_clothes_changer.generate(
+    assets={
+        "garment_file_path": "/path/to/outfit.png",
+        "garment_type": "upper_body",
+        "person_file_path": "/path/to/model.png",
+    },
+    name="Clothes Changer image",
+    download_directory="outputs",
+    wait_for_completion=True,
+    download_outputs=True,
+    download_directory="outputs",
+)
+```
+
+<!-- CUSTOM DOCS END -->
+
+### AI Clothes Changer <a name="create"></a>
+
+Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
 
 **API Endpoint**: `POST /v1/ai-clothes-changer`
 
+#### Parameters
+
+| Parameter              | Required | Description                                                                                                                                                                                                                                                                                                                                                                   | Example                                                                                                                          |
+| ---------------------- | :------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `assets`               |    ✓     | Provide the assets for clothes changer                                                                                                                                                                                                                                                                                                                                        | `{"garment_file_path": "api-assets/id/outfit.png", "garment_type": "upper_body", "person_file_path": "api-assets/id/model.png"}` |
+| `└─ garment_file_path` |    ✓     | The image of the outfit. 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/outfit.png"`                                                                                                     |
+| `└─ garment_type`      |    ✓     | The type of the outfit.                                                                                                                                                                                                                                                                                                                                                       | `"upper_body"`                                                                                                                   |
+| `└─ person_file_path`  |    ✓     | The image with the person. 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/model.png"`                                                                                                      |
+| `name`                 |    ✗     | The name of image. This value is mainly used for your own identification of the image.                                                                                                                                                                                                                                                                                        | `"Clothes Changer image"`                                                                                                        |
+
 #### Synchronous Client
 
 ```python
@@ -16,7 +93,7 @@ client = Client(token=getenv("API_TOKEN"))
 res = client.v1.ai_clothes_changer.create(
     assets={
         "garment_file_path": "api-assets/id/outfit.png",
-        "garment_type": "dresses",
+        "garment_type": "upper_body",
         "person_file_path": "api-assets/id/model.png",
     },
     name="Clothes Changer image",
@@ -33,9 +110,21 @@ client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.ai_clothes_changer.create(
     assets={
         "garment_file_path": "api-assets/id/outfit.png",
-        "garment_type": "dresses",
+        "garment_type": "upper_body",
         "person_file_path": "api-assets/id/model.png",
     },
     name="Clothes Changer image",
 )
 ```
+
+#### Response
+
+##### Type
+
+[V1AiClothesChangerCreateResponse](/magic_hour/types/models/v1_ai_clothes_changer_create_response.py)
+
+##### Example
+
+```python
+{"credits_charged": 25, "frame_cost": 25, "id": "cuid-example"}
+```

magic_hour/resources/v1/ai_clothes_changer/client.py

@@ -1,6 +1,13 @@
 import typing
 
-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.image_projects.client import (
+    AsyncImageProjectsClient,
+    ImageProjectsClient,
+)
+from magic_hour.types import models, params
+from make_api_request import (
     AsyncBaseClient,
     RequestOptions,
     SyncBaseClient,
@@ -8,31 +15,99 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
-from magic_hour.types import models, params
+
+
+logger = get_sdk_logger(__name__)
 
 
 class AiClothesChangerClient:
     def __init__(self, *, base_client: SyncBaseClient):
         self._base_client = base_client
 
+    def generate(
+        self,
+        *,
+        assets: params.V1AiClothesChangerGenerateBodyAssets,
+        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 clothes changed image (alias for create with additional functionality).
+
+        Change clothes in an image using AI. Each change costs 5 credits.
+
+        Args:
+            name: The name of image. This value is mainly used for your own identification of the image.
+            assets: Provide the assets for clothes changer
+            wait_for_completion: Whether to wait for the image 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:
+            V1ImageProjectsGetResponseWithDownloads: The response from the AI Clothes Changer API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = client.v1.ai_clothes_changer.generate(
+            assets={
+                "garment_file_path": "path/to/outfit.png",
+                "garment_type": "upper_body",
+                "person_file_path": "path/to/model.png",
+            },
+            name="Clothes Changer image",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = FilesClient(base_client=self._base_client)
+
+        garment_file_path = assets["garment_file_path"]
+        person_file_path = assets["person_file_path"]
+        assets["garment_file_path"] = file_client.upload_file(file=garment_file_path)
+        assets["person_file_path"] = file_client.upload_file(file=person_file_path)
+
+        create_response = self.create(
+            assets=assets, name=name, request_options=request_options
+        )
+        logger.info(f"AI Clothes Changer response: {create_response}")
+
+        image_projects_client = ImageProjectsClient(base_client=self._base_client)
+        response = image_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.PostV1AiClothesChangerBodyAssets,
+        assets: params.V1AiClothesChangerCreateBodyAssets,
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> models.PostV1AiClothesChangerResponse:
+    ) -> models.V1AiClothesChangerCreateResponse:
         """
         AI Clothes Changer
 
-        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.
+        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
 
         POST /v1/ai-clothes-changer
 
         Args:
-            name: The name of image
+            name: The name of image. This value is mainly used for your own identification of the image.
             assets: Provide the assets for clothes changer
             request_options: Additional options to customize the HTTP request
 
@@ -48,7 +123,7 @@ class AiClothesChangerClient:
         client.v1.ai_clothes_changer.create(
             assets={
                 "garment_file_path": "api-assets/id/outfit.png",
-                "garment_type": "dresses",
+                "garment_type": "upper_body",
                 "person_file_path": "api-assets/id/model.png",
             },
             name="Clothes Changer image",
@@ -57,14 +132,14 @@ class AiClothesChangerClient:
         """
         _json = to_encodable(
             item={"name": name, "assets": assets},
-            dump_with=params._SerializerPostV1AiClothesChangerBody,
+            dump_with=params._SerializerV1AiClothesChangerCreateBody,
         )
         return self._base_client.request(
             method="POST",
             path="/v1/ai-clothes-changer",
             auth_names=["bearerAuth"],
             json=_json,
-            cast_to=models.PostV1AiClothesChangerResponse,
+            cast_to=models.V1AiClothesChangerCreateResponse,
             request_options=request_options or default_request_options(),
         )
 
@@ -73,24 +148,94 @@ class AsyncAiClothesChangerClient:
     def __init__(self, *, base_client: AsyncBaseClient):
         self._base_client = base_client
 
+    async def generate(
+        self,
+        *,
+        assets: params.V1AiClothesChangerGenerateBodyAssets,
+        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 clothes changed image (alias for create with additional functionality).
+
+        Change clothes in an image using AI. Each change costs 5 credits.
+
+        Args:
+            name: The name of image. This value is mainly used for your own identification of the image.
+            assets: Provide the assets for clothes changer
+            wait_for_completion: Whether to wait for the image 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:
+            V1ImageProjectsGetResponseWithDownloads: The response from the AI Clothes Changer API with the downloaded paths if `download_outputs` is True.
+
+        Examples:
+        ```py
+        response = await client.v1.ai_clothes_changer.generate(
+            assets={
+                "garment_file_path": "path/to/outfit.png",
+                "garment_type": "upper_body",
+                "person_file_path": "path/to/model.png",
+            },
+            name="Clothes Changer image",
+            wait_for_completion=True,
+            download_outputs=True,
+            download_directory="outputs/",
+        )
+        ```
+        """
+
+        file_client = AsyncFilesClient(base_client=self._base_client)
+
+        garment_file_path = assets["garment_file_path"]
+        person_file_path = assets["person_file_path"]
+        assets["garment_file_path"] = await file_client.upload_file(
+            file=garment_file_path
+        )
+        assets["person_file_path"] = await file_client.upload_file(
+            file=person_file_path
+        )
+
+        create_response = await self.create(
+            assets=assets, name=name, request_options=request_options
+        )
+        logger.info(f"AI Clothes Changer response: {create_response}")
+
+        image_projects_client = AsyncImageProjectsClient(base_client=self._base_client)
+        response = await image_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.PostV1AiClothesChangerBodyAssets,
+        assets: params.V1AiClothesChangerCreateBodyAssets,
         name: typing.Union[
             typing.Optional[str], type_utils.NotGiven
         ] = type_utils.NOT_GIVEN,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> models.PostV1AiClothesChangerResponse:
+    ) -> models.V1AiClothesChangerCreateResponse:
         """
         AI Clothes Changer
 
-        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.
+        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
 
         POST /v1/ai-clothes-changer
 
         Args:
-            name: The name of image
+            name: The name of image. This value is mainly used for your own identification of the image.
             assets: Provide the assets for clothes changer
             request_options: Additional options to customize the HTTP request
 
@@ -106,7 +251,7 @@ class AsyncAiClothesChangerClient:
         await client.v1.ai_clothes_changer.create(
             assets={
                 "garment_file_path": "api-assets/id/outfit.png",
-                "garment_type": "dresses",
+                "garment_type": "upper_body",
                 "person_file_path": "api-assets/id/model.png",
             },
             name="Clothes Changer image",
@@ -115,13 +260,13 @@ class AsyncAiClothesChangerClient:
         """
         _json = to_encodable(
             item={"name": name, "assets": assets},
-            dump_with=params._SerializerPostV1AiClothesChangerBody,
+            dump_with=params._SerializerV1AiClothesChangerCreateBody,
         )
         return await self._base_client.request(
             method="POST",
             path="/v1/ai-clothes-changer",
             auth_names=["bearerAuth"],
             json=_json,
-            cast_to=models.PostV1AiClothesChangerResponse,
+            cast_to=models.V1AiClothesChangerCreateResponse,
             request_options=request_options or default_request_options(),
         )