fix: correct Hunyuan3D API call (remove invalid output_type parameter)

- Removed invalid output_type='mesh' parameter
- Updated response parsing to handle 4-element tuple correctly
- Added robust error handling for each tuple element
- Added detailed logging for debugging
- Verified against Hunyuan3D-2.1 API documentation

generators/hunyuan.py

@@ -58,7 +58,7 @@ class HunyuanGenerator:
             )
             print(f"[Hunyuan3D] Connected successfully")
             
-            # Call API with correct output_type
+            # Call API (returns tuple: file, output, mesh_stats, seed)
             print(f"[Hunyuan3D] Calling API with parameters...")
             result = self._call_api(
                 client,
@@ -74,44 +74,82 @@ class HunyuanGenerator:
                 check_box_rembg=True,
                 num_chunks=preset.num_chunks,
                 randomize_seed=True,
-                output_type="mesh",  # CRITICAL: Specify mesh output to get GLB file
                 api_name="/shape_generation"
             )
             print(f"[Hunyuan3D] API call completed")
             
-            # Extract GLB path with robust error handling
+            # Extract GLB path from tuple response
+            # API returns: (file, output, mesh_stats, seed)
             print(f"[Hunyuan3D] Raw result type: {type(result)}")
-            print(f"[Hunyuan3D] Raw result: {result}")
+            print(f"[Hunyuan3D] Raw result length: {len(result) if isinstance(result, (tuple, list)) else 'N/A'}")
             
-            # Handle different result formats
-            if isinstance(result, tuple):
-                if len(result) == 0:
-                    raise ValueError("Empty result tuple from Hunyuan3D API")
-                file_data = result[0]
-            else:
-                file_data = result
+            if not isinstance(result, tuple):
+                raise ValueError(
+                    f"Unexpected result type from Hunyuan3D API: {type(result)}. "
+                    f"Expected tuple of (file, output, mesh_stats, seed)."
+                )
+            
+            if len(result) != 4:
+                raise ValueError(
+                    f"Unexpected result length from Hunyuan3D API: {len(result)}. "
+                    f"Expected 4 elements (file, output, mesh_stats, seed), got {len(result)}."
+                )
+            
+            # Extract GLB file path (first element)
+            file_data, html_output, mesh_stats, used_seed = result
+            
+            print(f"[Hunyuan3D] file_data type: {type(file_data)}")
+            print(f"[Hunyuan3D] mesh_stats: {mesh_stats}")
+            print(f"[Hunyuan3D] used_seed: {used_seed}")
             
             # Extract path from file_data
+            if file_data is None:
+                raise ValueError(
+                    "Hunyuan3D API returned None for file. "
+                    "This usually means the generation failed on the server side. "
+                    "Possible causes:\n"
+                    "  - Invalid image input\n"
+                    "  - API timeout\n"
+                    "  - Server overload\n"
+                    "Try again with a different image or quality setting."
+                )
+            
+            # Handle different file_data formats
             if isinstance(file_data, dict):
-                if 'value' in file_data:
-                    glb_path = file_data['value']
-                elif 'path' in file_data:
+                print(f"[Hunyuan3D] file_data is dict with keys: {file_data.keys()}")
+                if 'path' in file_data:
                     glb_path = file_data['path']
+                elif 'value' in file_data:
+                    glb_path = file_data['value']
                 elif 'name' in file_data:
                     glb_path = file_data['name']
                 else:
-                    # Try to convert entire dict to string
-                    glb_path = str(file_data)
-                    print(f"[Hunyuan3D] WARNING: Unexpected dict format, using str(): {glb_path}")
+                    raise ValueError(
+                        f"Unexpected dict format from Hunyuan3D API. "
+                        f"Keys: {list(file_data.keys())}"
+                    )
             elif isinstance(file_data, str):
                 glb_path = file_data
             else:
-                glb_path = str(file_data)
-                print(f"[Hunyuan3D] WARNING: Unexpected type {type(file_data)}, using str(): {glb_path}")
+                raise ValueError(
+                    f"Unexpected file_data type: {type(file_data)}. "
+                    f"Expected dict or str."
+                )
+            
+            print(f"[Hunyuan3D] Extracted GLB path: {glb_path}")
             
             # Validate path exists
-            if not glb_path or not Path(glb_path).exists():
-                raise ValueError(f"GLB file not found at path: {glb_path}")
+            if not glb_path or glb_path == "None":
+                raise ValueError(
+                    "Hunyuan3D API returned invalid path. "
+                    "The generation may have failed on the server side."
+                )
+            
+            if not Path(glb_path).exists():
+                raise ValueError(
+                    f"GLB file not found at path: {glb_path}. "
+                    f"The file may not have been generated or saved correctly."
+                )
             
             print(f"[Hunyuan3D] Model generated: {glb_path}")