magic_hour 0.38.1__tar.gz → 0.40.0__tar.gz

{magic_hour-0.38.1 → magic_hour-0.40.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.38.1
+Version: 0.40.0
 Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -223,11 +223,21 @@ download_urls = result.downloads
 * [create](magic_hour/resources/v1/ai_talking_photo/README.md#create) - AI Talking Photo
 * [generate](magic_hour/resources/v1/ai_talking_photo/README.md#generate) - Ai Talking Photo Generate Workflow
 
+### [v1.ai_voice_generator](magic_hour/resources/v1/ai_voice_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_voice_generator/README.md#create) - AI Voice Generator
+
 ### [v1.animation](magic_hour/resources/v1/animation/README.md)
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation
 * [generate](magic_hour/resources/v1/animation/README.md#generate) - Animation Generate Workflow
 
+### [v1.audio_projects](magic_hour/resources/v1/audio_projects/README.md)
+
+* [delete](magic_hour/resources/v1/audio_projects/README.md#delete) - Delete audio
+* [get](magic_hour/resources/v1/audio_projects/README.md#get) - Get audio details
+
+
 ### [v1.auto_subtitle_generator](magic_hour/resources/v1/auto_subtitle_generator/README.md)
 
 * [create](magic_hour/resources/v1/auto_subtitle_generator/README.md#create) - Auto Subtitle Generator

{magic_hour-0.38.1 → magic_hour-0.40.0}/README.md

@@ -208,11 +208,21 @@ download_urls = result.downloads
 * [create](magic_hour/resources/v1/ai_talking_photo/README.md#create) - AI Talking Photo
 * [generate](magic_hour/resources/v1/ai_talking_photo/README.md#generate) - Ai Talking Photo Generate Workflow
 
+### [v1.ai_voice_generator](magic_hour/resources/v1/ai_voice_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_voice_generator/README.md#create) - AI Voice Generator
+
 ### [v1.animation](magic_hour/resources/v1/animation/README.md)
 
 * [create](magic_hour/resources/v1/animation/README.md#create) - Animation
 * [generate](magic_hour/resources/v1/animation/README.md#generate) - Animation Generate Workflow
 
+### [v1.audio_projects](magic_hour/resources/v1/audio_projects/README.md)
+
+* [delete](magic_hour/resources/v1/audio_projects/README.md#delete) - Delete audio
+* [get](magic_hour/resources/v1/audio_projects/README.md#get) - Get audio details
+
+
 ### [v1.auto_subtitle_generator](magic_hour/resources/v1/auto_subtitle_generator/README.md)
 
 * [create](magic_hour/resources/v1/auto_subtitle_generator/README.md#create) - Auto Subtitle Generator

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/README.md

@@ -1,8 +1,6 @@
-# Root Client
+# Base Client
 
-<!-- CUSTOM DOCS START -->
 
-<!-- CUSTOM DOCS END -->
 
 ## Submodules
 - [ai_clothes_changer](resources/v1/ai_clothes_changer/README.md) - ai_clothes_changer
@@ -16,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-0.38.1 → magic_hour-0.40.0}/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.38.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.40.0"
 
 
 def _get_base_url(

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/README.md

@@ -1,8 +1,6 @@
 # v1
 
-<!-- CUSTOM DOCS START -->
 
-<!-- CUSTOM DOCS END -->
 
 ## Submodules
 - [ai_clothes_changer](ai_clothes_changer/README.md) - ai_clothes_changer
@@ -16,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-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_clothes_changer/README.md

@@ -1,7 +1,9 @@
-# v1_ai_clothes_changer
+# v1.ai_clothes_changer
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### AI Clothes Changer Generate Workflow <a name="generate"></a>
@@ -66,8 +68,6 @@ res = await client.v1.ai_clothes_changer.generate(
 ```
 
 <!-- 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.
@@ -128,3 +128,4 @@ res = await client.v1.ai_clothes_changer.create(
 ##### Example
 `{"credits_charged": 25, "frame_cost": 25, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_face_editor/README.md

@@ -1,7 +1,9 @@
-# v1_ai_face_editor
+# v1.ai_face_editor
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Face Editor Generate Workflow <a name="generate"></a>
@@ -91,7 +93,6 @@ res = await client.v1.ai_face_editor.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Face Editor <a name="create"></a>
 
 Edit facial features of an image using AI. Each edit costs 1 frame. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
@@ -192,3 +193,4 @@ res = await client.v1.ai_face_editor.create(
 ##### Example
 `{"credits_charged": 1, "frame_cost": 1, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_gif_generator/README.md

@@ -1,7 +1,9 @@
-# v1_ai_gif_generator
+# v1.ai_gif_generator
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Gif Generator Generate Workflow <a name="generate"></a>
@@ -59,7 +61,6 @@ res = await client.v1.ai_gif_generator.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI GIFs <a name="create"></a>
 
 Create an AI GIF. Each GIF costs 50 credits.
@@ -112,3 +113,5 @@ res = await client.v1.ai_gif_generator.create(
 
 ##### Example
 `{"credits_charged": 50, "frame_cost": 50, "id": "cuid-example"}`
+
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_headshot_generator/README.md

@@ -1,7 +1,9 @@
-# v1_ai_headshot_generator
+# v1.ai_headshot_generator
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Headshot Generator Generate Workflow <a name="generate"></a>
@@ -55,7 +57,6 @@ res = await client.v1.ai_headshot_generator.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Headshots <a name="create"></a>
 
 Create an AI headshot. Each headshot costs 50 credits.
@@ -106,3 +107,4 @@ res = await client.v1.ai_headshot_generator.create(
 ##### Example
 `{"credits_charged": 50, "frame_cost": 50, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_image_editor/README.md

@@ -1,7 +1,9 @@
-# v1_ai_image_editor
+# v1.ai_image_editor
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Image Editor Generate Workflow <a name="generate"></a>
@@ -59,7 +61,6 @@ res = await client.v1.ai_image_editor.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Image Editor <a name="create"></a>
 
 Edit images with AI. Each edit costs 50 credits.
@@ -114,3 +115,4 @@ res = await client.v1.ai_image_editor.create(
 ##### Example
 `{"credits_charged": 50, "frame_cost": 50, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_image_generator/README.md

@@ -1,7 +1,9 @@
-# v1_ai_image_generator
+# v1.ai_image_generator
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Image Generator Generate Workflow <a name="generate"></a>
@@ -61,7 +63,6 @@ res = await client.v1.ai_image_generator.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Images <a name="create"></a>
 
 Create an AI image. Each image costs 5 credits.
@@ -119,3 +120,4 @@ res = await client.v1.ai_image_generator.create(
 ##### Example
 `{"credits_charged": 5, "frame_cost": 5, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_image_upscaler/README.md

@@ -1,7 +1,9 @@
-# v1_ai_image_upscaler
+# v1.ai_image_upscaler
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Image Upscaler Generate Workflow <a name="generate"></a>
@@ -61,7 +63,6 @@ res = await client.v1.ai_image_upscaler.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Image Upscaler <a name="create"></a>
 
 Upscale your image using AI. Each 2x upscale costs 50 credits, and 4x upscale costs 200 credits.
@@ -120,3 +121,4 @@ res = await client.v1.ai_image_upscaler.create(
 ##### Example
 `{"credits_charged": 50, "frame_cost": 50, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_meme_generator/README.md

@@ -1,7 +1,9 @@
-# v1_ai_meme_generator
+# v1.ai_meme_generator
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Meme Generator Generate Workflow <a name="generate"></a>
@@ -65,7 +67,6 @@ res = await client.v1.ai_meme_generator.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Meme Generator <a name="create"></a>
 
 Create an AI generated meme. Each meme costs 10 credits.
@@ -126,3 +127,4 @@ res = await client.v1.ai_meme_generator.create(
 ##### Example
 `{"credits_charged": 10, "frame_cost": 10, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_photo_editor/README.md

@@ -1,7 +1,9 @@
-# v1_ai_photo_editor
+# v1.ai_photo_editor
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Photo Editor Generate Workflow <a name="generate"></a>
@@ -79,7 +81,6 @@ res = await client.v1.ai_photo_editor.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Photo Editor <a name="create"></a>
 
 > **NOTE**: this API is still in early development stages, and should be avoided. Please reach out to us if you're interested in this API. 
@@ -165,3 +166,4 @@ res = await client.v1.ai_photo_editor.create(
 ##### Example
 `{"credits_charged": 10, "frame_cost": 10, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_qr_code_generator/README.md

@@ -1,7 +1,9 @@
-# v1_ai_qr_code_generator
+# v1.ai_qr_code_generator
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Qr Code Generator Generate Workflow <a name="generate"></a>
@@ -59,7 +61,6 @@ res = await client.v1.ai_qr_code_generator.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI QR Code <a name="create"></a>
 
 Create an AI QR code. Each QR code costs 20 credits.
@@ -113,3 +114,4 @@ res = await client.v1.ai_qr_code_generator.create(
 ##### Example
 `{"credits_charged": 20, "frame_cost": 20, "id": "cuid-example"}`
 
+

{magic_hour-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/ai_talking_photo/README.md

@@ -1,7 +1,9 @@
-# v1_ai_talking_photo
+# v1.ai_talking_photo
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Ai Talking Photo Generate Workflow <a name="generate"></a>
@@ -67,7 +69,6 @@ res = await client.v1.ai_talking_photo.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### AI Talking Photo <a name="create"></a>
 
 Create a talking photo from an image and audio or text input.
@@ -85,7 +86,7 @@ Create a talking photo from an image and audio or text input.
 | `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. * `expressive` - More motion and facial expressiveness; may introduce visual artifacts. * `stable` -  Reduced motion for cleaner output; may result in minimal animation. | `"expressive"` |
+| `└─ 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"` |
 | `└─ 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
@@ -134,3 +135,4 @@ res = await client.v1.ai_talking_photo.create(
 ##### Example
 `{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}`
 
+

magic_hour-0.40.0/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-0.40.0/magic_hour/resources/v1/ai_voice_generator/__init__.py

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

magic_hour-0.40.0/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-0.38.1 → magic_hour-0.40.0}/magic_hour/resources/v1/animation/README.md

@@ -1,7 +1,9 @@
-# v1_animation
+# v1.animation
 
 ## Module Functions
 
+
+
 <!-- CUSTOM DOCS START -->
 
 ### Animation Generate Workflow <a name="generate"></a>
@@ -87,7 +89,6 @@ res = await client.v1.animation.generate(
 ```
 
 <!-- CUSTOM DOCS END -->
-
 ### Animation <a name="create"></a>
 
 Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
@@ -182,3 +183,4 @@ res = await client.v1.animation.create(
 ##### Example
 `{"credits_charged": 450, "estimated_frame_cost": 450, "id": "cuid-example"}`
 
+

magic_hour-0.40.0/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"}`
+
+