magic_hour 0.21.0__py3-none-any.whl → 0.22.0__py3-none-any.whl

magic_hour/client.py

@@ -2,7 +2,7 @@ import httpx
 import typing
 
 from magic_hour.core import AsyncBaseClient, AuthBearer, SyncBaseClient
-from magic_hour.environment import Environment
+from magic_hour.environment import Environment, _get_base_url
 from magic_hour.resources.v1 import AsyncV1Client, V1Client
 
 
@@ -10,9 +10,9 @@ class Client:
     def __init__(
         self,
         *,
-        base_url: typing.Optional[str] = None,
         timeout: typing.Optional[float] = 60,
         httpx_client: typing.Optional[httpx.Client] = None,
+        base_url: typing.Optional[str] = None,
         environment: Environment = Environment.ENVIRONMENT,
         token: typing.Optional[str] = None,
     ):
@@ -31,9 +31,9 @@ class AsyncClient:
     def __init__(
         self,
         *,
-        base_url: typing.Optional[str] = None,
         timeout: typing.Optional[float] = 60,
         httpx_client: typing.Optional[httpx.AsyncClient] = None,
+        base_url: typing.Optional[str] = None,
         environment: Environment = Environment.ENVIRONMENT,
         token: typing.Optional[str] = None,
     ):
@@ -46,14 +46,3 @@ class AsyncClient:
         )
         self._base_client.register_auth("bearerAuth", AuthBearer(val=token))
         self.v1 = AsyncV1Client(base_client=self._base_client)
-
-
-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/core/base_client.py

@@ -25,6 +25,7 @@ T = TypeVar(
     "T",
     bound=Union[object, None, str, "BaseModel", List[Any], Dict[str, Any], Any],
 )
+_DEFAULT_SERVICE_NAME = "__default_service__"
 
 
 class BaseClient:
@@ -34,21 +35,16 @@ class BaseClient:
     Serves as the foundation for both synchronous and asynchronous client implementations.
 
     Attributes:
-        _base_url: Base URL for the API endpoint
         _auths: Dictionary mapping auth provider IDs to AuthProvider instances
     """
 
-    def __init__(
-        self,
-        *,
-        base_url: str,
-    ):
-        """Initialize the base client.
-
-        Args:
-            base_url: Base URL for the API endpoint
-        """
-        self._base_url = base_url
+    def __init__(self, base_url: Union[str, Dict[str, str]]):
+        """Initialize the base client"""
+        self._base_url = (
+            base_url
+            if isinstance(base_url, dict)
+            else {_DEFAULT_SERVICE_NAME: base_url}
+        )
         self._auths: Dict[str, AuthProvider] = {}
 
     def register_auth(self, auth_id: str, provider: AuthProvider):
@@ -71,15 +67,7 @@ class BaseClient:
         }
         return headers
 
-    def get_base_url(self) -> str:
-        """Get the base URL for the API endpoint.
-
-        Returns:
-            Base URL string
-        """
-        return self._base_url
-
-    def build_url(self, path: str) -> str:
+    def build_url(self, path: str, service_name: Optional[str] = None) -> str:
         """Build a complete URL by combining base URL and path.
 
         Args:
@@ -88,13 +76,13 @@ class BaseClient:
         Returns:
             Complete URL string
         """
-        base = self._base_url
-        if base.endswith("/"):
-            base = base[:-1]
+        base_url = self._base_url.get(service_name or _DEFAULT_SERVICE_NAME, "")
+        if base_url.endswith("/"):
+            base_url = base_url[:-1]
         if path.startswith("/"):
             path = path[1:]
 
-        return f"{base}/{path}"
+        return f"{base_url}/{path}"
 
     def _cast_to_raw_response(
         self, res: httpx.Response, cast_to: Union[Type[T], Any]
@@ -254,6 +242,7 @@ class BaseClient:
         *,
         method: str,
         path: str,
+        service_name: Optional[str] = None,
         auth_names: Optional[List[str]] = None,
         query_params: Optional[QueryParams] = None,
         headers: Optional[Dict[str, str]] = None,
@@ -283,7 +272,10 @@ class BaseClient:
             Complete request configuration
         """
         opts = request_options or default_request_options()
