magic_hour 0.39.0__tar.gz → 0.41.0__tar.gz

{magic_hour-0.39.0 → magic_hour-0.41.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.39.0
+Version: 0.41.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.39.0 → magic_hour-0.41.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.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.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.39.1"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.41.0"
 
 
 def _get_base_url(

{magic_hour-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.39.0 → magic_hour-0.41.0}/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-0.41.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.41.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.41.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.39.0 → magic_hour-0.41.0}/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-0.41.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"}`
+
+

magic_hour-0.41.0/magic_hour/resources/v1/audio_projects/__init__.py

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

magic_hour-0.41.0/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(),
+        )