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

magic_hour/README.md

@@ -0,0 +1,35 @@
+# Root Client
+
+<!-- CUSTOM DOCS START -->
+
+<!-- CUSTOM DOCS END -->
+
+## 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
+- [animation](resources/v1/animation/README.md) - animation
+- [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/core/base_client.py

@@ -15,7 +15,8 @@ from pydantic import BaseModel
 
 from .api_error import ApiError
 from .auth import AuthProvider
-from .request import RequestConfig, RequestOptions, default_request_options, QueryParams
+from .request import RequestConfig, RequestOptions, default_request_options
+from .query import QueryParams
 from .response import from_encodable, AsyncStreamResponse, StreamResponse
 from .utils import get_response_type, filter_binary_response
 from .binary_response import BinaryResponse
@@ -51,7 +52,7 @@ class BaseClient:
         )
         self._auths: Dict[str, AuthProvider] = auths or {}
 
-    def register_auth(self, auth_id: str, provider: AuthProvider):
+    def register_auth(self, auth_id: str, provider: AuthProvider) -> None:
         """Register an authentication provider.
 
         Args:
@@ -297,7 +298,7 @@ class BaseClient:
     def process_response(
         self,
         *,
-        response=httpx.Response,
+        response: httpx.Response,
         cast_to: Union[Type[T], Any],
     ) -> T:
         """Process an HTTP response and convert it to the desired type.
@@ -325,8 +326,8 @@ class BaseClient:
 
         if response_type == "json":
             if cast_to is type(Any):
-                return response.json()
-            return from_encodable(
+                return response.json()  # type: ignore[no-any-return]
+            return from_encodable(  # type: ignore[no-any-return]
                 data=response.json(), load_with=filter_binary_response(cast_to=cast_to)
             )
         elif response_type == "text":

magic_hour/core/query.py

@@ -19,7 +19,7 @@ def encode_query_param(
     value: Any,
     style: QueryParamStyle = "form",
     explode: bool = True,
-):
+) -> None:
     if style == "form":
         _encode_form(params, name, value, explode)
     elif style == "spaceDelimited":
@@ -39,7 +39,7 @@ def _query_str(val: Any) -> str:
     return json.dumps(val)
 
 
-def _encode_form(params: QueryParams, name: str, value: Any, explode: bool):
+def _encode_form(params: QueryParams, name: str, value: Any, explode: bool) -> None:
     """
     Encodes query params in the `form` style as defined by OpenAPI with both explode and non-explode
     variants.
@@ -63,7 +63,9 @@ def _encode_form(params: QueryParams, name: str, value: Any, explode: bool):
         params[name] = value
 
 
-def _encode_spaced_delimited(params: QueryParams, name: str, value: Any, explode: bool):
+def _encode_spaced_delimited(
+    params: QueryParams, name: str, value: Any, explode: bool
+) -> None:
     """
     Encodes query params in the `spaceDelimited` style as defined by OpenAPI with both explode and non-explode
     variants.
