magic_hour 0.8.0__tar.gz

magic_hour-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Magic Hour AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

magic_hour-0.8.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.1
+Name: magic_hour
+Version: 0.8.0
+Summary: 
+Requires-Python: >=3.8,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: httpx (>=0.26.0,<0.27.0)
+Requires-Dist: jsonpointer (>=3.0.0,<4.0.0)
+Requires-Dist: pydantic (>=2.5.0,<3.0.0)
+Requires-Dist: typing_extensions (>=4.0.0,<5.0.0)
+Description-Content-Type: text/markdown
+
+
+# Magic Hour API Python SDK
+
+## Overview
+
+# Introduction 
+
+Magic Hour provides an API (beta) that can be integrated into your own application to generate videos using AI. 
+
+Webhook documentation can be found [here](https://magichour.ai/docs/webhook).
+
+If you have any questions, please reach out to us via [discord](https://discord.gg/JX5rgsZaJp).
+
+# Authentication
+
+Every request requires an API key.
+
+To get started, first generate your API key [here](https://magichour.ai/settings/developer).
+
+Then, add the `Authorization` header to the request.
+
+| Key | Value |
+|-|-|
+| Authorization | Bearer mhk_live_apikey |
+
+> **Warning**: any API call that renders a video will utilize frames in your account.
+
+
+### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+```
+
+### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+```
+
+## Module Documentation and Snippets
+
+### [v1.ai_clothes_changer](magic_hour/resources/v1/ai_clothes_changer/README.md)
+
+* [create](magic_hour/resources/v1/ai_clothes_changer/README.md#create) - AI Clothes Changer
+
+### [v1.ai_headshot_generator](magic_hour/resources/v1/ai_headshot_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_headshot_generator/README.md#create) - AI Headshots
+
+### [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
+
+### [v1.ai_image_upscaler](magic_hour/resources/v1/ai_image_upscaler/README.md)
+
+* [create](magic_hour/resources/v1/ai_image_upscaler/README.md#create) - AI Image Upscaler
+
+### [v1.ai_photo_editor](magic_hour/resources/v1/ai_photo_editor/README.md)
+
+* [create](magic_hour/resources/v1/ai_photo_editor/README.md#create) - AI Photo Editor
+
+### [v1.ai_qr_code_generator](magic_hour/resources/v1/ai_qr_code_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_qr_code_generator/README.md#create) - AI QR Code
+
+### [v1.animation](magic_hour/resources/v1/animation/README.md)
+
+* [create](magic_hour/resources/v1/animation/README.md#create) - Animation
+
+### [v1.face_swap](magic_hour/resources/v1/face_swap/README.md)
+
+* [create](magic_hour/resources/v1/face_swap/README.md#create) - Face Swap video
+
+### [v1.face_swap_photo](magic_hour/resources/v1/face_swap_photo/README.md)
+
+* [create](magic_hour/resources/v1/face_swap_photo/README.md#create) - Face Swap Photo
+
+### [v1.files.upload_urls](magic_hour/resources/v1/files/upload_urls/README.md)
+
+* [create](magic_hour/resources/v1/files/upload_urls/README.md#create) - Generate asset upload urls
+
+### [v1.image_background_remover](magic_hour/resources/v1/image_background_remover/README.md)
+
+* [create](magic_hour/resources/v1/image_background_remover/README.md#create) - Image Background Remover
+
+### [v1.image_projects](magic_hour/resources/v1/image_projects/README.md)
+
+* [delete](magic_hour/resources/v1/image_projects/README.md#delete) - Delete image
+* [get](magic_hour/resources/v1/image_projects/README.md#get) - Get image details
+
+### [v1.image_to_video](magic_hour/resources/v1/image_to_video/README.md)
+
+* [create](magic_hour/resources/v1/image_to_video/README.md#create) - Image-to-Video
+
+### [v1.lip_sync](magic_hour/resources/v1/lip_sync/README.md)
+
+* [create](magic_hour/resources/v1/lip_sync/README.md#create) - Lip Sync
+
+### [v1.text_to_video](magic_hour/resources/v1/text_to_video/README.md)
+
+* [create](magic_hour/resources/v1/text_to_video/README.md#create) - Text-to-Video
+
+### [v1.video_projects](magic_hour/resources/v1/video_projects/README.md)
+
+* [delete](magic_hour/resources/v1/video_projects/README.md#delete) - Delete video
+* [get](magic_hour/resources/v1/video_projects/README.md#get) - Get video details
+
+### [v1.video_to_video](magic_hour/resources/v1/video_to_video/README.md)
+
+* [create](magic_hour/resources/v1/video_to_video/README.md#create) - Video-to-Video
+
+<!-- MODULE DOCS END -->
+

magic_hour-0.8.0/README.md

@@ -0,0 +1,119 @@
+
+# Magic Hour API Python SDK
+
+## Overview
+
+# Introduction 
+
+Magic Hour provides an API (beta) that can be integrated into your own application to generate videos using AI. 
+
+Webhook documentation can be found [here](https://magichour.ai/docs/webhook).
+
+If you have any questions, please reach out to us via [discord](https://discord.gg/JX5rgsZaJp).
+
+# Authentication
+
+Every request requires an API key.
+
+To get started, first generate your API key [here](https://magichour.ai/settings/developer).
+
+Then, add the `Authorization` header to the request.
+
+| Key | Value |
+|-|-|
+| Authorization | Bearer mhk_live_apikey |
+
+> **Warning**: any API call that renders a video will utilize frames in your account.
+
+
+### Synchronous Client
+
+```python
+from magic_hour import Client
+from os import getenv
+
+client = Client(token=getenv("API_TOKEN"))
+```
+
+### Asynchronous Client
+
+```python
+from magic_hour import AsyncClient
+from os import getenv
+
+client = AsyncClient(token=getenv("API_TOKEN"))
+```
+
+## Module Documentation and Snippets
+
+### [v1.ai_clothes_changer](magic_hour/resources/v1/ai_clothes_changer/README.md)
+
+* [create](magic_hour/resources/v1/ai_clothes_changer/README.md#create) - AI Clothes Changer
+
+### [v1.ai_headshot_generator](magic_hour/resources/v1/ai_headshot_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_headshot_generator/README.md#create) - AI Headshots
+
+### [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
+
+### [v1.ai_image_upscaler](magic_hour/resources/v1/ai_image_upscaler/README.md)
+
+* [create](magic_hour/resources/v1/ai_image_upscaler/README.md#create) - AI Image Upscaler
+
+### [v1.ai_photo_editor](magic_hour/resources/v1/ai_photo_editor/README.md)
+
+* [create](magic_hour/resources/v1/ai_photo_editor/README.md#create) - AI Photo Editor
+
+### [v1.ai_qr_code_generator](magic_hour/resources/v1/ai_qr_code_generator/README.md)
+
+* [create](magic_hour/resources/v1/ai_qr_code_generator/README.md#create) - AI QR Code
+
+### [v1.animation](magic_hour/resources/v1/animation/README.md)
+
+* [create](magic_hour/resources/v1/animation/README.md#create) - Animation
+
+### [v1.face_swap](magic_hour/resources/v1/face_swap/README.md)
+
+* [create](magic_hour/resources/v1/face_swap/README.md#create) - Face Swap video
+
+### [v1.face_swap_photo](magic_hour/resources/v1/face_swap_photo/README.md)
+
+* [create](magic_hour/resources/v1/face_swap_photo/README.md#create) - Face Swap Photo
+
+### [v1.files.upload_urls](magic_hour/resources/v1/files/upload_urls/README.md)
+
+* [create](magic_hour/resources/v1/files/upload_urls/README.md#create) - Generate asset upload urls
+
+### [v1.image_background_remover](magic_hour/resources/v1/image_background_remover/README.md)
+
+* [create](magic_hour/resources/v1/image_background_remover/README.md#create) - Image Background Remover
+
+### [v1.image_projects](magic_hour/resources/v1/image_projects/README.md)
+
+* [delete](magic_hour/resources/v1/image_projects/README.md#delete) - Delete image
+* [get](magic_hour/resources/v1/image_projects/README.md#get) - Get image details
+
+### [v1.image_to_video](magic_hour/resources/v1/image_to_video/README.md)
+
+* [create](magic_hour/resources/v1/image_to_video/README.md#create) - Image-to-Video
+
+### [v1.lip_sync](magic_hour/resources/v1/lip_sync/README.md)
+
+* [create](magic_hour/resources/v1/lip_sync/README.md#create) - Lip Sync
+
+### [v1.text_to_video](magic_hour/resources/v1/text_to_video/README.md)
+
+* [create](magic_hour/resources/v1/text_to_video/README.md#create) - Text-to-Video
+
+### [v1.video_projects](magic_hour/resources/v1/video_projects/README.md)
+
+* [delete](magic_hour/resources/v1/video_projects/README.md#delete) - Delete video
+* [get](magic_hour/resources/v1/video_projects/README.md#get) - Get video details
+
+### [v1.video_to_video](magic_hour/resources/v1/video_to_video/README.md)
+
+* [create](magic_hour/resources/v1/video_to_video/README.md#create) - Video-to-Video
+
+<!-- MODULE DOCS END -->

magic_hour-0.8.0/magic_hour/__init__.py

@@ -0,0 +1,6 @@
+from .core import ApiError, BinaryResponse
+from .client import AsyncClient, Client
+from .environment import Environment
+
+
+__all__ = ["ApiError", "AsyncClient", "BinaryResponse", "Client", "Environment"]

magic_hour-0.8.0/magic_hour/client.py

@@ -0,0 +1,61 @@
+import httpx
+import typing
+
+from magic_hour.core import AsyncBaseClient, AuthBearer, SyncBaseClient
+from magic_hour.environment import Environment
+from magic_hour.resources.v1 import AsyncV1Client, V1Client
+
+
+class Client:
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = 60,
+        httpx_client: typing.Optional[httpx.Client] = None,
+        environment: Environment = Environment.ENVIRONMENT,
+        token: typing.Optional[str] = None,
+    ):
+        self._base_client = SyncBaseClient(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            httpx_client=(
+                httpx.Client(timeout=timeout) if httpx_client is None else httpx_client
+            ),
+        )
+
+        self.v1 = V1Client(base_client=self._base_client)
+        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
+
+
+class AsyncClient:
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = 60,
+        httpx_client: typing.Optional[httpx.AsyncClient] = None,
+        environment: Environment = Environment.ENVIRONMENT,
+        token: typing.Optional[str] = None,
+    ):
+        self._base_client = AsyncBaseClient(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            httpx_client=(
+                httpx.AsyncClient(timeout=timeout)
+                if httpx_client is None
+                else httpx_client
+            ),
+        )
+
+        self.v1 = AsyncV1Client(base_client=self._base_client)
+        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
+
+
+def _get_base_url(
+    *, base_url: typing.Optional[str] = None, environment: Environment
+) -> str:
+    if base_url is not None:
+        return base_url
+    elif environment is not None:
+        return environment.value
+    else:
+        raise Exception("Must include a base_url or environment arguments")

magic_hour-0.8.0/magic_hour/core/__init__.py

@@ -0,0 +1,53 @@
+from .api_error import ApiError
+from .auth import (
+    AuthKeyQuery,
+    AuthBasic,
+    AuthBearer,
+    AuthProvider,
+    AuthKeyCookie,
+    AuthKeyHeader,
+    GrantType,
+    OAuth2,
+    OAuth2ClientCredentialsForm,
+    OAuth2PasswordForm,
+)
+from .base_client import AsyncBaseClient, BaseClient, SyncBaseClient
+from .binary_response import BinaryResponse
+from .request import (
+    encode_param,
+    filter_not_given,
+    to_content,
+    to_encodable,
+    RequestOptions,
+    default_request_options,
+    QueryParams,
+)
+from .response import from_encodable, AsyncStreamResponse, StreamResponse
+
+__all__ = [
+    "ApiError",
+    "AsyncBaseClient",
+    "BaseClient",
+    "BinaryResponse",
+    "RequestOptions",
+    "default_request_options",
+    "SyncBaseClient",
+    "AuthKeyQuery",
+    "AuthBasic",
+    "AuthBearer",
+    "AuthProvider",
+    "AuthKeyCookie",
+    "AuthKeyHeader",
+    "GrantType",
+    "OAuth2",
+    "OAuth2ClientCredentialsForm",
+    "OAuth2PasswordForm",
+    "to_encodable",
+    "filter_not_given",
+    "to_content",
+    "encode_param",
+    "from_encodable",
+    "AsyncStreamResponse",
+    "StreamResponse",
+    "QueryParams",
+]

magic_hour-0.8.0/magic_hour/core/api_error.py

@@ -0,0 +1,48 @@
+import typing
+
+
+class ApiError(Exception):
+    """
+    A custom exception class for handling API-related errors.
+
+    This class extends the base Exception class to provide additional context
+    for API errors, including the HTTP status code and response body.
+
+    Attributes:
+        status_code: The HTTP status code associated with the error.
+            None if no status code is applicable.
+        body: The response body or error message content.
+            Can be any type depending on the API response format.
+    """
+
+    status_code: typing.Optional[int]
+    body: typing.Any
+
+    def __init__(
+        self, *, status_code: typing.Optional[int] = None, body: typing.Any = None
+    ) -> None:
+        """
+        Initialize the ApiError with optional status code and body.
+
+        Args:
+            status_code: The HTTP status code of the error.
+                Defaults to None.
+            body: The response body or error message content.
+                Defaults to None.
+
+        Note:
+            The asterisk (*) in the parameters forces keyword arguments,
+            making the instantiation more explicit.
+        """
+        self.status_code = status_code
+        self.body = body
+
+    def __str__(self) -> str:
+        """
+        Return a string representation of the ApiError.
+
+        Returns:
+            str: A formatted string containing the status code and body.
+                Format: "status_code: {status_code}, body: {body}"
+        """
+        return f"status_code: {self.status_code}, body: {self.body}"