comfyui-hitem3d

ComfyUI HiTem3D Integration

A comprehensive ComfyUI node collection that integrates with the HiTem3D API to generate high-quality 3D models from images, featuring advanced HTML preview capabilities and dynamic content generation.

Created by: Geekatplay Studio by Vladimir Chopine
Website: www.geekatplay.com
Patreon: https://www.patreon.com/c/geekatplay
YouTube: @geekatplay and @geekatplay-ru

💰 Get HiTem3D Credits

Special Referral Link: https://www.hitem3d.ai/?sp_source=Geekatplay
Use this link to sign up and get credits for HiTem3D API usage!

🎯 New Features

� Latest Updates

• New Resolutions: Support for 1536 and 1536pro (Pro Quality)
• New Format: Support for USDZ output format
• New Models: Support for hitem3dv2.0 and scene-portraitv1.5

�🌐 HTML Previewer System

• Live HTML Preview in ComfyUI with floating panel interface
• Auto-refresh functionality with dynamic tokens
• Secure file serving with path validation
• Interactive controls with drag & drop support

🔄 Dynamic Value Generation

• Dynamic Value Generator - Create timestamps, counters, UUIDs, random values
• Text Template System - Process templates with dynamic placeholders
• Auto-refresh Tokens - Trigger HTML preview updates automatically

📊 Complete Node Collection

• 8 specialized nodes for 3D generation, HTML preview, and history tracking

📁 Examples & Workflows

Check out the examples/ folder for:

• hitem3d_basic_workflow.json - Basic 3D generation workflow
• html_previewer_workflow.json - HTML preview with auto-refresh
• basic_workflow_with_history.json - Complete workflow with history tracking
• Complete integration examples and documentation

🚀 Quick Start

⚠️ SETUP REQUIRED: This node requires your personal HiTem3D API keys!

1. Run Setup Wizard:

   # Windows
   setup_wizard.bat
   
   # Linux/Mac
   python setup_wizard.py
   

2. Get API Keys: https://www.hitem3d.ai/?sp_source=Geekatplay

3. Add Credits to your HiTem3D account

4. Restart ComfyUI and try the example workflows!

📖 Detailed Setup: See QUICK_SETUP.md

🔧 Node Collection

Core 3D Generation Nodes

HiTem3D Generator Node

Converts images to 3D models using HiTem3D API.

Required Inputs:

• front_image: The front view image (required)

Optional Inputs:

• back_image, left_image, right_image: Additional view images
• model: Model version (hitem3dv1, hitem3dv1.5, hitem3dv2.0, scene-portraitv1.5)
• resolution: Output resolution (512, 1024, 1536, 1536pro)
• output_format: File format (obj, glb, stl, fbx)
• generation_type: Generation type (geometry_only, staged, all_in_one)
• face_count: Number of faces (100,000 - 2,000,000)
• timeout: Maximum wait time in seconds

Outputs:

• model_url: URL to download the generated 3D model
• cover_url: URL to download the preview image
• task_id: Unique task identifier

HiTem3D Downloader Node

Downloads 3D models from HiTem3D URLs.

Inputs:

• model_url: URL from the Generator node
• file_name: Base filename for the downloaded model

Outputs:

• model_path: Local path to the downloaded model file
• status: Download status message

HiTem3D Config Node

Updates API configuration.

Inputs:

• access_key: Your HiTem3D access key
• secret_key: Your HiTem3D secret key
• api_base_url: API base URL (optional)
• save_config: Whether to save configuration to file

HiTem3D 3D Preview Node

Interactive 3D model viewer for generated models.

Inputs:

• model_path: Path to the 3D model file
• width, height: Preview window dimensions
• background_color: Backgrou