๐ŸŽจ Image to 3D Model Generator

Generate textured 3D models from images using AI. Upload an image and get a downloadable 3D model!

Powered by Hunyuan3D-2.1 via RunPod Serverless

๐Ÿ“ธ Input

Get your API key and Endpoint ID from RunPod Dashboard

You can also set them as environment variables:

  • RUNPOD_API_KEY
  • RUNPOD_ENDPOINT_ID
Example Images (add your own in /examples folder)

๐ŸŽฏ Output

๐Ÿ“ Output Files Include:

  • demo_textured.obj - 3D model geometry
  • demo_textured.jpg - Color texture
  • demo_textured.mtl - Material definition
  • demo_textured_metallic.jpg - Metallic map
  • demo_textured_roughness.jpg - Roughness map

๐Ÿ’ก Tips:

  • Works best with clear object images on white/transparent background
  • Single object works better than complex scenes
  • Processing takes 2-5 minutes depending on server load
  • You can import the GLB file into Blender, Unity, Unreal Engine, etc.

๐Ÿ”ง Troubleshooting

Error: No API key/endpoint ID

  • Set them in the configuration accordion above
  • Or set as environment variables in Hugging Face Space settings

Error: Request timeout

  • The endpoint might be cold-starting (first request takes longer)
  • Try again after a few minutes

Error: GPU out of memory

  • The RunPod endpoint might need more VRAM
  • Try using a larger GPU tier in RunPod settings

Model looks incorrect

  • Try using a clearer image with better lighting
  • Ensure the object is centered and on a plain background

๐Ÿ“š Resources