@@ -78,7 +80,9 @@ def _encode_spaced_delimited(params: QueryParams, name: str, value: Any, explode
         _encode_form(params, name, value, explode)
 
 
-def _encode_pipe_delimited(params: QueryParams, name: str, value: Any, explode: bool):
+def _encode_pipe_delimited(
+    params: QueryParams, name: str, value: Any, explode: bool
+) -> None:
     """
     Encodes query params in the `pipeDelimited` style as defined by OpenAPI with both explode and non-explode
     variants.
@@ -93,7 +97,9 @@ def _encode_pipe_delimited(params: QueryParams, name: str, value: Any, explode:
         _encode_form(params, name, value, explode)
 
 
-def _encode_deep_object(params: QueryParams, name: str, value: Any, explode: bool):
+def _encode_deep_object(
+    params: QueryParams, name: str, value: Any, explode: bool
+) -> None:
     """
     Encodes query params in the `deepObject` style as defined by with both explode and non-explode
     variants.
@@ -107,7 +113,7 @@ def _encode_deep_object(params: QueryParams, name: str, value: Any, explode: boo
         _encode_form(params, name, value, explode)
 
 
-def _encode_deep_object_key(params: QueryParams, key: str, value: Any):
+def _encode_deep_object_key(params: QueryParams, key: str, value: Any) -> None:
     if isinstance(value, dict):
         for k, v in value.items():
             _encode_deep_object_key(params, f"{key}[{k}]", v)

magic_hour/core/request.py

@@ -82,7 +82,7 @@ def model_dump(item: Any) -> Any:
 
 
 def to_encodable(
-    *, item: Any, dump_with: Union[Type, Union[Type, Any], List[Type]]
+    *, item: Any, dump_with: Union[Type[Any], Union[Type[Any], Any], List[Type[Any]]]
 ) -> Any:
     """
     Validates and converts an item to an encodable format using a specified type.
@@ -90,7 +90,7 @@ def to_encodable(
     to a format suitable for encoding in requests.
     """
     filtered_item = filter_not_given(item)
-    adapter: TypeAdapter = TypeAdapter(dump_with)
+    adapter: TypeAdapter[Any] = TypeAdapter(dump_with)
     validated_item = adapter.validate_python(filtered_item)
     return model_dump(validated_item)
 
@@ -98,7 +98,7 @@ def to_encodable(
 def to_form_urlencoded(
     *,
     item: Any,
-    dump_with: Union[Type, Union[Type, Any]],
+    dump_with: Union[Type[Any], Union[Type[Any], Any]],
     style: Mapping[str, QueryParamStyle],
     explode: Mapping[str, bool],
 ) -> Mapping[str, Any]:

magic_hour/core/response.py

@@ -49,7 +49,9 @@ class StreamResponse(Generic[T]):
     into the specified type.
     """
 
-    def __init__(self, response: httpx.Response, stream_context, cast_to: Type[T]):
+    def __init__(
+        self, response: httpx.Response, stream_context: Any, cast_to: Type[T]
+    ) -> None:
         """
         Initialize the stream processor with response and conversion settings.
 
@@ -65,7 +67,7 @@ class StreamResponse(Generic[T]):
         self.buffer = bytearray()
         self.position = 0
 
-    def __iter__(self):
+    def __iter__(self) -> "StreamResponse[T]":
         """Enables iteration over the stream events."""
         return self
 
@@ -95,7 +97,7 @@ class StreamResponse(Generic[T]):
             self._context.__exit__(None, None, None)
             raise
 
-    def _process_buffer(self, final=False) -> Optional[T]:
+    def _process_buffer(self, final: bool = False) -> Optional[T]:
         """
         Processes the current buffer to extract complete SSE events.
 
@@ -125,11 +127,11 @@ class StreamResponse(Generic[T]):
                                     or "data" not in parsed_data
                                 ):
                                     parsed_data = {"data": parsed_data}
-                                return from_encodable(
+                                return from_encodable(  # type: ignore[no-any-return]
                                     data=parsed_data, load_with=self.cast_to
                                 )
                             except json.JSONDecodeError:
-                                return from_encodable(
+                                return from_encodable(  # type: ignore[no-any-return]
                                     data={"data": data}, load_with=self.cast_to
                                 )
                         return None
@@ -144,9 +146,9 @@ class StreamResponse(Generic[T]):
                     parsed_data = json.loads(data)
                     if not isinstance(parsed_data, dict) or "data" not in parsed_data:
                         parsed_data = {"data": parsed_data}
-                    return from_encodable(data=parsed_data, load_with=self.cast_to)
+                    return from_encodable(data=parsed_data, load_with=self.cast_to)  # type: ignore[no-any-return]
                 except json.JSONDecodeError:
-                    return from_encodable(data={"data": data}, load_with=self.cast_to)
+                    return from_encodable(data={"data": data}, load_with=self.cast_to)  # type: ignore[no-any-return]
 
         return None
 
@@ -177,7 +179,9 @@ class AsyncStreamResponse(Generic[T]):
     but compatible with async/await syntax.
     """
 
-    def __init__(self, response: httpx.Response, stream_context, cast_to: Type[T]):
+    def __init__(
+        self, response: httpx.Response, stream_context: Any, cast_to: Type[T]
+    ) -> None:
         """
         Initialize the async stream processor.
 
@@ -193,7 +197,7 @@ class AsyncStreamResponse(Generic[T]):
         self.buffer = bytearray()
         self.position = 0
 
-    def __aiter__(self):
+    def __aiter__(self) -> "AsyncStreamResponse[T]":
         """Enables async iteration over the stream events."""
         return self
 
@@ -223,7 +227,7 @@ class AsyncStreamResponse(Generic[T]):
             await self._context.__aexit__(None, None, None)
             raise
 
-    def _process_buffer(self, final=False) -> Optional[T]:
+    def _process_buffer(self, final: bool = False) -> Optional[T]:
         """
         Processes the current buffer to extract complete SSE events.
 
@@ -249,11 +253,11 @@ class AsyncStreamResponse(Generic[T]):
                                     or "data" not in parsed_data
                                 ):
                                     parsed_data = {"data": parsed_data}
-                                return from_encodable(
+                                return from_encodable(  # type: ignore[no-any-return]
                                     data=parsed_data, load_with=self.cast_to
                                 )
                             except json.JSONDecodeError:
-                                return from_encodable(
+                                return from_encodable(  # type: ignore[no-any-return]
                                     data={"data": data}, load_with=self.cast_to
                                 )
                         return None
@@ -268,9 +272,9 @@ class AsyncStreamResponse(Generic[T]):
                     parsed_data = json.loads(data)
                     if not isinstance(parsed_data, dict) or "data" not in parsed_data:
                         parsed_data = {"data": parsed_data}
-                    return from_encodable(data=parsed_data, load_with=self.cast_to)
+                    return from_encodable(data=parsed_data, load_with=self.cast_to)  # type: ignore[no-any-return]
                 except json.JSONDecodeError:
-                    return from_encodable(data={"data": data}, load_with=self.cast_to)
+                    return from_encodable(data={"data": data}, load_with=self.cast_to)  # type: ignore[no-any-return]
 
         return None
 

magic_hour/core/utils.py

@@ -34,7 +34,7 @@ def is_union_type(type_hint: typing.Any) -> bool:
     return hasattr(type_hint, "__origin__") and type_hint.__origin__ is typing.Union
 
 
-def filter_binary_response(cast_to: typing.Type) -> typing.Type:
+def filter_binary_response(cast_to: typing.Type[typing.Any]) -> typing.Type[typing.Any]:
     """
     Filters out BinaryResponse from a Union type.
     If cast_to is not a Union, returns it unchanged.
@@ -50,6 +50,6 @@ def filter_binary_response(cast_to: typing.Type) -> typing.Type:
         return cast_to
     # If only one type remains, return it directly
     if len(filtered) == 1:
-        return typing.cast(typing.Type, filtered[0])
+        return typing.cast(typing.Type[typing.Any], filtered[0])
     # Otherwise return new Union with filtered types
-    return typing.cast(typing.Type, typing.Union[filtered])  # type: ignore
+    return typing.cast(typing.Type[typing.Any], typing.Union[filtered])

magic_hour/environment.py

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

magic_hour/helpers/__init__.py

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

magic_hour/helpers/download.py

@@ -0,0 +1,75 @@
+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],
+    ],
+    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],
+    ],
+    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/resources/v1/README.md

@@ -0,0 +1,33 @@
+# v1
+
+<!-- CUSTOM DOCS START -->
+
+<!-- CUSTOM DOCS END -->
+
+## 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
+- [animation](animation/README.md) - animation
+- [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,3 +1,72 @@
+# v1_ai_clothes_changer
+
+## Module Functions
+
+<!-- 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>
 
@@ -10,6 +79,9 @@ Change outfits in photos in seconds with just a photo reference. Each photo cost
 | 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
@@ -55,3 +127,4 @@ res = await client.v1.ai_clothes_changer.create(
 
 ##### Example
 `{"credits_charged": 25, "frame_cost": 25, "id": "cuid-example"}`
+

magic_hour/resources/v1/ai_clothes_changer/client.py

@@ -1,3 +1,4 @@
+import logging
 import typing
 
 from magic_hour.core import (
@@ -8,13 +9,88 @@ from magic_hour.core import (
     to_encodable,
     type_utils,
 )
+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
 
 
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__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,
         *,
@@ -73,6 +149,76 @@ 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,
         *,