-        req_cfg: RequestConfig = {"method": method, "url": self.build_url(path)}
+        req_cfg: RequestConfig = {
+            "method": method,
+            "url": self.build_url(path, service_name=service_name),
+        }
         req_cfg = self._apply_auth(cfg=req_cfg, auth_names=auth_names or [])
         req_cfg = self._apply_headers(
             cfg=req_cfg, opts=opts, content_type=content_type, explicit_headers=headers
@@ -351,13 +343,12 @@ class SyncBaseClient(BaseClient):
     def __init__(
         self,
         *,
-        base_url: str,
+        base_url: Union[str, Dict[str, str]],
         httpx_client: httpx.Client,
     ):
         """Initialize the synchronous client.
 
         Args:
-            base_url: Base URL for the API endpoint
             httpx_client: Synchronous HTTPX client instance
         """
         super().__init__(base_url=base_url)
@@ -369,6 +360,7 @@ class SyncBaseClient(BaseClient):
         method: str,
         path: str,
         cast_to: Union[Type[T], Any],
+        service_name: Optional[str] = None,
         auth_names: Optional[List[str]] = None,
         query_params: Optional[QueryParams] = None,
         headers: Optional[Dict[str, str]] = None,
@@ -386,6 +378,7 @@ class SyncBaseClient(BaseClient):
             path: API endpoint path
             cast_to: Type to cast the response to
             auth_names: List of auth provider IDs
+            service_name: The name of the API service to make the request to
             query_params: Query parameters
             headers: Request headers
             data: Form data
@@ -404,6 +397,7 @@ class SyncBaseClient(BaseClient):
         req_cfg = self.build_request(
             method=method,
             path=path,
+            service_name=service_name,
             auth_names=auth_names,
             query_params=query_params,
             headers=headers,
@@ -430,6 +424,7 @@ class SyncBaseClient(BaseClient):
         method: str,
         path: str,
         cast_to: Union[Type[T], Any],
+        service_name: Optional[str] = None,
         auth_names: Optional[List[str]] = None,
         query_params: Optional[QueryParams] = None,
         headers: Optional[Dict[str, str]] = None,
@@ -447,6 +442,7 @@ class SyncBaseClient(BaseClient):
             path: API endpoint path
             cast_to: Type to cast the response to
             auth_names: List of auth provider IDs
+            service_name: The name of the API service to make the request to
             query_params: Query parameters
             headers: Request headers
             data: Form data
@@ -465,6 +461,7 @@ class SyncBaseClient(BaseClient):
         req_cfg = self.build_request(
             method=method,
             path=path,
+            service_name=service_name,
             auth_names=auth_names,
             query_params=query_params,
             headers=headers,
@@ -489,13 +486,12 @@ class AsyncBaseClient(BaseClient):
     def __init__(
         self,
         *,
-        base_url: str,
+        base_url: Union[str, Dict[str, str]],
         httpx_client: httpx.AsyncClient,
     ):
         """Initialize the asynchronous client.
 
         Args:
-            base_url: Base URL for the API endpoint
             httpx_client: Asynchronous HTTPX client instance
         """
         super().__init__(base_url=base_url)
@@ -507,6 +503,7 @@ class AsyncBaseClient(BaseClient):
         method: str,
         path: str,
         cast_to: Union[Type[T], Any],
+        service_name: Optional[str] = None,
         auth_names: Optional[List[str]] = None,
         query_params: Optional[QueryParams] = None,
         headers: Optional[Dict[str, str]] = None,
@@ -524,6 +521,7 @@ class AsyncBaseClient(BaseClient):
             path: API endpoint path
             cast_to: Type to cast the response to
             auth_names: List of auth provider IDs
+            service_name: The name of the API service to make the request to
             query_params: Query parameters
             headers: Request headers
             data: Form data
@@ -542,6 +540,7 @@ class AsyncBaseClient(BaseClient):
         req_cfg = self.build_request(
             method=method,
             path=path,
+            service_name=service_name,
             auth_names=auth_names,
             query_params=query_params,
             headers=headers,
@@ -568,6 +567,7 @@ class AsyncBaseClient(BaseClient):
         method: str,
         path: str,
         cast_to: Union[Type[T], Any],
+        service_name: Optional[str] = None,
         auth_names: Optional[List[str]] = None,
         query_params: Optional[QueryParams] = None,
         headers: Optional[Dict[str, str]] = None,
@@ -585,6 +585,7 @@ class AsyncBaseClient(BaseClient):
             path: API endpoint path
             cast_to: Type to cast the response to
             auth_names: List of auth provider IDs
+            service_name: The name of the API service to make the request to
             query_params: Query parameters
             headers: Request headers
             data: Form data
@@ -603,6 +604,7 @@ class AsyncBaseClient(BaseClient):
         req_cfg = self.build_request(
             method=method,
             path=path,
+            service_name=service_name,
             auth_names=auth_names,
             query_params=query_params,
             headers=headers,

magic_hour/environment.py

@@ -1,8 +1,20 @@
 import enum
+import typing
 
 
 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.21.0"
+    MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.22.0"
+
+
+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/resources/v1/ai_clothes_changer/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI Clothes Changer
+### AI Clothes Changer <a name="create"></a>
 
-Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.
+Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
 
 **API Endpoint**: `POST /v1/ai-clothes-changer`
 

magic_hour/resources/v1/ai_clothes_changer/client.py

@@ -27,7 +27,7 @@ class AiClothesChangerClient:
         """
         AI Clothes Changer
 
-        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.
+        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
 
         POST /v1/ai-clothes-changer
 
@@ -85,7 +85,7 @@ class AsyncAiClothesChangerClient:
         """
         AI Clothes Changer
 
-        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.
+        Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
 
         POST /v1/ai-clothes-changer
 

magic_hour/resources/v1/ai_face_editor/README.md

@@ -1,6 +1,5 @@
 
-### create <a name="create"></a>
-AI Face Editor
+### 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
 

magic_hour/resources/v1/ai_gif_generator/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI GIFs
+### AI GIFs <a name="create"></a>
 
-Create an AI GIF. Each GIF costs 25 frames.
+Create an AI GIF. Each GIF costs 25 credits.
 
 **API Endpoint**: `POST /v1/ai-gif-generator`
 

magic_hour/resources/v1/ai_gif_generator/client.py

@@ -27,7 +27,7 @@ class AiGifGeneratorClient:
         """
         AI GIFs
 
-        Create an AI GIF. Each GIF costs 25 frames.
+        Create an AI GIF. Each GIF costs 25 credits.
 
         POST /v1/ai-gif-generator
 
@@ -80,7 +80,7 @@ class AsyncAiGifGeneratorClient:
         """
         AI GIFs
 
-        Create an AI GIF. Each GIF costs 25 frames.
+        Create an AI GIF. Each GIF costs 25 credits.
 
         POST /v1/ai-gif-generator
 

magic_hour/resources/v1/ai_headshot_generator/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI Headshots
+### AI Headshots <a name="create"></a>
 
-Create an AI headshot. Each headshot costs 50 frames.
+Create an AI headshot. Each headshot costs 50 credits.
 
 **API Endpoint**: `POST /v1/ai-headshot-generator`
 

magic_hour/resources/v1/ai_headshot_generator/client.py

@@ -31,7 +31,7 @@ class AiHeadshotGeneratorClient:
         """
         AI Headshots
 
-        Create an AI headshot. Each headshot costs 50 frames.
+        Create an AI headshot. Each headshot costs 50 credits.
 
         POST /v1/ai-headshot-generator
 
@@ -90,7 +90,7 @@ class AsyncAiHeadshotGeneratorClient:
         """
         AI Headshots
 
-        Create an AI headshot. Each headshot costs 50 frames.
+        Create an AI headshot. Each headshot costs 50 credits.
 
         POST /v1/ai-headshot-generator
 

magic_hour/resources/v1/ai_image_generator/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI Images
+### AI Images <a name="create"></a>
 
-Create an AI image. Each image costs 5 frames.
+Create an AI image. Each image costs 5 credits.
 
 **API Endpoint**: `POST /v1/ai-image-generator`
 

magic_hour/resources/v1/ai_image_generator/client.py

@@ -30,7 +30,7 @@ class AiImageGeneratorClient:
         """
         AI Images
 
-        Create an AI image. Each image costs 5 frames.
+        Create an AI image. Each image costs 5 credits.
 
         POST /v1/ai-image-generator
 
@@ -95,7 +95,7 @@ class AsyncAiImageGeneratorClient:
         """
         AI Images
 
-        Create an AI image. Each image costs 5 frames.
+        Create an AI image. Each image costs 5 credits.
 
         POST /v1/ai-image-generator
 

magic_hour/resources/v1/ai_image_upscaler/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI Image Upscaler
+### AI Image Upscaler <a name="create"></a>
 
-Upscale your image using AI. Each 2x upscale costs 50 frames, and 4x upscale costs 200 frames.
+Upscale your image using AI. Each 2x upscale costs 50 credits, and 4x upscale costs 200 credits.
 
 **API Endpoint**: `POST /v1/ai-image-upscaler`
 

magic_hour/resources/v1/ai_image_upscaler/client.py

@@ -29,7 +29,7 @@ class AiImageUpscalerClient:
         """
         AI Image Upscaler
 
-        Upscale your image using AI. Each 2x upscale costs 50 frames, and 4x upscale costs 200 frames.
+        Upscale your image using AI. Each 2x upscale costs 50 credits, and 4x upscale costs 200 credits.
 
         POST /v1/ai-image-upscaler
 
@@ -94,7 +94,7 @@ class AsyncAiImageUpscalerClient:
         """
         AI Image Upscaler
 
-        Upscale your image using AI. Each 2x upscale costs 50 frames, and 4x upscale costs 200 frames.
+        Upscale your image using AI. Each 2x upscale costs 50 credits, and 4x upscale costs 200 credits.
 
         POST /v1/ai-image-upscaler
 

magic_hour/resources/v1/ai_meme_generator/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI Meme Generator
+### AI Meme Generator <a name="create"></a>
 
-Create an AI generated meme. Each meme costs 10 frames.
+Create an AI generated meme. Each meme costs 10 credits.
 
 **API Endpoint**: `POST /v1/ai-meme-generator`
 

magic_hour/resources/v1/ai_meme_generator/client.py

@@ -27,7 +27,7 @@ class AiMemeGeneratorClient:
         """
         AI Meme Generator
 
-        Create an AI generated meme. Each meme costs 10 frames.
+        Create an AI generated meme. Each meme costs 10 credits.
 
         POST /v1/ai-meme-generator
 
@@ -85,7 +85,7 @@ class AsyncAiMemeGeneratorClient:
         """
         AI Meme Generator
 
-        Create an AI generated meme. Each meme costs 10 frames.
+        Create an AI generated meme. Each meme costs 10 credits.
 
         POST /v1/ai-meme-generator
 

magic_hour/resources/v1/ai_photo_editor/README.md

@@ -1,10 +1,9 @@
 
-### create <a name="create"></a>
-AI Photo Editor
+### 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. 
 
-Edit photo using AI. Each photo costs 10 frames.
+Edit photo using AI. Each photo costs 10 credits.
 
 **API Endpoint**: `POST /v1/ai-photo-editor`
 

magic_hour/resources/v1/ai_photo_editor/client.py

@@ -34,7 +34,7 @@ class AiPhotoEditorClient:
 
         > **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.
 
-        Edit photo using AI. Each photo costs 10 frames.
+        Edit photo using AI. Each photo costs 10 credits.
 
         POST /v1/ai-photo-editor
 
@@ -115,7 +115,7 @@ class AsyncAiPhotoEditorClient:
 
         > **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.
 
-        Edit photo using AI. Each photo costs 10 frames.
+        Edit photo using AI. Each photo costs 10 credits.
 
         POST /v1/ai-photo-editor
 

magic_hour/resources/v1/ai_qr_code_generator/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-AI QR Code
+### AI QR Code <a name="create"></a>
 
-Create an AI QR code. Each QR code costs 20 frames.
+Create an AI QR code. Each QR code costs 20 credits.
 
 **API Endpoint**: `POST /v1/ai-qr-code-generator`
 

magic_hour/resources/v1/ai_qr_code_generator/client.py

@@ -28,7 +28,7 @@ class AiQrCodeGeneratorClient:
         """
         AI QR Code
 
-        Create an AI QR code. Each QR code costs 20 frames.
+        Create an AI QR code. Each QR code costs 20 credits.
 
         POST /v1/ai-qr-code-generator
 
@@ -85,7 +85,7 @@ class AsyncAiQrCodeGeneratorClient:
         """
         AI QR Code
 
-        Create an AI QR code. Each QR code costs 20 frames.
+        Create an AI QR code. Each QR code costs 20 credits.
 
         POST /v1/ai-qr-code-generator
 

magic_hour/resources/v1/ai_talking_photo/README.md

@@ -1,6 +1,5 @@
 
-### create <a name="create"></a>
-AI Talking Photo
+### AI Talking Photo <a name="create"></a>
 
 Create a talking photo from an image and audio or text input.
 

magic_hour/resources/v1/animation/README.md

@@ -1,6 +1,5 @@
 
-### create <a name="create"></a>
-Animation
+### Animation <a name="create"></a>
 
 Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
 

magic_hour/resources/v1/face_swap/README.md

@@ -1,6 +1,5 @@
 
-### create <a name="create"></a>
-Face Swap video
+### Face Swap video <a name="create"></a>
 
 Create a Face Swap video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
   

magic_hour/resources/v1/face_swap_photo/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-Face Swap Photo
+### Face Swap Photo <a name="create"></a>
 
-Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
+Create a face swap photo. Each photo costs 5 credits. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
 
 **API Endpoint**: `POST /v1/face-swap-photo`
 

magic_hour/resources/v1/face_swap_photo/client.py

@@ -27,7 +27,7 @@ class FaceSwapPhotoClient:
         """
         Face Swap Photo
 
-        Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
+        Create a face swap photo. Each photo costs 5 credits. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
 
         POST /v1/face-swap-photo
 
@@ -84,7 +84,7 @@ class AsyncFaceSwapPhotoClient:
         """
         Face Swap Photo
 
-        Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
+        Create a face swap photo. Each photo costs 5 credits. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details
 
         POST /v1/face-swap-photo
 

magic_hour/resources/v1/files/upload_urls/README.md

@@ -1,6 +1,5 @@
 
-### create <a name="create"></a>
-Generate asset upload urls
+### Generate asset upload urls <a name="create"></a>
 
 Create a list of urls used to upload the assets needed to generate a video. Each video type has their own requirements on what assets are required. Please refer to the specific mode API for more details. The response array will be in the same order as the request body.
 

magic_hour/resources/v1/image_background_remover/README.md

@@ -1,8 +1,7 @@
 
-### create <a name="create"></a>
-Image Background Remover
+### Image Background Remover <a name="create"></a>
 
-Remove background from image. Each image costs 5 frames.
+Remove background from image. Each image costs 5 credits.
 
 **API Endpoint**: `POST /v1/image-background-remover`
 

magic_hour/resources/v1/image_background_remover/client.py

@@ -27,7 +27,7 @@ class ImageBackgroundRemoverClient:
         """
         Image Background Remover
 
-        Remove background from image. Each image costs 5 frames.
+        Remove background from image. Each image costs 5 credits.
 
         POST /v1/image-background-remover
 
@@ -81,7 +81,7 @@ class AsyncImageBackgroundRemoverClient:
         """
         Image Background Remover
 
-        Remove background from image. Each image costs 5 frames.
+        Remove background from image. Each image costs 5 credits.
 
         POST /v1/image-background-remover
 

magic_hour/resources/v1/image_projects/README.md

@@ -1,6 +1,5 @@
 
-### delete <a name="delete"></a>
-Delete image
+### Delete image <a name="delete"></a>
 
 Permanently delete the rendered image. This action is not reversible, please be sure before deleting.
 
@@ -26,8 +25,7 @@ client = AsyncClient(token=getenv("API_TOKEN"))
 res = await client.v1.image_projects.delete(id="cm6pvghix03bvyz0zwash6noj")
 ```
 
-### get <a name="get"></a>
-Get image details
+### Get image details <a name="get"></a>
 
 Get the details of a image project. The `downloads` field will be empty unless the image was successfully rendered.
 

magic_hour/resources/v1/image_to_video/README.md

@@ -1,6 +1,5 @@
 
-### create <a name="create"></a>
-Image-to-Video
+### Image-to-Video <a name="create"></a>
 
 Create a Image To Video video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.