Troubleshooting Guide

Troubleshooting Guide

Encountering issues with 3D AI Studio? This comprehensive troubleshooting guide provides solutions to the most common problems users face, from generation errors to browser compatibility issues. Find quick solutions and detailed explanations to get back to creating amazing 3D models.

💳 Credit Refund Policy

Important: When generation processes fail or encounter errors, your credits are automatically refunded to your account. If you don't see the refunded credits immediately, refresh the page or check your account balance again after a few minutes. The refund system ensures you never lose credits due to technical issues or failed generations.

Quick Problem Solver

🚨 Most Common Issues:


Generation Problems

Generation Failed Error

Symptoms: Generation process starts but fails with error message Causes: Server overload, invalid input, or network issues

Solutions:

  1. Check Your Internet Connection

    • Ensure stable internet connection (minimum 5 Mbps recommended)
    • Try refreshing the page and attempting generation again
    • Close other bandwidth-intensive applications
  2. Validate Your Input

    • Text Prompts: Ensure prompts are in supported languages and under character limits
    • Image Uploads: Verify file format (PNG, JPG, JPEG) and size (under 50MB)
    • Model Uploads: Check supported formats (FBX, OBJ, STL, GLB, GLTF)
  3. Server Status Check

    • Wait 5-10 minutes and retry if server is experiencing high load
    • Try generation during off-peak hours for faster processing
    • Contact support@3daistudio.com if issues persist

Generation Taking Too Long

Symptoms: Generation process stuck at processing stage Expected Times: Text-to-3D: 30-90 seconds, Image-to-3D: 60-120 seconds

Solutions:

  1. Standard Wait Times

    • Allow up to 2 minutes for simple models
    • Complex models may take up to 5 minutes
    • High-resolution texture generation can take 3-5 minutes
  2. If Stuck Beyond Normal Times:

Poor Generation Quality

Symptoms: Generated models lack detail or don't match expectations

Solutions:

  1. Improve Your Prompts

    • Use detailed, specific descriptions (see Prompt Guidelines)
    • Include style keywords: "highly detailed", "professional quality", "8K"
    • Specify materials: "wood texture", "metallic finish", "ceramic surface"
  2. Optimize Input Images

    • Use high-resolution images (minimum 512x512 pixels)
    • Ensure clear background separation
    • Good lighting and contrast in source images
    • Consider using background removal tools before upload
  3. Adjust Generation Settings

    • Enable PBR texture generation for better materials
    • Try multiple generations with slightly different prompts
    • Use the remesh tool for topology optimization

Upload Problems

Upload Failed Error

Symptoms: File upload fails or gets stuck during upload process

Solutions:

  1. File Format Verification

    • Images: PNG, JPG, JPEG only
    • 3D Models: FBX, OBJ, STL, GLB, GLTF
    • Textures: PNG, JPG for texture maps
  2. File Size Limits

    • Images: Maximum 50MB per file
    • 3D Models: Maximum 50MB per file
    • Total Project: Keep under 200MB for best performance
  3. File Integrity Check

    • Ensure files aren't corrupted
    • Try saving/exporting the file again from source software
    • Test with a smaller file first to isolate the issue

Unsupported File Format

Symptoms: Error message about unsupported file type

Solutions:

  1. Convert to Supported Format

    • Use free tools like Blender to convert 3D models
    • Use image editors to convert to PNG/JPG
    • Export models with proper UV mapping
  2. Export Settings for 3D Models

    • From Blender: Export as FBX or OBJ with textures embedded
    • From Maya: Use FBX export with materials included
    • From 3ds Max: Export FBX with texture references

Browser Issues

Browser Compatibility Problems

Symptoms: Interface not loading correctly, features not working, poor performance

Recommended Browsers:

  • Chrome (Latest version) - Best performance
  • Firefox (Latest version) - Good compatibility
  • Safari (Latest version) - Mac users
  • Edge (Latest version) - Windows users
  • Internet Explorer - Not supported

Solutions:

  1. Update Your Browser

    • Use the latest version of your browser
    • Enable automatic updates for security and compatibility
    • Clear browser cache and cookies regularly
  2. Enable Required Features

    • Enable JavaScript (required for all functionality)
    • Allow WebGL for 3D model viewing
    • Enable hardware acceleration for better performance
    • Allow camera access if using webcam features
  3. Browser Settings Optimization

    • Disable ad blockers on 3daistudio.com
    • Allow pop-ups for download functionality
    • Enable local storage for session management
    • Ensure cookies are enabled for login persistence

WebGL Issues

Symptoms: 3D viewer not working, black screen in model preview

Solutions:

  1. Enable WebGL

    • Chrome: Visit chrome://settings/content/unsandboxedPlugins
    • Firefox: Visit about:config and enable webgl.force-enabled
    • Safari: Enable WebGL in Developer menu
  2. Update Graphics Drivers

    • Download latest drivers for your graphics card
    • Restart computer after driver installation
    • Check graphics card compatibility with WebGL
  3. Hardware Acceleration

    • Enable hardware acceleration in browser settings
    • Close other graphics-intensive applications
    • Try a different device if issues persist

Download Issues

Download Failed or Incomplete

Symptoms: Download doesn't start, file is corrupted, or download interrupts

