magic_hour 0.8.1__py3-none-any.whl → 0.8.3__py3-none-any.whl

magic_hour/client.py

@@ -1,9 +1,9 @@
 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
+from magic_hour.environment import Environment
+from magic_hour.core import AsyncBaseClient, AuthBearer, SyncBaseClient
 
 
 class Client:
@@ -22,9 +22,9 @@ class Client:
                 httpx.Client(timeout=timeout) if httpx_client is None else httpx_client
             ),
         )
+        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
 
         self.v1 = V1Client(base_client=self._base_client)
-        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
 
 
 class AsyncClient:
@@ -45,9 +45,9 @@ class AsyncClient:
                 else httpx_client
             ),
         )
+        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
 
         self.v1 = AsyncV1Client(base_client=self._base_client)
-        self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
 
 
 def _get_base_url(

magic_hour/core/api_error.py

@@ -1,4 +1,10 @@
+"""
+Generated by Sideko (sideko.dev)
+"""
+
+from json import JSONDecodeError
 import typing
+import httpx
 
 
 class ApiError(Exception):
@@ -13,29 +19,31 @@ class ApiError(Exception):
             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.
+        response: The raw httpx response object. See https://www.python-httpx.org/api/#response for object reference
     """
 
     status_code: typing.Optional[int]
     body: typing.Any
+    response: httpx.Response
 
-    def __init__(
-        self, *, status_code: typing.Optional[int] = None, body: typing.Any = None
-    ) -> None:
+    def __init__(self, *, response: httpx.Response) -> 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
+        try:
+            self.body = response.json()
+        except JSONDecodeError:
+            self.body = None
+        self.status_code = response.status_code
+        self.response = response
 
     def __str__(self) -> str:
         """

magic_hour/core/base_client.py

@@ -1,4 +1,3 @@
-from json import JSONDecodeError
 from typing import (
     Any,
     List,
@@ -9,6 +8,7 @@ from typing import (
     Union,
     cast,
 )
+from typing_extensions import TypeGuard
 
 import httpx
 from pydantic import BaseModel
@@ -17,7 +17,7 @@ from .api_error import ApiError
 from .auth import AuthProvider
 from .request import RequestConfig, RequestOptions, default_request_options, QueryParams
 from .response import from_encodable, AsyncStreamResponse, StreamResponse
-from .utils import is_binary_content_type, get_content_type
+from .utils import get_response_type, filter_binary_response
 from .binary_response import BinaryResponse
 
 NoneType = type(None)
@@ -96,6 +96,15 @@ class BaseClient:
 
         return f"{base}/{path}"
 
+    def _cast_to_raw_response(
+        self, res: httpx.Response, cast_to: Union[Type[T], Any]
+    ) -> TypeGuard[T]:
+        """Determines if the provided cast_to is an httpx.Response"""
+        try:
+            return issubclass(cast_to, httpx.Response)
+        except TypeError:
+            return False
+
     def _apply_auth(
         self, *, cfg: RequestConfig, auth_names: List[str]
     ) -> RequestConfig:
@@ -307,35 +316,30 @@ class BaseClient:
         Raises:
             ApiError: If the response indicates an error
         """
-        if 200 <= response.status_code < 300:
-            content_type = get_content_type(response.headers)
-            if response.status_code == 204 or cast_to == NoneType:
-                return cast(T, None)
-            elif cast_to == BinaryResponse:
-                return cast(
-                    T,
-                    BinaryResponse(content=response.content, headers=response.headers),
-                )
-            else:
-                if "json" in content_type or "form" in content_type:
-                    if cast_to is type(Any):
-                        return response.json()
-                    return from_encodable(data=response.json(), load_with=cast_to)
-                elif is_binary_content_type(content_type):
-                    return cast(
-                        T,
-                        BinaryResponse(
-                            content=response.content, headers=response.headers
-                        ),
-                    )
-                else:
-                    return from_encodable(data=response.content, load_with=cast_to)
+
+        if response.status_code == 204 or cast_to == NoneType:
+            return cast(T, None)
+        elif cast_to == BinaryResponse:
+            return cast(
+                T,
+                BinaryResponse(content=response.content, headers=response.headers),
+            )
+
+        response_type = get_response_type(response.headers)
+
+        if response_type == "json":
+            if cast_to is type(Any):
+                return response.json()
+            return from_encodable(
+                data=response.json(), load_with=filter_binary_response(cast_to=cast_to)
+            )
+        elif response_type == "text":
+            return cast(T, response.text)
         else:
-            try:
-                response_json = response.json()
-            except JSONDecodeError:
-                raise ApiError(status_code=response.status_code, body=response.text)
-            raise ApiError(status_code=response.status_code, body=response_json)
+            return cast(
+                T,
+                BinaryResponse(content=response.content, headers=response.headers),
+            )
 
 
 class SyncBaseClient(BaseClient):
@@ -411,6 +415,13 @@ class SyncBaseClient(BaseClient):
             request_options=request_options,
         )
         response = self.httpx_client.request(**req_cfg)
+
+        if not response.is_success:
+            raise ApiError(response=response)
+
+        if self._cast_to_raw_response(res=response, cast_to=cast_to):
+            return response
+
         return self.process_response(response=response, cast_to=cast_to)
 
     def stream_request(
@@ -542,6 +553,13 @@ class AsyncBaseClient(BaseClient):
             request_options=request_options,
         )
         response = await self.httpx_client.request(**req_cfg)
+
+        if not response.is_success:
+            raise ApiError(response=response)
+
+        if self._cast_to_raw_response(res=response, cast_to=cast_to):
+            return response
+
         return self.process_response(response=response, cast_to=cast_to)
 
     async def stream_request(

magic_hour/core/utils.py

@@ -1,6 +1,11 @@
 import typing
+import re
+from typing_extensions import Literal
+
 import httpx
 
+from .binary_response import BinaryResponse
+
 
 def remove_none_from_dict(
     original: typing.Dict[str, typing.Optional[typing.Any]],
@@ -12,27 +17,39 @@ def remove_none_from_dict(
     return new
 
 
-def is_binary_content_type(content_type: str) -> bool:
-    """Check if the content type indicates binary data."""
-    binary_types = [
-        "application/octet-stream",
-        "application/pdf",
-        "application/zip",
-        "image/",
-        "audio/",
-        "video/",
-        "application/msword",
-        "application/vnd.openxmlformats-officedocument",
-        "application/x-binary",
-        "application/vnd.ms-excel",
-        "application/vnd.ms-powerpoint",
-    ]
-    return any(binary_type in content_type for binary_type in binary_types)
-
-
-def get_content_type(headers: httpx.Headers) -> str:
-    """Get content type in a case-insensitive manner."""
-    for key, value in headers.items():
-        if key.lower() == "content-type":
-            return value.lower()
-    return ""
+def get_response_type(headers: httpx.Headers) -> Literal["json", "text", "binary"]:
+    """Check response type based on content type"""
+    content_type = headers.get("content-type")
+
+    if re.search("^application/(.+\+)?json", content_type):
+        return "json"
+    elif re.search("^text/(.+)", content_type):
+        return "text"
+    else:
+        return "binary"
+
+
+def is_union_type(type_hint: typing.Any) -> bool:
+    """Check if a type hint is a Union type."""
+    return hasattr(type_hint, "__origin__") and type_hint.__origin__ is typing.Union
+
+
+def filter_binary_response(cast_to: typing.Type) -> typing.Type:
+    """
+    Filters out BinaryResponse from a Union type.
+    If cast_to is not a Union, returns it unchanged.
+    """
+    if not is_union_type(cast_to):
+        return cast_to
+
+    types = typing.get_args(cast_to)
+    filtered = tuple(t for t in types if t != BinaryResponse)
+
+    # If everything was filtered out, return original type
+    if not filtered:
+        return cast_to
+    # If only one type remains, return it directly
+    if len(filtered) == 1:
+        return typing.cast(typing.Type, filtered[0])
+    # Otherwise return new Union with filtered types
+    return typing.cast(typing.Type, typing.Union[filtered])  # type: ignore

magic_hour/environment.py

@@ -3,4 +3,4 @@ import enum
 
 class Environment(enum.Enum):
     ENVIRONMENT = "https://api.magichour.ai"
-    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.8.1"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.8.3"

magic_hour/resources/v1/animation/README.md

@@ -19,8 +19,8 @@ res = client.v1.animation.create(
         "audio_source": "file",
         "image_file_path": "api-assets/id/1234.png",
     },
-    end_seconds=15,
-    fps=12,
+    end_seconds=15.0,
+    fps=12.0,
     height=960,
     style={
         "art_style": "Painterly Illustration",
@@ -47,8 +47,8 @@ res = await client.v1.animation.create(
         "audio_source": "file",
         "image_file_path": "api-assets/id/1234.png",
     },
-    end_seconds=15,
-    fps=12,
+    end_seconds=15.0,
+    fps=12.0,
     height=960,
     style={
         "art_style": "Painterly Illustration",

magic_hour/resources/v1/animation/client.py

@@ -57,8 +57,8 @@ class AnimationClient:
         ```py
         client.v1.animation.create(
             assets={"audio_source": "file"},
-            end_seconds=15,
-            fps=12,
+            end_seconds=15.0,
+            fps=12.0,
             height=960,
             style={
                 "art_style": "Painterly Illustration",
@@ -141,8 +141,8 @@ class AsyncAnimationClient:
         ```py
         await client.v1.animation.create(
             assets={"audio_source": "file"},
-            end_seconds=15,
-            fps=12,
+            end_seconds=15.0,
+            fps=12.0,
             height=960,
             style={
                 "art_style": "Painterly Illustration",

magic_hour/resources/v1/face_swap/README.md

@@ -22,9 +22,9 @@ res = client.v1.face_swap.create(
         "video_file_path": "video/id/1234.mp4",
         "video_source": "file",
     },
-    end_seconds=15,
+    end_seconds=15.0,
     height=960,
-    start_seconds=0,
+    start_seconds=0.0,
     width=512,
     name="Face Swap video",
 )
@@ -43,9 +43,9 @@ res = await client.v1.face_swap.create(
         "video_file_path": "video/id/1234.mp4",
         "video_source": "file",
     },
-    end_seconds=15,
+    end_seconds=15.0,
     height=960,
-    start_seconds=0,
+    start_seconds=0.0,
     width=512,
     name="Face Swap video",
 )

magic_hour/resources/v1/face_swap/client.py

@@ -58,9 +58,9 @@ class FaceSwapClient:
         ```py
         client.v1.face_swap.create(
             assets={"image_file_path": "image/id/1234.png", "video_source": "file"},
-            end_seconds=15,
+            end_seconds=15.0,
             height=960,
-            start_seconds=0,
+            start_seconds=0.0,
             width=512,
             name="Face Swap video",
         )
@@ -135,9 +135,9 @@ class AsyncFaceSwapClient:
         ```py
         await client.v1.face_swap.create(
             assets={"image_file_path": "image/id/1234.png", "video_source": "file"},
-            end_seconds=15,
+            end_seconds=15.0,
             height=960,
-            start_seconds=0,
+            start_seconds=0.0,
             width=512,
             name="Face Swap video",
         )

magic_hour/resources/v1/image_projects/README.md

@@ -13,7 +13,7 @@ from magic_hour import Client
 from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
-res = client.v1.image_projects.delete(id="string")
+res = client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
 #### Asynchronous Client
@@ -23,7 +23,7 @@ from magic_hour import AsyncClient
 from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
-res = await client.v1.image_projects.delete(id="string")
+res = await client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
 ### get <a name="get"></a>
@@ -49,7 +49,7 @@ from magic_hour import Client
 from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
-res = client.v1.image_projects.get(id="string")
+res = client.v1.image_projects.get(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
 #### Asynchronous Client
@@ -59,5 +59,5 @@ from magic_hour import AsyncClient
 from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
-res = await client.v1.image_projects.get(id="string")
+res = await client.v1.image_projects.get(id="cm6pvghix03bvyz0zwash6noj")
 ```

magic_hour/resources/v1/image_projects/client.py

@@ -36,7 +36,7 @@ class ImageProjectsClient:
 
         Examples:
         ```py
-        client.v1.image_projects.delete(id="string")
+        client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """
@@ -80,7 +80,7 @@ class ImageProjectsClient:
 
         Examples:
         ```py
-        client.v1.image_projects.get(id="string")
+        client.v1.image_projects.get(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """
@@ -120,7 +120,7 @@ class AsyncImageProjectsClient:
 
         Examples:
         ```py
-        await client.v1.image_projects.delete(id="string")
+        await client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """
@@ -164,7 +164,7 @@ class AsyncImageProjectsClient:
 
         Examples:
         ```py
-        await client.v1.image_projects.get(id="string")
+        await client.v1.image_projects.get(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """

magic_hour/resources/v1/image_to_video/README.md

@@ -18,7 +18,7 @@ from os import getenv
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.image_to_video.create(
     assets={"image_file_path": "image/id/1234.png"},
-    end_seconds=5,
+    end_seconds=5.0,
     height=960,
     style={"prompt": None},
     width=512,
@@ -35,7 +35,7 @@ from os import getenv
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.image_to_video.create(
     assets={"image_file_path": "image/id/1234.png"},
-    end_seconds=5,
+    end_seconds=5.0,
     height=960,
     style={"prompt": None},
     width=512,

magic_hour/resources/v1/image_to_video/client.py

@@ -58,7 +58,7 @@ class ImageToVideoClient:
         ```py
         client.v1.image_to_video.create(
             assets={"image_file_path": "image/id/1234.png"},
-            end_seconds=5,
+            end_seconds=5.0,
             height=960,
             style={"prompt": "string"},
             width=512,
@@ -135,7 +135,7 @@ class AsyncImageToVideoClient:
         ```py
         await client.v1.image_to_video.create(
             assets={"image_file_path": "image/id/1234.png"},
-            end_seconds=5,
+            end_seconds=5.0,
             height=960,
             style={"prompt": "string"},
             width=512,

magic_hour/resources/v1/lip_sync/README.md

@@ -22,11 +22,11 @@ res = client.v1.lip_sync.create(
         "video_file_path": "video/id/1234.mp4",
         "video_source": "file",
     },
-    end_seconds=15,
+    end_seconds=15.0,
     height=960,
-    start_seconds=0,
+    start_seconds=0.0,
     width=512,
-    max_fps_limit=12,
+    max_fps_limit=12.0,
     name="Lip Sync video",
 )
 ```
@@ -44,11 +44,11 @@ res = await client.v1.lip_sync.create(
         "video_file_path": "video/id/1234.mp4",
         "video_source": "file",
     },
-    end_seconds=15,
+    end_seconds=15.0,
     height=960,
-    start_seconds=0,
+    start_seconds=0.0,
     width=512,
-    max_fps_limit=12,
+    max_fps_limit=12.0,
     name="Lip Sync video",
 )
 ```

magic_hour/resources/v1/lip_sync/client.py

@@ -62,11 +62,11 @@ class LipSyncClient:
         ```py
         client.v1.lip_sync.create(
             assets={"audio_file_path": "audio/id/1234.mp3", "video_source": "file"},
-            end_seconds=15,
+            end_seconds=15.0,
             height=960,
-            start_seconds=0,
+            start_seconds=0.0,
             width=512,
-            max_fps_limit=12,
+            max_fps_limit=12.0,
             name="Lip Sync video",
         )
         ```
@@ -145,11 +145,11 @@ class AsyncLipSyncClient:
         ```py
         await client.v1.lip_sync.create(
             assets={"audio_file_path": "audio/id/1234.mp3", "video_source": "file"},
-            end_seconds=15,
+            end_seconds=15.0,
             height=960,
-            start_seconds=0,
+            start_seconds=0.0,
             width=512,
-            max_fps_limit=12,
+            max_fps_limit=12.0,
             name="Lip Sync video",
         )
         ```

magic_hour/resources/v1/text_to_video/README.md

@@ -17,7 +17,7 @@ from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.text_to_video.create(
-    end_seconds=5,
+    end_seconds=5.0,
     orientation="landscape",
     style={"prompt": "string"},
     name="Text To Video video",
@@ -32,7 +32,7 @@ from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.text_to_video.create(
-    end_seconds=5,
+    end_seconds=5.0,
     orientation="landscape",
     style={"prompt": "string"},
     name="Text To Video video",

magic_hour/resources/v1/text_to_video/client.py

@@ -54,7 +54,7 @@ class TextToVideoClient:
         Examples:
         ```py
         client.v1.text_to_video.create(
-            end_seconds=5,
+            end_seconds=5.0,
             orientation="landscape",
             style={"prompt": "string"},
             name="Text To Video video",
@@ -123,7 +123,7 @@ class AsyncTextToVideoClient:
         Examples:
         ```py
         await client.v1.text_to_video.create(
-            end_seconds=5,
+            end_seconds=5.0,
             orientation="landscape",
             style={"prompt": "string"},
             name="Text To Video video",

magic_hour/resources/v1/video_projects/README.md

@@ -13,7 +13,7 @@ from magic_hour import Client
 from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
-res = client.v1.video_projects.delete(id="string")
+res = client.v1.video_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
 #### Asynchronous Client
@@ -23,7 +23,7 @@ from magic_hour import AsyncClient
 from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
-res = await client.v1.video_projects.delete(id="string")
+res = await client.v1.video_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
 ### get <a name="get"></a>
@@ -49,7 +49,7 @@ from magic_hour import Client
 from os import getenv
 
 client = Client(token=getenv("API_TOKEN"))
-res = client.v1.video_projects.get(id="string")
+res = client.v1.video_projects.get(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
 #### Asynchronous Client
@@ -59,5 +59,5 @@ from magic_hour import AsyncClient
 from os import getenv
 
 client = AsyncClient(token=getenv("API_TOKEN"))
-res = await client.v1.video_projects.get(id="string")
+res = await client.v1.video_projects.get(id="cm6pvghix03bvyz0zwash6noj")
 ```

magic_hour/resources/v1/video_projects/client.py

@@ -36,7 +36,7 @@ class VideoProjectsClient:
 
         Examples:
         ```py
-        client.v1.video_projects.delete(id="string")
+        client.v1.video_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """
@@ -80,7 +80,7 @@ class VideoProjectsClient:
 
         Examples:
         ```py
-        client.v1.video_projects.get(id="string")
+        client.v1.video_projects.get(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """
@@ -120,7 +120,7 @@ class AsyncVideoProjectsClient:
 
         Examples:
         ```py
-        await client.v1.video_projects.delete(id="string")
+        await client.v1.video_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """
@@ -164,7 +164,7 @@ class AsyncVideoProjectsClient:
 
         Examples:
         ```py
-        await client.v1.video_projects.get(id="string")
+        await client.v1.video_projects.get(id="cm6pvghix03bvyz0zwash6noj")
         ```
 
         """

magic_hour/resources/v1/video_to_video/README.md

@@ -18,9 +18,9 @@ from os import getenv
 client = Client(token=getenv("API_TOKEN"))
 res = client.v1.video_to_video.create(
     assets={"video_file_path": "video/id/1234.mp4", "video_source": "file"},
-    end_seconds=15,
+    end_seconds=15.0,
     height=960,
-    start_seconds=0,
+    start_seconds=0.0,
     style={
         "art_style": "3D Render",
         "model": "Absolute Reality",
@@ -43,9 +43,9 @@ from os import getenv
 client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.video_to_video.create(
     assets={"video_file_path": "video/id/1234.mp4", "video_source": "file"},
-    end_seconds=15,
+    end_seconds=15.0,
     height=960,
-    start_seconds=0,
+    start_seconds=0.0,
     style={
         "art_style": "3D Render",
         "model": "Absolute Reality",

magic_hour/resources/v1/video_to_video/client.py

@@ -68,9 +68,9 @@ class VideoToVideoClient:
         ```py
         client.v1.video_to_video.create(
             assets={"video_source": "file"},
-            end_seconds=15,
+            end_seconds=15.0,
             height=960,
-            start_seconds=0,
+            start_seconds=0.0,
             style={
                 "art_style": "3D Render",
                 "model": "Absolute Reality",
@@ -164,9 +164,9 @@ class AsyncVideoToVideoClient:
         ```py
         await client.v1.video_to_video.create(
             assets={"video_source": "file"},
-            end_seconds=15,
+            end_seconds=15.0,
             height=960,
-            start_seconds=0,
+            start_seconds=0.0,
             style={
                 "art_style": "3D Render",
                 "model": "Absolute Reality",

{magic_hour-0.8.1.dist-info → magic_hour-0.8.3.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: magic_hour
-Version: 0.8.1
-Summary: 
+Version: 0.8.3
+Summary: Python SDK for Magic Hour API
 Requires-Python: >=3.8,<4.0
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -16,52 +16,47 @@ 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 Python SDK
 
-# Magic Hour API Python SDK
+[![PyPI - Version](https://img.shields.io/pypi/v/magic_hour)](https://pypi.org/project/magic_hour/)
 
-## Overview
-
-# Introduction 
-
-Magic Hour provides an API (beta) that can be integrated into your own application to generate videos using AI. 
+Magic Hour provides an API (beta) that can be integrated into your own application to generate videos and images 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).
+## Install
 
-Then, add the `Authorization` header to the request.
-
-| Key | Value |
-|-|-|
-| Authorization | Bearer mhk_live_apikey |
+```
+pip install magic_hour
+```
 
-> **Warning**: any API call that renders a video will utilize frames in your account.
+## Usage
 
+Initialize the client
 
 ### Synchronous Client
 
 ```python
 from magic_hour import Client
-from os import getenv
 
-client = Client(token=getenv("API_TOKEN"))
+# generate your API Key at https://magichour.ai/developer
+client = Client(token="my api key")
 ```
 
 ### Asynchronous Client
 
 ```python
 from magic_hour import AsyncClient
-from os import getenv
 
-client = AsyncClient(token=getenv("API_TOKEN"))
+# generate your API Key at https://magichour.ai/developer
+client = AsyncClient(token="my api key")
 ```
 
+> [!WARNING]
+> Any API call that renders a video will utilize frames in your account.
+
 ## Module Documentation and Snippets
 
 ### [v1.ai_clothes_changer](magic_hour/resources/v1/ai_clothes_changer/README.md)

{magic_hour-0.8.1.dist-info → magic_hour-0.8.3.dist-info}/RECORD

@@ -1,15 +1,15 @@
 magic_hour/__init__.py,sha256=9mcpfN52bfc0cw9wEz7dXOVpOsUuGmVdqFQ79NdnGYU,203
-magic_hour/client.py,sha256=S2K_ze-tISm1m24G9XEa1Olg7FMgJqf81AZqhRb47w0,2014
+magic_hour/client.py,sha256=2UhLa0mDgXsr5PQuPT5DUgwvXBVrwV1GskWUy5nKrr8,2014
 magic_hour/core/__init__.py,sha256=i6cIezufptVYpQS9F90nLCDIliQVXjUBsufIXmuI_9g,1145
-magic_hour/core/api_error.py,sha256=1ocVMiyV3LRwP7EGQtyG8SMmpxl_dRCADwJ44ncHbA4,1546
+magic_hour/core/api_error.py,sha256=K1d47qRbhLBNEaUVbs0NPgxee24X3qGZ37gBhleUzEE,1760
 magic_hour/core/auth.py,sha256=NSjPcmTyHelRag9FqH1ufbchBWQgGDpH2P0akfppIPo,9130
-magic_hour/core/base_client.py,sha256=IiHdTuYAqq3CxRfsYcIMKthjLRVSSrOM15hSuc77DyE,18688
+magic_hour/core/base_client.py,sha256=H9FJtNvN3ZfjjnPq4t9HXgh0c1324x1RFtAHXWEnqWk,18846
 magic_hour/core/binary_response.py,sha256=T-DATvb21P2ZRnYa4LlXmF77VfM8Tut2951QHEQct_U,681
 magic_hour/core/request.py,sha256=zdw-rie5wCy9MxIQ5ilhnZaBVPRyF8WAiZ5pGTam7Oc,5224
 magic_hour/core/response.py,sha256=Sl7nPL2axmz7em_6d9TkFSnQQKUpalWaVWbPPWoXJgM,10180
 magic_hour/core/type_utils.py,sha256=4bU9WXnMXJ6YTtuqOMiB8t6Xw0RlfVWJ-IDBONlqEtQ,461
-magic_hour/core/utils.py,sha256=wl_QTElIzKqDrB3nNuTFyUmJ17x9PiXAfWHssUtu4Ds,1108
-magic_hour/environment.py,sha256=GnaY1_XehrmKSDwLVxVNcss6PihV_2ODyJItRnqNVp4,167
+magic_hour/core/utils.py,sha256=Cp0SH9nBsdL53kCJSCsHgoJoo0HuXYmxShhQgeHw0KQ,1668
+magic_hour/environment.py,sha256=gwePWRvEN7uiSigUI3KemZat9I5A-lmpPAHFzWAe00c,167
 magic_hour/resources/v1/__init__.py,sha256=Aj0sjVcoijjQyieNBxv2_uewPYC2vO2UG-ehoBgCz5E,86
 magic_hour/resources/v1/ai_clothes_changer/README.md,sha256=KQTvbttct5GcdOJW3NG5gCsWF6G2qlwIoBjBd92TjUs,977
 magic_hour/resources/v1/ai_clothes_changer/__init__.py,sha256=6W_Y2HxG2sDOBiJyzngK3Q2S3xfQgpK-j8xFRmBAhbQ,142
@@ -29,13 +29,13 @@ magic_hour/resources/v1/ai_photo_editor/client.py,sha256=9b29HjZuEkZG0YAx-ejix4u
 magic_hour/resources/v1/ai_qr_code_generator/README.md,sha256=w6IE0mm_D-PnW-bDsIu9k8oPePekZ2TuW3gOFhi95_w,734
 magic_hour/resources/v1/ai_qr_code_generator/__init__.py,sha256=HnSTg7tB8M5LibZoCDRdE5Q71efmiqZIkNEve5SO1Mg,146
 magic_hour/resources/v1/ai_qr_code_generator/client.py,sha256=Kyzyb7TvPVC6AyQx6ZFV8O_CcEYkrKr1NeCpDf3qOgc,3831
-magic_hour/resources/v1/animation/README.md,sha256=l2l1N8MVzXIAF6PqTblL5BqK6PHkldhoFPPdM3B0twY,1469
+magic_hour/resources/v1/animation/README.md,sha256=uIVfUwD7iAOe2eJDgrxj4UyYmq9R30fdI3Z0JuEChc4,1477
 magic_hour/resources/v1/animation/__init__.py,sha256=M6KUe6TEZl_DAdyn1HFQ2kHYanZo6xy3mvUdCN264hQ,114
-magic_hour/resources/v1/animation/client.py,sha256=ZL2Hn2fjvnzdedZb2WapBwU-SYo351ib2bAhNt83qNM,6069
+magic_hour/resources/v1/animation/client.py,sha256=R5JaUbZKFkFgSVpa2sSwvtNF5HR91AKJ1PyDbTGTK3g,6077
 magic_hour/resources/v1/client.py,sha256=A2aXAjY8Y2yESfS1l2OjvvmkujCC1yj2d9xzmFcvPm8,5213
-magic_hour/resources/v1/face_swap/README.md,sha256=HxUhZO-sUmKd4oAd4AyKESFauzCj1rmMD5_tKmEp-2k,1288
+magic_hour/resources/v1/face_swap/README.md,sha256=jJTKHBhevcAZ9IeeVwW6OGatMdrDNVZvtQOiyMGqxL8,1296
 magic_hour/resources/v1/face_swap/__init__.py,sha256=lyg5uAHyYHEUVAiAZtP3zwjGCEGqq8IWbQKexVdhr00,110
-magic_hour/resources/v1/face_swap/client.py,sha256=_5D_DxqTugRdR1Z7bIZWX8cZQ0sny4uknzGv7v7iOj4,6145
+magic_hour/resources/v1/face_swap/client.py,sha256=vNdhH4HQa_FSlk_18tNAVOqkqop9hX6Kb-uee-I_obQ,6153
 magic_hour/resources/v1/face_swap_photo/README.md,sha256=9iGINuGkWn60ZaZgZ4xz0Iho0lvfE-e_YVEA2vId6QU,964
 magic_hour/resources/v1/face_swap_photo/__init__.py,sha256=NZEplYX5kDPL_0qY0Q5tuxhDevipN0otByTYKMmF_1k,130
 magic_hour/resources/v1/face_swap_photo/client.py,sha256=w_Axxc58-EyvMYzzv4xLHNZyXfctMdGg_CeFUZSIgx0,4013
@@ -47,24 +47,24 @@ magic_hour/resources/v1/files/upload_urls/client.py,sha256=iKzXLUyKafQoaSv1rwFqd
 magic_hour/resources/v1/image_background_remover/README.md,sha256=U1mho9NCQLbYgL0WsUxLgqxxSpZqGzl2RONR2cwHRgc,733
 magic_hour/resources/v1/image_background_remover/__init__.py,sha256=Vb_e8zKEh7bdrq0q1175DqyOd1ptPBUIfSKSLFPBVU4,166
 magic_hour/resources/v1/image_background_remover/client.py,sha256=0eUSR5tWSKl5Hc7gp5XPzWBG-Vt7-_0pDjkfcePKO4M,3751
-magic_hour/resources/v1/image_projects/README.md,sha256=eWG-p7x8FMDFW8HecB0-MMnXkpdGtddiI-tE9lh75vM,1513
+magic_hour/resources/v1/image_projects/README.md,sha256=S7r_5dtF4Ggfh_mIbEEtFLFa1CdOFSKoMr2JIS64hb4,1589
 magic_hour/resources/v1/image_projects/__init__.py,sha256=oBlV4e5IVYe8SclhoEy2VOYB53kKP2DORXwcztAwU3E,130
-magic_hour/resources/v1/image_projects/client.py,sha256=ufQy3w6xNiFRIM_WlXhUqmZg1o5tZmmq9vB4C13vRr4,5463
-magic_hour/resources/v1/image_to_video/README.md,sha256=n82x0Hy0HF0QD-AQgpOpgMnJaUYSDMMFR08YBX6TO5Q,1144
+magic_hour/resources/v1/image_projects/client.py,sha256=M6MwgQokexGimn9aZn4bQNKSMBtDia44BNVwIlw9VSE,5539
+magic_hour/resources/v1/image_to_video/README.md,sha256=oT5WB-JGAC4CnwMGrUwKzNCDXDwU350w7b6vtGtFDiE,1148
 magic_hour/resources/v1/image_to_video/__init__.py,sha256=tY_ABo6evwKQBRSq-M84lNX-pXqmxoozukmrO6NhCgA,126
-magic_hour/resources/v1/image_to_video/client.py,sha256=d3IA58ZsyliNGEksOv_0-D-bE4ihBHF5woRLNraTJW4,5951
-magic_hour/resources/v1/lip_sync/README.md,sha256=mR84XXa4HPr8NJwsoIAkn0U-gaOQsCXis9XB8EqayOU,1318
+magic_hour/resources/v1/image_to_video/client.py,sha256=1hj-H1LgvMRs669Dcm1h1FSfxDESEo0SIrK3DSi0Qso,5955
+magic_hour/resources/v1/lip_sync/README.md,sha256=7n7vA4A92iGhs3n4EVAX1pQWXE4hO_gWq_DSH4n7nTY,1330
 magic_hour/resources/v1/lip_sync/__init__.py,sha256=MlKUAoHNSKcuNzVyqNfLnLtD_PsqEn3l1TtVpPC1JqQ,106
-magic_hour/resources/v1/lip_sync/client.py,sha256=QOtaZUEVe7cH1-sfIo6Uw1_mz8E-bSMt1YAphWxrp-M,7087
-magic_hour/resources/v1/text_to_video/README.md,sha256=zY9yAyubiimygf7SpIGmGGRUQcx9b4rhu_Xnw8ukhaw,1034
+magic_hour/resources/v1/lip_sync/client.py,sha256=IsqZ6xh9wy5olrXuY4TdqbqbTXj-6dA4vDfThMIbfQs,7099
+magic_hour/resources/v1/text_to_video/README.md,sha256=Ug9HDXxOE0L_4sY6M4vmP041m8mPCxpabM4QbQoGMjY,1038
 magic_hour/resources/v1/text_to_video/__init__.py,sha256=F18iHSi9tuYSdgpatznBzb7lbSySNpK-82w96-Om_k4,122
-magic_hour/resources/v1/text_to_video/client.py,sha256=-KS2Kw0iI0PwzHlHDPqgEI-zt5ka_37FdCMFWZ1RuTM,4992
-magic_hour/resources/v1/video_projects/README.md,sha256=_pNhL1hqHu6UG5X-4Qyb4BUwlagpyzM56ofUzm1AWH4,1513
+magic_hour/resources/v1/text_to_video/client.py,sha256=60cYTtIN8vTjsxVVxq42EJ8679XQj4jiC2kiPyqHMX0,4996
+magic_hour/resources/v1/video_projects/README.md,sha256=jrNLefS4AacIUPUSjUwOfcEWHCyKl1VnXHmluSg5B90,1589
 magic_hour/resources/v1/video_projects/__init__.py,sha256=1aj_tE-GAf8BuQ76RQvjGVn8Y39CjdAJDlcsCPucX0w,130
-magic_hour/resources/v1/video_projects/client.py,sha256=hf9bSAfY4eDMu-xvRzYrR0pJtB4RA7uOqNTxPxm4jD0,5447
-magic_hour/resources/v1/video_to_video/README.md,sha256=xbKMVsTx4hbPELZhrO0SW8vtrIG8uvIF87fUEliFhUs,1604
+magic_hour/resources/v1/video_projects/client.py,sha256=O8lA3LgpFDqYxE3R6BLfQIMse1KNBqy2Q5LacKySod4,5523
+magic_hour/resources/v1/video_to_video/README.md,sha256=WqR3PqpIHDQm0P-67pG6nD0M4mHM8qHXjrXjMCqUHOM,1612
 magic_hour/resources/v1/video_to_video/__init__.py,sha256=1SHaRLlsrlBkdxxKBYgdbHrGATlRvqlXc22RpjjHaOA,126
-magic_hour/resources/v1/video_to_video/client.py,sha256=l6aDk9Het3m95ElcZiPkEBzXppN6YmZHhw4vMC8sV50,8154
+magic_hour/resources/v1/video_to_video/client.py,sha256=2ITdQuy2t8oxQCJ23YKqX_XSmQpoiJlivP6wo5qwDn8,8162
 magic_hour/types/models/__init__.py,sha256=fNhJtvVAFiSKzXt57UnvNozv6QYWZURU36pWTVoZQ-M,2790
 magic_hour/types/models/get_v1_image_projects_id_response.py,sha256=8SsbpC_HTl1TDmqRgpKK7Vbj4kM_vnuhm_AZ4uIaf80,2140
 magic_hour/types/models/get_v1_image_projects_id_response_downloads_item.py,sha256=ianjZWSKWOIRWAtakZKO_nn9YZXUuhVRatzXJnzQwKg,412
@@ -125,7 +125,7 @@ magic_hour/types/params/post_v1_text_to_video_body_style.py,sha256=8-zyz32Gz3qke
 magic_hour/types/params/post_v1_video_to_video_body.py,sha256=dbazkWaGco73sSirtD-Q6vnLzF4BZa4Od87UTih1_-o,2914
 magic_hour/types/params/post_v1_video_to_video_body_assets.py,sha256=INe1iMyS-xhj00xO7OymdqFrmgp1fWykDdLo_uoewVs,1456
 magic_hour/types/params/post_v1_video_to_video_body_style.py,sha256=RQWr8VJqipM4YmNwGCQXWf7XT7O8Y2hgqxRRH1Vh7Cs,5457
-magic_hour-0.8.1.dist-info/LICENSE,sha256=F3fxj7JXPgB2K0uj8YXRsVss4u-Dgt_-U3V4VXsivNI,1070
-magic_hour-0.8.1.dist-info/METADATA,sha256=oa0gO6dLHnrVJBEvPZPgJXWlt9iKrVCoLtGr_thKa-w,4683
-magic_hour-0.8.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-magic_hour-0.8.1.dist-info/RECORD,,
+magic_hour-0.8.3.dist-info/LICENSE,sha256=F3fxj7JXPgB2K0uj8YXRsVss4u-Dgt_-U3V4VXsivNI,1070
+magic_hour-0.8.3.dist-info/METADATA,sha256=f68spk5_Pn3Xs7dGBxAw4anPL3JErpic8YcAnLY25OE,4654
+magic_hour-0.8.3.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+magic_hour-0.8.3.dist-info/RECORD,,