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 6 Lite: Stable model for most use cases with higher-quality geometry and multi-image support
• Meshy 6: A reliable model with HD texture support (4K/8K)
• Meshy 7.1: The newest and most precise model, with HD textures and adjustable 3D model detail
• Meshy T2.5: Newest Smart Topology model for clean, game-ready meshes, up to 30,000 polygons
• Smart Restrictions: Smart Topology requires one image. Standard Meshy 6 Lite, 6, and 7.1 support multiple images; Maximum 3D model detail needs a single image

Geometry Controls#

• Target Polycount: Adjustable from 100 to 60,000 polygons in Standard mode and up to 15,000 in Smart Topology (30,000 with Meshy T2.5)
  • How many faces the model has: more faces mean a heavier file and longer generation
  • Default: 40,000 polygons in Standard mode and 4,000 in Smart Topology
• 3D model detail: How precisely the shape is reproduced. It affects only the shape, not the texture: polygon count sets the file weight, detail sets the precision. With Meshy 7.1 choose Standard (recommended in most cases), High (detailed furniture and clothing) or Maximum (jewelry, watches, electronics). High and Maximum cost 5 additional credits; Maximum is shown but disabled until a single photo is left
• 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.1, or Smart Topology, you can choose the resolution of the generated base color texture. It sets how sharp the color and pattern on the surface are and does not affect the shape. Only 8K costs extra:

• 2K: Standard sharpness, 2048×2048 (default)
• 4K: High sharpness, 4096×4096
• 8K: Maximum sharpness, 8192×8192, 5 additional credits

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

Photo enhancement is free and on by default with Meshy 6 and 7.1: AI prepares the photo so the model comes out cleaner. Turn it off if the model must match the photo exactly. 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