Solutions:

  1. Browser Download Settings

    • Check browser download permissions
    • Ensure sufficient storage space available
    • Disable download managers that might interfere
  2. Network Solutions

    • Use stable, fast internet connection
    • Pause other downloads during model download
    • Try downloading during off-peak hours
  3. File Format Selection

    • Try different export formats (FBX, OBJ, STL)
    • Download individual components separately
    • Use lower resolution if file size is an issue

Downloaded Model Issues

Symptoms: Model appears broken, textures missing, or won't open in software

Solutions:

  1. Texture Path Issues

    • Keep all downloaded files in the same folder
    • Use OBJ format with MTL files for better compatibility
    • Re-download if textures are missing
  2. Software Compatibility

    • Try opening in different 3D software
    • Use FBX format for game engines
    • Use STL format for 3D printing applications

Quality Issues

Low-Detail Models

Symptoms: Models lack surface detail, appear simplified or blocky

Solutions:

  1. Prompt Optimization

    • Add detail-focused keywords: "intricate details", "high resolution"
    • Specify texture information: "detailed wood grain", "weathered metal"
    • Include lighting terms: "studio lighting", "dramatic shadows"
  2. Input Image Quality

    • Use higher resolution source images (1024x1024 or larger)
    • Ensure good lighting in reference photos
    • Clear, uncluttered backgrounds work best
  3. Post-Processing Options

    • Use the remesh tool for topology improvement
    • Apply AI texture generation for enhanced surfaces
    • Consider multiple generations and select the best result

Texture Problems

Symptoms: Blurry textures, incorrect colors, or missing material details

Solutions:

  1. Generation Settings

    • Enable PBR texture generation
    • Select higher resolution options (2K or 4K)
    • Use texture-specific prompts for materials
  2. UV Mapping Issues

    • Use the remesh tool to fix UV coordinates
    • Try different export formats for better texture support
    • Ensure models have proper UV unwrapping

Performance Optimization

Slow Interface Performance

Symptoms: Slow loading, laggy interface, delayed responses

Solutions:

  1. Browser Optimization

    • Close unnecessary browser tabs
    • Clear browser cache and cookies
    • Disable unnecessary browser extensions
    • Use incognito/private mode for testing
  2. System Resources

    • Close other resource-intensive applications
    • Ensure adequate RAM available (8GB+ recommended)
    • Use wired internet connection when possible
  3. Hardware Recommendations

    • Minimum: 4GB RAM, modern graphics card
    • Recommended: 8GB+ RAM, dedicated graphics card
    • Optimal: 16GB+ RAM, modern GPU with WebGL support

Model Viewer Performance

Symptoms: Slow 3D model rotation, choppy animation, long loading times

Solutions:

  1. Graphics Settings

    • Update graphics drivers
    • Enable hardware acceleration
    • Close other graphics-intensive applications
  2. Model Complexity

    • Use lower resolution for preview purposes
    • Apply remesh optimization for large models
    • Consider model complexity vs. performance needs

Error Code Reference

Common Error Messages

"Authentication Failed"

  • Solution: Log out and log back in
  • Clear browser cookies and cache
  • Check internet connection stability

"Quota Exceeded"

  • Solution: Check your account credit balance
  • Upgrade plan if needed for additional credits
  • Contact support for quota clarification

"File Too Large"

  • Solution: Reduce file size below 50MB limit
  • Compress images before upload
  • Use lower resolution or different format

"Invalid File Format"

  • Solution: Convert to supported format
  • Check file isn't corrupted during transfer
  • Use proper export settings from source software

"Server Error 500"


Getting Additional Help

When to Contact Support

Contact support@3daistudio.com if you experience:

  • Repeated generation failures after trying solutions
  • Account or billing issues
  • Feature requests or bug reports
  • Technical issues not covered in this guide

Information to Include in Support Requests

  1. Browser and Device Information

    • Browser type and version
    • Operating system details
    • Device specifications (RAM, graphics card)
  2. Problem Description

    • Exact error messages received
    • Steps taken before the issue occurred
    • Screenshots or screen recordings if helpful
  3. Account Details

    • Account email address
    • Approximate time when issue occurred
    • Specific feature or tool experiencing problems

Community Resources


Prevention and Best Practices

Avoiding Common Issues

  1. Regular Maintenance

    • Keep browsers updated to latest versions
    • Clear cache weekly for optimal performance
    • Update graphics drivers regularly
  2. Optimal Workflow Practices

    • Save work frequently using bookmarks or project saves
    • Use descriptive filenames for easy organization
    • Test with simple models before complex projects
  3. Quality Assurance

    • Preview models in 3D viewer before downloading
    • Test downloaded models in target software
    • Keep backup copies of important source files

System Maintenance Tips

  1. Regular Cleanup

    • Clear browser cache weekly
    • Remove old downloads to free storage space
    • Keep only necessary browser extensions enabled
  2. Performance Monitoring

    • Monitor system resource usage during generation
    • Close unnecessary applications during intensive tasks
    • Restart browser periodically for optimal performance

Still experiencing issues? Contact our support team at support@3daistudio.com or join our Discord community (opens in a new tab) for peer assistance. Our team is dedicated to ensuring you have the best possible experience with 3D AI Studio.