magic_hour 0.23.0__py3-none-any.whl → 0.25.0__py3-none-any.whl

magic_hour/resources/v1/image_projects/README.md

@@ -5,6 +5,12 @@ Permanently delete the rendered image. This action is not reversible, please be
 
 **API Endpoint**: `DELETE /v1/image-projects/{id}`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `id` | ✓ | The id of the image project | `"cm6pvghix03bvyz0zwash6noj"` |
+
 #### Synchronous Client
 
 ```python
@@ -13,6 +19,7 @@ from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
 
 #### Asynchronous Client
@@ -23,6 +30,7 @@ from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
 
 ### Get image details <a name="get"></a>
@@ -40,6 +48,12 @@ The image can be one of the following status
 
 **API Endpoint**: `GET /v1/image-projects/{id}`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `id` | ✓ | The id of the image project | `"cm6pvghix03bvyz0zwash6noj"` |
+
 #### Synchronous Client
 
 ```python
@@ -48,6 +62,7 @@ from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.image_projects.get(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
 
 #### Asynchronous Client
@@ -58,4 +73,13 @@ from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.image_projects.get(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
+
+#### Response
+
+##### Type
+[V1ImageProjectsGetResponse](/magic_hour/types/models/v1_image_projects_get_response.py)
+
+##### Example
+`{"created_at": "1970-01-01T00:00:00", "credits_charged": 5, "downloads": [{"expires_at": "2024-10-19T05:16:19.027Z", "url": "https://videos.magichour.ai/id/output.png"}], "enabled": True, "error": {"code": "no_source_face", "message": "Please use an image with a detectable face"}, "id": "clx7uu86w0a5qp55yxz315r6r", "image_count": 1, "name": "Example Name", "status": "complete", "total_frame_cost": 5, "type_": "AI_IMAGE"}`

magic_hour/resources/v1/image_to_video/README.md

@@ -8,6 +8,17 @@ Get more information about this mode at our [product page](/products/image-to-vi
 
 **API Endpoint**: `POST /v1/image-to-video`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `assets` | ✓ | Provide the assets for image-to-video. | `{"image_file_path": "api-assets/id/1234.png"}` |
+| `end_seconds` | ✓ | The total duration of the output video in seconds. | `5.0` |
+| `style` | ✓ | Attributed used to dictate the style of the output | `{"prompt": "a dog running"}` |
+| `height` | ✗ | This field does not affect the output video's resolution. The video's orientation will match that of the input image.  It is retained solely for backward compatibility and will be deprecated in the future. | `960` |
+| `name` | ✗ | The name of video | `"Image To Video video"` |
+| `width` | ✗ | This field does not affect the output video's resolution. The video's orientation will match that of the input image.  It is retained solely for backward compatibility and will be deprecated in the future. | `512` |
+
 #### Synchronous Client
 
 ```python
@@ -23,6 +34,7 @@ res = client.v1.image_to_video.create(
     name="Image To Video video",
     width=512,
 )
+
 ```
 
 #### Asynchronous Client
@@ -40,4 +52,13 @@ res = await client.v1.image_to_video.create(
     name="Image To Video video",
     width=512,
 )
+
 ```
+
+#### Response
+
+##### Type
+[V1ImageToVideoCreateResponse](/magic_hour/types/models/v1_image_to_video_create_response.py)
+
+##### Example
+`{"credits_charged": 450, "estimated_frame_cost": 450, "id": "clx7uu86w0a5qp55yxz315r6r"}`

magic_hour/resources/v1/lip_sync/README.md

@@ -8,6 +8,18 @@ Get more information about this mode at our [product page](/products/lip-sync).
 
 **API Endpoint**: `POST /v1/lip-sync`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `assets` | ✓ | Provide the assets for lip-sync. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used | `{"audio_file_path": "api-assets/id/1234.mp3", "video_file_path": "api-assets/id/1234.mp4", "video_source": "file"}` |
+| `end_seconds` | ✓ | The end time of the input video in seconds | `15.0` |
+| `start_seconds` | ✓ | The start time of the input video in seconds | `0.0` |
+| `height` | ✗ | Used to determine the dimensions of the output video.     * If height is provided, width will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio. * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.  Note: if the video's original resolution is less than the maximum, the video will not be resized.  See our [pricing page](https://magichour.ai/pricing) for more details. | `960` |
+| `max_fps_limit` | ✗ | Defines the maximum FPS (frames per second) for the output video. If the input video's FPS is lower than this limit, the output video will retain the input FPS. This is useful for reducing unnecessary frame usage in scenarios where high FPS is not required. | `12.0` |
+| `name` | ✗ | The name of video | `"Lip Sync video"` |
+| `width` | ✗ | Used to determine the dimensions of the output video.     * If width is provided, height will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio. * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.  Note: if the video's original resolution is less than the maximum, the video will not be resized.  See our [pricing page](https://magichour.ai/pricing) for more details. | `512` |
+
 #### Synchronous Client
 
 ```python
@@ -28,6 +40,7 @@ res = client.v1.lip_sync.create(
     name="Lip Sync video",
     width=512,
 )
+
 ```
 
 #### Asynchronous Client
@@ -50,4 +63,13 @@ res = await client.v1.lip_sync.create(
     name="Lip Sync video",
     width=512,
 )
+
 ```
+
+#### Response
+
+##### Type
+[V1LipSyncCreateResponse](/magic_hour/types/models/v1_lip_sync_create_response.py)
+
+##### Example
+`{"credits_charged": 450, "estimated_frame_cost": 450, "id": "clx7uu86w0a5qp55yxz315r6r"}`

magic_hour/resources/v1/photo_colorizer/README.md

@@ -5,6 +5,13 @@ Colorize image. Each image costs 5 credits.
 
 **API Endpoint**: `POST /v1/photo-colorizer`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `assets` | ✓ | Provide the assets for photo colorization | `{"image_file_path": "api-assets/id/1234.png"}` |
+| `name` | ✗ | The name of image | `"Photo Colorizer image"` |
+
 #### Synchronous Client
 
 ```python
@@ -15,6 +22,7 @@ client = Client(token=getenv("API_TOKEN"))
 res = client.v1.photo_colorizer.create(
     assets={"image_file_path": "api-assets/id/1234.png"}, name="Photo Colorizer image"
 )
+
 ```
 
 #### Asynchronous Client
@@ -27,4 +35,13 @@ client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.photo_colorizer.create(
     assets={"image_file_path": "api-assets/id/1234.png"}, name="Photo Colorizer image"
 )
+
 ```
+
+#### Response
+
+##### Type
+[V1PhotoColorizerCreateResponse](/magic_hour/types/models/v1_photo_colorizer_create_response.py)
+
+##### Example
+`{"credits_charged": 5, "frame_cost": 5, "id": "clx7uu86w0a5qp55yxz315r6r"}`

magic_hour/resources/v1/text_to_video/README.md

@@ -8,6 +8,15 @@ Get more information about this mode at our [product page](/products/text-to-vid
 
 **API Endpoint**: `POST /v1/text-to-video`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `end_seconds` | ✓ | The total duration of the output video in seconds. | `5.0` |
+| `orientation` | ✓ | Determines the orientation of the output video | `"landscape"` |
+| `style` | ✓ |  | `{"prompt": "a dog running"}` |
+| `name` | ✗ | The name of video | `"Text To Video video"` |
+
 #### Synchronous Client
 
 ```python
@@ -21,6 +30,7 @@ res = client.v1.text_to_video.create(
     style={"prompt": "a dog running"},
     name="Text To Video video",
 )
+
 ```
 
 #### Asynchronous Client
@@ -36,4 +46,13 @@ res = await client.v1.text_to_video.create(
     style={"prompt": "a dog running"},
     name="Text To Video video",
 )
+
 ```
+
+#### Response
+
+##### Type
+[V1TextToVideoCreateResponse](/magic_hour/types/models/v1_text_to_video_create_response.py)
+
+##### Example
+`{"credits_charged": 450, "estimated_frame_cost": 450, "id": "clx7uu86w0a5qp55yxz315r6r"}`

magic_hour/resources/v1/video_projects/README.md

@@ -5,6 +5,12 @@ Permanently delete the rendered video. This action is not reversible, please be
 
 **API Endpoint**: `DELETE /v1/video-projects/{id}`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `id` | ✓ | The id of the video project | `"cm6pvghix03bvyz0zwash6noj"` |
+
 #### Synchronous Client
 
 ```python
@@ -13,6 +19,7 @@ from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.video_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
 
 #### Asynchronous Client
@@ -23,6 +30,7 @@ from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.video_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
 
 ### Get video details <a name="get"></a>
@@ -40,6 +48,12 @@ The video can be one of the following status
 
 **API Endpoint**: `GET /v1/video-projects/{id}`
 
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `id` | ✓ | The id of the video | `"cm6pvghix03bvyz0zwash6noj"` |
+
 #### Synchronous Client
 
 ```python
@@ -48,6 +62,7 @@ from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.video_projects.get(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
 
 #### Asynchronous Client
@@ -58,4 +73,13 @@ from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.video_projects.get(id="cm6pvghix03bvyz0zwash6noj")
+
 ```
+
+#### Response
+
+##### Type
+[V1VideoProjectsGetResponse](/magic_hour/types/models/v1_video_projects_get_response.py)
+
+##### Example
+`{"created_at": "1970-01-01T00:00:00", "credits_charged": 450, "download": {"expires_at": "2024-10-19T05:16:19.027Z", "url": "https://videos.magichour.ai/id/output.mp4"}, "downloads": [{"expires_at": "2024-10-19T05:16:19.027Z", "url": "https://videos.magichour.ai/id/output.mp4"}], "enabled": True, "end_seconds": 15.0, "error": {"code": "no_source_face", "message": "Please use an image with a detectable face"}, "fps": 30.0, "height": 960, "id": "clx7uu86w0a5qp55yxz315r6r", "name": "Example Name", "start_seconds": 0.0, "status": "complete", "total_frame_cost": 450, "type_": "FACE_SWAP", "width": 512}`

magic_hour/resources/v1/video_to_video/README.md

@@ -8,6 +8,19 @@ Get more information about this mode at our [product page](/products/video-to-vi
 
 **API Endpoint**: `POST /v1/video-to-video`
 
+#### Parameters
+
+| Parameter | Required | 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"}` |
+| `end_seconds` | ✓ | The end time of the input video in seconds | `15.0` |
+| `start_seconds` | ✓ | The start time of the input video in seconds | `0.0` |
+| `style` | ✓ |  | `{"art_style": "3D Render", "model": "Absolute Reality", "prompt": "string", "prompt_type": "append_default", "version": "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` | ✗ | Used to determine the dimensions of the output video.     * If height is provided, width will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio. * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.  Note: if the video's original resolution is less than the maximum, the video will not be resized.  See our [pricing page](https://magichour.ai/pricing) for more details. | `960` |
+| `name` | ✗ | The name of video | `"Video To Video video"` |
+| `width` | ✗ | Used to determine the dimensions of the output video.     * If width is provided, height will also be required. The larger value between width and height will be used to determine the maximum output resolution while maintaining the original aspect ratio. * If both height and width are omitted, the video will be resized according to your subscription's maximum resolution, while preserving aspect ratio.  Note: if the video's original resolution is less than the maximum, the video will not be resized.  See our [pricing page](https://magichour.ai/pricing) for more details. | `512` |
+
 #### Synchronous Client
 
 ```python
@@ -31,6 +44,7 @@ res = client.v1.video_to_video.create(
     name="Video To Video video",
     width=512,
 )
+
 ```
 
 #### Asynchronous Client
@@ -56,4 +70,13 @@ res = await client.v1.video_to_video.create(
     name="Video To Video video",
     width=512,
 )
+
 ```
+
+#### Response
+
+##### Type
+[V1VideoToVideoCreateResponse](/magic_hour/types/models/v1_video_to_video_create_response.py)
+
+##### Example
+`{"credits_charged": 450, "estimated_frame_cost": 450, "id": "clx7uu86w0a5qp55yxz315r6r"}`

magic_hour/types/models/__init__.py

@@ -4,6 +4,7 @@ from .v1_ai_gif_generator_create_response import V1AiGifGeneratorCreateResponse
 from .v1_ai_headshot_generator_create_response import (
     V1AiHeadshotGeneratorCreateResponse,
 )
+from .v1_ai_image_editor_create_response import V1AiImageEditorCreateResponse
 from .v1_ai_image_generator_create_response import V1AiImageGeneratorCreateResponse
 from .v1_ai_image_upscaler_create_response import V1AiImageUpscalerCreateResponse
 from .v1_ai_meme_generator_create_response import V1AiMemeGeneratorCreateResponse
@@ -43,6 +44,7 @@ __all__ = [
     "V1AiFaceEditorCreateResponse",
     "V1AiGifGeneratorCreateResponse",
     "V1AiHeadshotGeneratorCreateResponse",
+    "V1AiImageEditorCreateResponse",
     "V1AiImageGeneratorCreateResponse",
     "V1AiImageUpscalerCreateResponse",
     "V1AiMemeGeneratorCreateResponse",

magic_hour/types/models/v1_ai_image_editor_create_response.py

@@ -0,0 +1,33 @@
+import pydantic
+
+
+class V1AiImageEditorCreateResponse(pydantic.BaseModel):
+    """
+    Success
+    """
+
+    model_config = pydantic.ConfigDict(
+        arbitrary_types_allowed=True,
+        populate_by_name=True,
+    )
+
+    credits_charged: int = pydantic.Field(
+        alias="credits_charged",
+    )
+    """
+    The amount of credits deducted from your account to generate the image. We charge credits right when the request is made. 
+    
+    If an error occurred while generating the image(s), credits will be refunded and this field will be updated to include the refund.
+    """
+    frame_cost: int = pydantic.Field(
+        alias="frame_cost",
+    )
+    """
+    Deprecated: Previously represented the number of frames (original name of our credit system) used for image generation. Use 'credits_charged' instead.
+    """
+    id: str = pydantic.Field(
+        alias="id",
+    )
+    """
+    Unique ID of the image. This value can be used in the [get image project API](https://docs.magichour.ai/api-reference/image-projects/get-image-details) to fetch additional details such as status
+    """

magic_hour/types/models/v1_image_projects_get_response.py

@@ -80,5 +80,5 @@ class V1ImageProjectsGetResponse(pydantic.BaseModel):
         alias="type",
     )
     """
-    The type of the image project. Possible values are AI_HEADSHOT, AI_IMAGE, IMAGE_UPSCALER, FACE_SWAP, PHOTO_EDITOR, QR_CODE, BACKGROUND_REMOVER, CLOTHES_CHANGER, AI_MEME, FACE_EDITOR, PHOTO_COLORIZER, AI_GIF
+    The type of the image project. Possible values are AI_HEADSHOT, AI_IMAGE, IMAGE_UPSCALER, FACE_SWAP, PHOTO_EDITOR, QR_CODE, BACKGROUND_REMOVER, CLOTHES_CHANGER, AI_MEME, FACE_EDITOR, PHOTO_COLORIZER, AI_GIF, AI_SELFIE, AI_IMAGE_EDITOR
     """

magic_hour/types/params/__init__.py

@@ -38,6 +38,18 @@ from .v1_ai_headshot_generator_create_body_style import (
     V1AiHeadshotGeneratorCreateBodyStyle,
     _SerializerV1AiHeadshotGeneratorCreateBodyStyle,
 )
+from .v1_ai_image_editor_create_body import (
+    V1AiImageEditorCreateBody,
+    _SerializerV1AiImageEditorCreateBody,
+)
+from .v1_ai_image_editor_create_body_assets import (
+    V1AiImageEditorCreateBodyAssets,
+    _SerializerV1AiImageEditorCreateBodyAssets,
+)
+from .v1_ai_image_editor_create_body_style import (
+    V1AiImageEditorCreateBodyStyle,
+    _SerializerV1AiImageEditorCreateBodyStyle,
+)
 from .v1_ai_image_generator_create_body import (
     V1AiImageGeneratorCreateBody,
     _SerializerV1AiImageGeneratorCreateBody,
@@ -200,6 +212,9 @@ __all__ = [
     "V1AiHeadshotGeneratorCreateBody",
     "V1AiHeadshotGeneratorCreateBodyAssets",
     "V1AiHeadshotGeneratorCreateBodyStyle",
+    "V1AiImageEditorCreateBody",
+    "V1AiImageEditorCreateBodyAssets",
+    "V1AiImageEditorCreateBodyStyle",
     "V1AiImageGeneratorCreateBody",
     "V1AiImageGeneratorCreateBodyStyle",
     "V1AiImageUpscalerCreateBody",
@@ -248,6 +263,9 @@ __all__ = [
     "_SerializerV1AiHeadshotGeneratorCreateBody",
     "_SerializerV1AiHeadshotGeneratorCreateBodyAssets",
     "_SerializerV1AiHeadshotGeneratorCreateBodyStyle",
+    "_SerializerV1AiImageEditorCreateBody",
+    "_SerializerV1AiImageEditorCreateBodyAssets",
+    "_SerializerV1AiImageEditorCreateBodyStyle",
     "_SerializerV1AiImageGeneratorCreateBody",
     "_SerializerV1AiImageGeneratorCreateBodyStyle",
     "_SerializerV1AiImageUpscalerCreateBody",

magic_hour/types/params/v1_ai_image_editor_create_body.py

@@ -0,0 +1,49 @@
+import pydantic
+import typing
+import typing_extensions
+
+from .v1_ai_image_editor_create_body_assets import (
+    V1AiImageEditorCreateBodyAssets,
+    _SerializerV1AiImageEditorCreateBodyAssets,
+)
+from .v1_ai_image_editor_create_body_style import (
+    V1AiImageEditorCreateBodyStyle,
+    _SerializerV1AiImageEditorCreateBodyStyle,
+)
+
+
+class V1AiImageEditorCreateBody(typing_extensions.TypedDict):
+    """
+    V1AiImageEditorCreateBody
+    """
+
+    assets: typing_extensions.Required[V1AiImageEditorCreateBodyAssets]
+    """
+    Provide the assets for image edit
+    """
+
+    name: typing_extensions.NotRequired[str]
+    """
+    The name of image
+    """
+
+    style: typing_extensions.Required[V1AiImageEditorCreateBodyStyle]
+
+
+class _SerializerV1AiImageEditorCreateBody(pydantic.BaseModel):
+    """
+    Serializer for V1AiImageEditorCreateBody handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    assets: _SerializerV1AiImageEditorCreateBodyAssets = pydantic.Field(
+        alias="assets",
+    )
+    name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
+    style: _SerializerV1AiImageEditorCreateBodyStyle = pydantic.Field(
+        alias="style",
+    )

magic_hour/types/params/v1_ai_image_editor_create_body_assets.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiImageEditorCreateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for image edit
+    """
+
+    image_file_path: typing_extensions.Required[str]
+    """
+    The image used in the edit. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    """
+
+
+class _SerializerV1AiImageEditorCreateBodyAssets(pydantic.BaseModel):
+    """
+    Serializer for V1AiImageEditorCreateBodyAssets handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    image_file_path: str = pydantic.Field(
+        alias="image_file_path",
+    )

magic_hour/types/params/v1_ai_image_editor_create_body_style.py

@@ -0,0 +1,28 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiImageEditorCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    V1AiImageEditorCreateBodyStyle
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    The prompt used to edit the image.
+    """
+
+
+class _SerializerV1AiImageEditorCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiImageEditorCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    prompt: str = pydantic.Field(
+        alias="prompt",
+    )

magic_hour/types/params/v1_ai_image_generator_create_body_style.py

@@ -1,4 +1,5 @@
 import pydantic
+import typing
 import typing_extensions
 
 
@@ -12,6 +13,49 @@ class V1AiImageGeneratorCreateBodyStyle(typing_extensions.TypedDict):
     The prompt used for the image.
     """
 
+    tool: typing_extensions.NotRequired[
+        typing_extensions.Literal[
+            "ai-anime-generator",
+            "ai-art-generator",
+            "ai-background-generator",
+            "ai-character-generator",
+            "ai-face-generator",
+            "ai-fashion-generator",
+            "ai-icon-generator",
+            "ai-illustration-generator",
+            "ai-interior-design-generator",
+            "ai-landscape-generator",
+            "ai-logo-generator",
+            "ai-manga-generator",
+            "ai-outfit-generator",
+            "ai-pattern-generator",
+            "ai-photo-generator",
+            "ai-sketch-generator",
+            "ai-tattoo-generator",
+            "album-cover-generator",
+            "animated-characters-generator",
+            "architecture-generator",
+            "book-cover-generator",
+            "comic-book-generator",
+            "dark-fantasy-ai",
+            "disney-ai-generator",
+            "dnd-ai-art-generator",
+            "emoji-generator",
+            "fantasy-map-generator",
+            "general",
+            "graffiti-generator",
+            "movie-poster-generator",
+            "optical-illusion-generator",
+            "pokemon-generator",
+            "south-park-character-generator",
+            "superhero-generator",
+            "thumbnail-maker",
+        ]
+    ]
+    """
+    The art style to use for image generation. Defaults to 'general' if not provided.
+    """
+
 
 class _SerializerV1AiImageGeneratorCreateBodyStyle(pydantic.BaseModel):
     """
@@ -26,3 +70,42 @@ class _SerializerV1AiImageGeneratorCreateBodyStyle(pydantic.BaseModel):
     prompt: str = pydantic.Field(
         alias="prompt",
     )
+    tool: typing.Optional[
+        typing_extensions.Literal[
+            "ai-anime-generator",
+            "ai-art-generator",
+            "ai-background-generator",
+            "ai-character-generator",
+            "ai-face-generator",
+            "ai-fashion-generator",
+            "ai-icon-generator",
+            "ai-illustration-generator",
+            "ai-interior-design-generator",
+            "ai-landscape-generator",
+            "ai-logo-generator",
+            "ai-manga-generator",
+            "ai-outfit-generator",
+            "ai-pattern-generator",
+            "ai-photo-generator",
+            "ai-sketch-generator",
+            "ai-tattoo-generator",
+            "album-cover-generator",
+            "animated-characters-generator",
+            "architecture-generator",
+            "book-cover-generator",
+            "comic-book-generator",
+            "dark-fantasy-ai",
+            "disney-ai-generator",
+            "dnd-ai-art-generator",
+            "emoji-generator",
+            "fantasy-map-generator",
+            "general",
+            "graffiti-generator",
+            "movie-poster-generator",
+            "optical-illusion-generator",
+            "pokemon-generator",
+            "south-park-character-generator",
+            "superhero-generator",
+            "thumbnail-maker",
+        ]
+    ] = pydantic.Field(alias="tool", default=None)

{magic_hour-0.23.0.dist-info → magic_hour-0.25.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.23.0
+Version: 0.25.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -75,6 +75,10 @@ client = AsyncClient(token="my api key")
 
 * [create](magic_hour/resources/v1/ai_headshot_generator/README.md#create) - AI Headshots
 
+### [v1.ai_image_editor](magic_hour/resources/v1/ai_image_editor/README.md)
+
+* [create](magic_hour/resources/v1/ai_image_editor/README.md#create) - AI Image Editor
+
 ### [v1.ai_image_generator](magic_hour/resources/v1/ai_image_generator/README.md)
 
 * [create](magic_hour/resources/v1/ai_image_generator/README.md#create) - AI Images