magic_hour 0.39.0__py3-none-any.whl → 0.41.0__py3-none-any.whl

magic_hour/README.md

@@ -14,7 +14,9 @@
 - [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_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

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.39.1"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.41.0"
 
 
 def _get_base_url(

magic_hour/resources/v1/README.md

@@ -14,7 +14,9 @@
 - [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_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

magic_hour/resources/v1/ai_clothes_changer/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### AI Clothes Changer Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_face_editor/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Face Editor Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_gif_generator/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Gif Generator Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_headshot_generator/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Headshot Generator Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_image_editor/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Image Editor Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_image_generator/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Image Generator Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_image_upscaler/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Image Upscaler Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_meme_generator/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Meme Generator Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_photo_editor/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Photo Editor Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_qr_code_generator/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Qr Code Generator Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/ai_talking_photo/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Talking Photo Generate Workflow <a name="generate"></a>
@@ -84,8 +86,8 @@ Create a talking photo from an image and audio or text input.
 | `end_seconds` | ✓ | The end time of the input audio in seconds. The maximum duration allowed is 60 seconds. | `15.0` |
 | `start_seconds` | ✓ | The start time of the input audio in seconds. The maximum duration allowed is 60 seconds. | `0.0` |
 | `name` | ✗ | The name of image. This value is mainly used for your own identification of the image. | `"Talking Photo image"` |
-| `style` | ✗ | Attributes used to dictate the style of the output | `{"generation_mode": "expressive", "intensity": 1.5}` |
-| `└─ generation_mode` | ✗ | Controls overall motion style. * `pro` -  Realistic, high fidelity, accurate lip sync, slower. * `expressive` - More motion and facial expressiveness; may introduce visual artifacts. * `stable` -  Reduced motion for cleaner output; may result in minimal animation. (Deprecated: passing this value will be treated as `pro`) | `"expressive"` |
+| `style` | ✗ | Attributes used to dictate the style of the output | `{"generation_mode": "pro", "intensity": 1.5}` |
+| `└─ generation_mode` | ✗ | Controls overall motion style. * `pro` -  Higher fidelity, realistic detail, accurate lip sync, and faster generation. * `standard` -  More expressive motion, but lower visual fidelity.  * `expressive` - More motion and facial expressiveness; may introduce visual artifacts. (Deprecated: passing this value will be treated as `standard`) * `stable` -  Reduced motion for cleaner output; may result in minimal animation. (Deprecated: passing this value will be treated as `pro`) | `"pro"` |
 | `└─ intensity` | ✗ | Note: this value is only applicable when generation_mode is `expressive`. The value can include up to 2 decimal places. * Lower values yield more stability but can suppress mouth movement. * Higher values increase motion and expressiveness, with a higher risk of distortion. | `1.5` |
 
 #### Synchronous Client

magic_hour/resources/v1/ai_voice_generator/README.md

@@ -0,0 +1,56 @@
+# v1.ai_voice_generator
+
+## Module Functions
+
+### AI Voice Generator <a name="create"></a>
+
+Generate speech from text. Each character costs 0.05 credits. The cost is rounded up to the nearest whole number.
+
+**API Endpoint**: `POST /v1/ai-voice-generator`
+
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `style` | ✓ | The content used to generate speech. | `{"prompt": "Hello, how are you?", "voice_name": "Elon Musk"}` |
+| `└─ prompt` | ✓ | Text used to generate speech. Starter tier users can use up to 200 characters, while Creator, Pro, or Business users can use up to 1000. | `"Hello, how are you?"` |
+| `└─ voice_name` | ✓ | The voice to use for the speech. Available voices: Elon Musk, Mark Zuckerberg, Joe Rogan, Barack Obama, Morgan Freeman, Kanye West, Donald Trump, Joe Biden, Kim Kardashian, Taylor Swift | `"Elon Musk"` |
+| `name` | ✗ | The name of audio. This value is mainly used for your own identification of the audio. | `"Voice Generator audio"` |
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.ai_voice_generator.create(
+    style={"prompt": "Hello, how are you?", "voice_name": "Elon Musk"},
+    name="Voice Generator audio",
+)
+
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.ai_voice_generator.create(
+    style={"prompt": "Hello, how are you?", "voice_name": "Elon Musk"},
+    name="Voice Generator audio",
+)
+
+```
+
+#### Response
+
+##### Type
+[V1AiVoiceGeneratorCreateResponse](/magic_hour/types/models/v1_ai_voice_generator_create_response.py)
+
+##### Example
+`{"credits_charged": 1, "id": "cuid-example"}`
+
+

magic_hour/resources/v1/ai_voice_generator/__init__.py

@@ -0,0 +1,4 @@
+from .client import AiVoiceGeneratorClient, AsyncAiVoiceGeneratorClient
+
+
+__all__ = ["AiVoiceGeneratorClient", "AsyncAiVoiceGeneratorClient"]

magic_hour/resources/v1/ai_voice_generator/client.py

@@ -0,0 +1,119 @@
+import typing
+
+from magic_hour.types import models, params
+from make_api_request import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+    to_encodable,
+    type_utils,
+)
+
+
+class AiVoiceGeneratorClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def create(
+        self,
+        *,
+        style: params.V1AiVoiceGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiVoiceGeneratorCreateResponse:
+        """
+        AI Voice Generator
+
+        Generate speech from text. Each character costs 0.05 credits. The cost is rounded up to the nearest whole number.
+
+        POST /v1/ai-voice-generator
+
+        Args:
+            name: The name of audio. This value is mainly used for your own identification of the audio.
+            style: The content used to generate speech.
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        client.v1.ai_voice_generator.create(
+            style={"prompt": "Hello, how are you?", "voice_name": "Elon Musk"},
+            name="Voice Generator audio",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={"name": name, "style": style},
+            dump_with=params._SerializerV1AiVoiceGeneratorCreateBody,
+        )
+        return self._base_client.request(
+            method="POST",
+            path="/v1/ai-voice-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiVoiceGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAiVoiceGeneratorClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def create(
+        self,
+        *,
+        style: params.V1AiVoiceGeneratorCreateBodyStyle,
+        name: typing.Union[
+            typing.Optional[str], type_utils.NotGiven
+        ] = type_utils.NOT_GIVEN,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> models.V1AiVoiceGeneratorCreateResponse:
+        """
+        AI Voice Generator
+
+        Generate speech from text. Each character costs 0.05 credits. The cost is rounded up to the nearest whole number.
+
+        POST /v1/ai-voice-generator
+
+        Args:
+            name: The name of audio. This value is mainly used for your own identification of the audio.
+            style: The content used to generate speech.
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        await client.v1.ai_voice_generator.create(
+            style={"prompt": "Hello, how are you?", "voice_name": "Elon Musk"},
+            name="Voice Generator audio",
+        )
+        ```
+        """
+        _json = to_encodable(
+            item={"name": name, "style": style},
+            dump_with=params._SerializerV1AiVoiceGeneratorCreateBody,
+        )
+        return await self._base_client.request(
+            method="POST",
+            path="/v1/ai-voice-generator",
+            auth_names=["bearerAuth"],
+            json=_json,
+            cast_to=models.V1AiVoiceGeneratorCreateResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/animation/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Animation Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/audio_projects/README.md

@@ -0,0 +1,90 @@
+# v1.audio_projects
+
+## Module Functions
+
+### Delete audio <a name="delete"></a>
+
+Permanently delete the rendered audio file(s). This action is not reversible, please be sure before deleting.
+
+**API Endpoint**: `DELETE /v1/audio-projects/{id}`
+
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `id` | ✓ | Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio. | `"cuid-example"` |
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.audio_projects.delete(id="cuid-example")
+
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.audio_projects.delete(id="cuid-example")
+
+```
+
+### Get audio details <a name="get"></a>
+
+Get the details of a audio project. The `downloads` field will be empty unless the audio was successfully rendered.
+
+The audio can be one of the following status
+- `draft` - not currently used
+- `queued` - the job is queued and waiting for a GPU
+- `rendering` - the generation is in progress
+- `complete` - the audio is successful created
+- `error` - an error occurred during rendering
+- `canceled` - audio render is canceled by the user
+
+
+**API Endpoint**: `GET /v1/audio-projects/{id}`
+
+#### Parameters
+
+| Parameter | Required | Description | Example |
+|-----------|:--------:|-------------|--------|
+| `id` | ✓ | Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio. | `"cuid-example"` |
+
+#### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+res = client.v1.audio_projects.get(id="cuid-example")
+
+```
+
+#### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+res = await client.v1.audio_projects.get(id="cuid-example")
+
+```
+
+#### Response
+
+##### Type
+[V1AudioProjectsGetResponse](/magic_hour/types/models/v1_audio_projects_get_response.py)
+
+##### Example
+`{"created_at": "1970-01-01T00:00:00", "credits_charged": 2, "downloads": [{"expires_at": "2024-10-19T05:16:19.027Z", "url": "https://videos.magichour.ai/id/output.wav"}], "enabled": True, "error": {"code": "no_source_face", "message": "Please use an image with a detectable face"}, "id": "cuid-example", "name": "Example Name", "status": "complete", "type_": "VOICE_GENERATOR"}`
+
+

magic_hour/resources/v1/audio_projects/__init__.py

@@ -0,0 +1,4 @@
+from .client import AsyncAudioProjectsClient, AudioProjectsClient
+
+
+__all__ = ["AsyncAudioProjectsClient", "AudioProjectsClient"]

magic_hour/resources/v1/audio_projects/client.py

@@ -0,0 +1,173 @@
+import typing
+
+from magic_hour.types import models
+from make_api_request import (
+    AsyncBaseClient,
+    RequestOptions,
+    SyncBaseClient,
+    default_request_options,
+)
+
+
+class AudioProjectsClient:
+    def __init__(self, *, base_client: SyncBaseClient):
+        self._base_client = base_client
+
+    def delete(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> None:
+        """
+        Delete audio
+
+        Permanently delete the rendered audio file(s). This action is not reversible, please be sure before deleting.
+
+        DELETE /v1/audio-projects/{id}
+
+        Args:
+            id: Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio.
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            204
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        client.v1.audio_projects.delete(id="cuid-example")
+        ```
+        """
+        self._base_client.request(
+            method="DELETE",
+            path=f"/v1/audio-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=type(None),
+            request_options=request_options or default_request_options(),
+        )
+
+    def get(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> models.V1AudioProjectsGetResponse:
+        """
+        Get audio details
+
+        Get the details of a audio project. The `downloads` field will be empty unless the audio was successfully rendered.
+
+        The audio can be one of the following status
+        - `draft` - not currently used
+        - `queued` - the job is queued and waiting for a GPU
+        - `rendering` - the generation is in progress
+        - `complete` - the audio is successful created
+        - `error` - an error occurred during rendering
+        - `canceled` - audio render is canceled by the user
+
+
+        GET /v1/audio-projects/{id}
+
+        Args:
+            id: Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio.
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        client.v1.audio_projects.get(id="cuid-example")
+        ```
+        """
+        return self._base_client.request(
+            method="GET",
+            path=f"/v1/audio-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=models.V1AudioProjectsGetResponse,
+            request_options=request_options or default_request_options(),
+        )
+
+
+class AsyncAudioProjectsClient:
+    def __init__(self, *, base_client: AsyncBaseClient):
+        self._base_client = base_client
+
+    async def delete(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> None:
+        """
+        Delete audio
+
+        Permanently delete the rendered audio file(s). This action is not reversible, please be sure before deleting.
+
+        DELETE /v1/audio-projects/{id}
+
+        Args:
+            id: Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio.
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            204
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        await client.v1.audio_projects.delete(id="cuid-example")
+        ```
+        """
+        await self._base_client.request(
+            method="DELETE",
+            path=f"/v1/audio-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=type(None),
+            request_options=request_options or default_request_options(),
+        )
+
+    async def get(
+        self, *, id: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> models.V1AudioProjectsGetResponse:
+        """
+        Get audio details
+
+        Get the details of a audio project. The `downloads` field will be empty unless the audio was successfully rendered.
+
+        The audio can be one of the following status
+        - `draft` - not currently used
+        - `queued` - the job is queued and waiting for a GPU
+        - `rendering` - the generation is in progress
+        - `complete` - the audio is successful created
+        - `error` - an error occurred during rendering
+        - `canceled` - audio render is canceled by the user
+
+
+        GET /v1/audio-projects/{id}
+
+        Args:
+            id: Unique ID of the audio project. This value is returned by all of the POST APIs that create an audio.
+            request_options: Additional options to customize the HTTP request
+
+        Returns:
+            Success
+
+        Raises:
+            ApiError: A custom exception class that provides additional context
+                for API errors, including the HTTP status code and response body.
+
+        Examples:
+        ```py
+        await client.v1.audio_projects.get(id="cuid-example")
+        ```
+        """
+        return await self._base_client.request(
+            method="GET",
+            path=f"/v1/audio-projects/{id}",
+            auth_names=["bearerAuth"],
+            cast_to=models.V1AudioProjectsGetResponse,
+            request_options=request_options or default_request_options(),
+        )

magic_hour/resources/v1/auto_subtitle_generator/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Auto Subtitle Generator Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/client.py

@@ -42,7 +42,15 @@ from magic_hour.resources.v1.ai_talking_photo import (
     AiTalkingPhotoClient,
     AsyncAiTalkingPhotoClient,
 )
+from magic_hour.resources.v1.ai_voice_generator import (
+    AiVoiceGeneratorClient,
+    AsyncAiVoiceGeneratorClient,
+)
 from magic_hour.resources.v1.animation import AnimationClient, AsyncAnimationClient
+from magic_hour.resources.v1.audio_projects import (
+    AsyncAudioProjectsClient,
+    AudioProjectsClient,
+)
 from magic_hour.resources.v1.auto_subtitle_generator import (
     AsyncAutoSubtitleGeneratorClient,
     AutoSubtitleGeneratorClient,
@@ -125,6 +133,8 @@ class V1Client:
         self.photo_colorizer = PhotoColorizerClient(base_client=self._base_client)
         self.text_to_video = TextToVideoClient(base_client=self._base_client)
         self.video_to_video = VideoToVideoClient(base_client=self._base_client)
+        self.audio_projects = AudioProjectsClient(base_client=self._base_client)
+        self.ai_voice_generator = AiVoiceGeneratorClient(base_client=self._base_client)
 
 
 class AsyncV1Client:
@@ -171,3 +181,7 @@ class AsyncV1Client:
         self.photo_colorizer = AsyncPhotoColorizerClient(base_client=self._base_client)
         self.text_to_video = AsyncTextToVideoClient(base_client=self._base_client)
         self.video_to_video = AsyncVideoToVideoClient(base_client=self._base_client)
+        self.audio_projects = AsyncAudioProjectsClient(base_client=self._base_client)
+        self.ai_voice_generator = AsyncAiVoiceGeneratorClient(
+            base_client=self._base_client
+        )

magic_hour/resources/v1/face_detection/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Face Detection Generate Workflow <a name="generate"></a>

magic_hour/resources/v1/face_swap/README.md

@@ -3,6 +3,8 @@
 ## Module Functions
 
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Face Swap Generate Workflow <a name="generate"></a>