Detailed Convert

Introduction#

The Detailed Convert feature is an advanced image-to-3D generation tool that allows users to transform product images into fully textured 3D models with granular control over the generation process.

Overview#

Detailed Convert provides a comprehensive modal interface for converting 2D product images into 3D models using AI-powered generation. Unlike the basic "Convert to 3D" option, this feature offers extensive customization options for professional-grade 3D model creation.

Access#

The Detailed Convert feature is accessible through:

• Product card dropdown menu → "Detailed converting" option
• Available for products in the commerce section
• Requires existing product images to work with

Key Features#

Image Upload & Management#

• Multiple Image Support: Upload 1-4 reference images (JPG/PNG format, max 10MB each)
• Drag & Drop Interface: Intuitive file upload with visual feedback
• Image Validation: Automatic format and size validation with clear error messages

AI Model Selection#

• Meshy 5: Stable model for most use cases with higher-quality geometry and multi-image support
• Meshy 6: High-detail model with support for 4K/8K textures
• Meshy 7: Newest high-fidelity model with 4K/8K textures and optional Ultra geometry for a single image
• Smart Restrictions: Smart Topology requires one image. Standard Meshy 5, 6, and 7 support multiple images; Ultra is single-image only

Geometry Controls#

• Target Polycount: Adjustable from 100 to 60,000 polygons in Standard mode and up to 15,000 in Smart Topology
  • Higher values = more detailed models but longer generation time
  • Default: 40,000 polygons in Standard mode and 4,000 in Smart Topology
• Ultra Mode: Meshy 7 can improve single-image geometry for 5 additional credits
• Symmetry Mode:
  • Off: No symmetry applied
  • Auto: Automatically detects and applies symmetry if suitable
  • On: Enforces symmetry throughout generation

Texture Generation Options#

Two methods for controlling model textures: Text Prompt Method

• Texture Prompt: Up to 550 characters describing desired texture appearance
• AI-Generated: Creates textures based on text description
• Priority: Takes precedence over image prompts when both are provided Image Prompt Method
• Texture Image Upload: Single reference image for texture guidance
• Surface Detail Control: Generates colors and surface details matching the reference
• Geometry Matching: Works best when reference geometry matches the original asset

Texture Resolution#

When using Meshy 6, Meshy 7, or Smart Topology, you can choose the resolution of the generated base color texture. Higher resolutions capture more surface detail at a higher credit cost:

• 2K: Standard 2048×2048 base color texture (default)
• 4K: Higher-detail 4096×4096 base color texture. PBR maps stay at 2K
• 8K: Maximum 8192×8192 base color texture. No emission map is produced at this resolution

The 4K and 8K options are available for Meshy 6, Meshy 7, and Smart Topology. Meshy 5 always uses the standard 2K texture. The credit cost for each resolution is shown on its option before you generate.

Image Enhancement can optimize reference images before Meshy 6 or 7 generates the model. PBR maps and highlight/shadow removal are included in the texture cost rather than billed separately.

Generation Process#

• Real-time Progress: Visual progress bar with percentage completion
• Background Processing: Non-blocking generation allows continued app usage
• Status Updates: Live feedback on generation stages
• Error Handling: Comprehensive error reporting and recovery options

User Interface#

Modal Layout#

• Responsive Design: Adapts to mobile and desktop viewports
• Tabbed Interface: Organized sections for different configuration options
• Form Validation: Real-time validation with clear error messages
• Reset Functionality: One-click reset to default or initial values

Controls#

• Generate Button: Initiates the 3D model creation process
• Reset Button: Restores form to initial state with tooltip guidance
• Progress Indicator: Shows generation progress and estimated completion

Technical Implementation#

File Handling#

• S3 policy-based secure file uploads
• Client-side file validation and preprocessing
• Automatic image optimization and format conversion

Generation Pipeline#

• Integration with Meshy API for AI-powered 3D generation
• Serverless handler architecture for scalable processing
• Real-time progress tracking via WebSocket connections

Use Cases#

E-commerce Applications#

• Product Visualization: Convert product photos to interactive 3D models
• Shopify Integration: Direct publishing to Shopify stores
• Marketing Assets: Create engaging 3D content for product pages

Professional Workflows#

• Rapid Prototyping: Quick 3D model creation from concept images
• Asset Generation: Bulk conversion of product catalogs
• Quality Control: Fine-tuned generation parameters for consistent results

Best Practices#

Image Selection#

• Use high-resolution, well-lit product images
• Ensure clear object boundaries and minimal background clutter
• Multiple angles provide better geometry reconstruction

Parameter Tuning#

• Start with default settings and adjust based on results
• Higher polycount for detailed products, lower for simple shapes
• Use symmetry for balanced objects like furniture or accessories

Texture Optimization#

• Combine text prompts with reference images for best results
• Keep texture prompts specific but concise
• Test different AI models to find optimal quality/speed balance

Integration Points#

Commerce Workflow#

• Seamless integration with existing product management
• Automatic session updates and shop revalidation
• Progress tracking tied to specific product instances

Authentication & Permissions#

• Requires an authenticated user session
• Respects shop-level permissions and quotas
• Secure file upload with policy-based access control