๐จ 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_KEYRUNPOD_ENDPOINT_ID
Example Images (add your own in /examples folder)
๐ฏ Output
๐ Output Files Include:
demo_textured.obj- 3D model geometrydemo_textured.jpg- Color texturedemo_textured.mtl- Material definitiondemo_textured_metallic.jpg- Metallic mapdemo_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