fix: namespace automatic downloads by project id

README.md

@@ -102,6 +102,8 @@ The `generate()` function provides a complete end-to-end solution:
 - `download_outputs` (bool, default True): Whether to download the generated files
 - `download_directory` (str, optional): Directory to save downloaded files (defaults to current directory)
 
+Automatic downloads use filenames prefixed with the project ID. Use `response.downloaded_paths` to find saved files; downloading the same project again may overwrite its previous files.
+
 ```python
 # Generate function - handles everything automatically
 response = client.v1.ai_image_generator.generate(

magic_hour/helpers/download.py

@@ -10,10 +10,14 @@
 
 
 def _compute_download_path(
-    url: str, download_directory: Union[str, None] = None
+    url: str,
+    download_directory: Union[str, None] = None,
+    project_id: Union[str, None] = None,
 ) -> str:
     url_path = urlparse(url).path
     filename = Path(url_path).name
+    if project_id:
+        filename = f"{Path(project_id).name}-{filename}"
     if download_directory:
         return os.path.join(download_directory, filename)
     return filename
@@ -26,6 +30,7 @@ def download_files_sync(
         List[models.V1AudioProjectsGetResponseDownloadsItem],
     ],
     download_directory: Union[str, None] = None,
+    project_id: Union[str, None] = None,
 ) -> List[str]:
     downloaded_paths: List[str] = []
 
@@ -35,7 +40,9 @@ def download_files_sync(
             download_response.raise_for_status()
 
             download_path = _compute_download_path(
-                download.url, download_directory=download_directory
+                download.url,
+                download_directory=download_directory,
+                project_id=project_id,
             )
 
             with open(download_path, "wb") as f:
@@ -55,6 +62,7 @@ async def download_files_async(
         List[models.V1AudioProjectsGetResponseDownloadsItem],
     ],
     download_directory: Union[str, None] = None,
+    project_id: Union[str, None] = None,
 ) -> List[str]:
     downloaded_paths: List[str] = []
 
@@ -64,7 +72,9 @@ async def download_files_async(
             download_response.raise_for_status()
 
             download_path = _compute_download_path(
-                download.url, download_directory=download_directory
+                download.url,
+                download_directory=download_directory,
+                project_id=project_id,
             )
 
             with open(download_path, "wb") as f:

magic_hour/resources/v1/audio_projects/client.py

@@ -85,6 +85,7 @@ def check_result(
         downloaded_paths = download_files_sync(
             downloads=api_response.downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1AudioProjectsGetResponseWithDownloads(
@@ -225,6 +226,7 @@ async def check_result(
         downloaded_paths = await download_files_async(
             downloads=api_response.downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1AudioProjectsGetResponseWithDownloads(

magic_hour/resources/v1/face_detection/client.py

@@ -108,6 +108,7 @@ def generate(
         downloaded_paths = download_files_sync(
             downloads=face_downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1FaceDetectionGetResponseWithDownloads(
@@ -283,6 +284,7 @@ async def generate(
         downloaded_paths = await download_files_async(
             downloads=face_downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1FaceDetectionGetResponseWithDownloads(

magic_hour/resources/v1/image_projects/client.py

@@ -86,6 +86,7 @@ def check_result(
         downloaded_paths = download_files_sync(
             downloads=api_response.downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1ImageProjectsGetResponseWithDownloads(
@@ -226,6 +227,7 @@ async def check_result(
         downloaded_paths = await download_files_async(
             downloads=api_response.downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1ImageProjectsGetResponseWithDownloads(

magic_hour/resources/v1/video_projects/client.py

@@ -85,6 +85,7 @@ def check_result(
         downloaded_paths = download_files_sync(
             downloads=api_response.downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1VideoProjectsGetResponseWithDownloads(
@@ -225,6 +226,7 @@ async def check_result(
         downloaded_paths = await download_files_async(
             downloads=api_response.downloads,
             download_directory=download_directory,
+            project_id=api_response.id,
         )
 
         return V1VideoProjectsGetResponseWithDownloads(