ComfyUI Extension: ComfyUI HiTem3D Integration

Authored by GeekatplayStudio

Created

Updated

1 stars

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.

Custom Nodes (0)

    README

    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

    šŸŒ 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

    • 7 specialized nodes for 3D generation and HTML preview
    • Professional 3D Preview with interactive controls
    • Flexible workflow examples for all use cases

    šŸ“ 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
    • 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, scene-portraitv1.5)
    • resolution: Output resolution (512, 1024, 1536, 1536pro)
    • output_format: File format (obj, glb, stl, fbx)
    • generation_type: Generation type (geometry_only, texture_only, both)
    • 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: Background color
    • auto_rotate: Enable automatic rotation
    • show_wireframe: Show model in wireframe mode
    • show_grid: Display reference grid

    Outputs:

    • preview_html: HTML preview of the 3D model
    • preview_file_path: Path to saved preview file
    • preview_url: URL for opening preview

    HTML Preview System Nodes

    HTML Previewer (Local)

    Displays HTML content in ComfyUI with live preview panel.

    Inputs:

    • html_content: HTML content to display
    • auto_refresh_token: Token for triggering auto-refresh

    Outputs:

    • preview_url: URL for accessing the HTML preview

    Features:

    • šŸŽÆ Floating Preview Panel - Draggable interface
    • šŸ”„ Auto-refresh Detection - Automatically detects when to refresh
    • šŸ›”ļø Secure File Serving - Safe path validation
    • šŸŽ® Interactive Controls - Toolbar with refresh and settings

    Dynamic Value Generator

    Generates dynamic values for auto-refresh and templating.

    Inputs:

    • value_type: Type of value (timestamp, counter, uuid, random, custom)
    • custom_prefix: Optional prefix for generated values
    • counter_start: Starting value for counter mode
    • format_string: Timestamp format string

    Outputs:

    • dynamic_value: Generated dynamic value

    Value Types:

    • Timestamp: Current date/time in configurable format
    • Counter: Incremental counter with custom starting value
    • UUID: Unique identifier (8-character short form)
    • Random: Random number (1000-9999)
    • Custom: Unix timestamp with custom prefix

    Text Template

    Processes text templates with dynamic placeholders.

    Inputs:

    • template: Text template with {{placeholder}} syntax
    • value1, value2, value3: Dynamic values for template
    • timestamp_format: Format for built-in timestamp placeholders

    Outputs:

    • text_output: Processed template with values replaced

    Built-in Placeholders:

    • {{timestamp}} - Current timestamp
    • {{date}} - Current date
    • {{unix}} - Unix timestamp
    • {{year}}, {{month}}, {{day}} - Date components
    • {{hour}}, {{minute}}, {{second}} - Time components
    • {{value1}}, {{value2}}, {{value3}} - Input values

    Installation

    The node collection is already installed in your ComfyUI directory:

    ComfyUI/custom_nodes/comfyui-hitem3d/

    Install dependencies using one of these methods:

    Method 1 - Direct Installation (Recommended):

    cd "ComfyUI/custom_nodes/comfyui-hitem3d"
.\install_direct.bat

    Method 2 - PowerShell Script:

    cd "ComfyUI/custom_nodes/comfyui-hitem3d"
.\install.ps1

    Method 3 - Manual Installation:

    cd "ComfyUI/custom_nodes/comfyui-hitem3d"
& "../../python_embeded/python.exe" -m pip install -r requirements.txt

    Configuration

    Initial Setup Required

    āš ļø IMPORTANT: Configure your personal API keys before using this node!

    1. Get Your API Keys:

    2. Configure the Node:

      • Run the setup wizard: python setup_wizard.py
      • Or manually edit config.json with your keys
      • Or use the HiTem3DConfigNode in ComfyUI

    3. Add Credits:

      • Purchase a resource package at HiTem3D
      • Each 3D generation consumes credits based on resolution and complexity

    Usage Examples

    Basic 3D Generation Workflow

    1. Load Image: Use ComfyUI's Load Image node
    2. Configure API: Use HiTem3DConfigNode with your credentials
    3. Generate 3D: Connect image to HiTem3DNode
    4. Download Model: Use HiTem3DDownloaderNode
    5. Preview: Use HiTem3DPreviewNode for interactive 3D preview

    HTML Preview Workflow

    1. Generate Content: Create HTML content (from 3D preview or custom)
    2. Add Auto-refresh: Use DynamicValueGenerator for refresh tokens
    3. Process Template: Use TextTemplate for dynamic content
    4. Preview HTML: Use HTMLPreviewer for live preview in ComfyUI

    Supported Parameters

    Model Versions

    • hitem3dv1: General model version 1.0
    • hitem3dv1.5: General model version 1.5 (recommended)
    • scene-portraitv1.5: Specialized for portrait/character models

    Resolutions

    • 512: 512Ā³ resolution (fastest)
    • 1024: 1024Ā³ resolution (recommended)
    • 1536: 1536Ā³ resolution (high quality)
    • 1536pro: 1536Ā³ Pro resolution (highest quality)

    Output Formats

    • obj: Wavefront OBJ format
    • glb: Binary glTF format (recommended)
    • stl: STL format (for 3D printing)
    • fbx: Autodesk FBX format

    Generation Types

    • geometry_only: Generate only the mesh geometry
    • texture_only: Generate textures for existing geometry
    • both: Generate both geometry and textures (recommended)

    Troubleshooting

    Common Issues

    1. "Insufficient balance" (余额äøč¶³): Your account needs more credits

    2. "Invalid credentials": Check your access key and secret key in config

    3. "Task timeout": Increase the timeout value or try lower resolution

    4. "Some Nodes Are Missing":

      • Restart ComfyUI completely to reload node definitions
      • Check that all dependencies are installed correctly

    5. HTML Previewer not working:

      • Ensure server imports are available
      • Check that no other process is using the same port

    For detailed troubleshooting, see TROUBLESHOOTING.md.

    API Limits

    • Maximum image size: 20MB per image
    • Maximum images: 4 images (front, back, left, right)
    • Supported formats: PNG, JPEG, JPG, WebP
    • Face count range: 100,000 - 2,000,000

    Documentation

    • HTML_PREVIEWER_README.md - Detailed HTML preview system guide
    • QUICK_SETUP.md - Quick setup instructions
    • TROUBLESHOOTING.md - Comprehensive troubleshooting guide
    • examples/README.md - Example workflows and usage patterns

    API Reference

    For detailed API documentation, visit:

    Support

    For issues related to:

    Support Geekatplay Studio

    If you find this node collection useful, please consider supporting:

    License

    This project is created by Geekatplay Studio by Vladimir Chopine for integration with the HiTem3D API service.

    Version History

    • v2.0.0: Complete HTML Preview System

      • Added HTML Previewer with live preview panel
      • Dynamic Value Generator for auto-refresh functionality
      • Text Template system with placeholder processing
      • Enhanced 3D Preview with interactive controls
      • Cleaned project structure and comprehensive documentation

    • v1.0.0: Initial release with full HiTem3D API integration

      • Single and multi-view image support
      • All model versions and formats
      • Configurable parameters
      • Automatic download functionality
      • Created by Geekatplay Studio