kizukuno/image-to-3d-api

🐺 Image to 3D High Quality Converter

Python script to convert any 2D image into a 3D model (GLB format) using multiple APIs.

Quick Start

FREE Methods (No API Key!)

Method 1 - StabilityAI Stable Fast 3D (Recommended for first try):

pip install gradio_client
python image_to_3d_converter.py your_image.png --method 1

Method 2 - InstantMesh (Faster, simpler):

python image_to_3d_converter.py your_image.png --method 2

PAID Methods (Higher Quality)

Method 3 - Meshy AI (PBR textures, best materials):

export MESHY_API_KEY="your-key-here"
python image_to_3d_converter.py your_image.png --method 3

Get key: https://meshy.ai

Method 4 - Tripo3D (Best for characters):

export TRIPO_API_KEY="your-key-here"
python image_to_3d_converter.py your_image.png --method 4

Get key: https://platform.tripo3d.ai

Try All Methods

python image_to_3d_converter.py your_image.png --method all

Output

All generated .glb files are saved to outputs/ folder. View them with:

• Browser: https://3dviewer.net (drag & drop)
• Blender: File → Import → glTF 2.0 (.glb)

Pipeline Diagram

Input Image
    ↓
Background Removal (auto)
    ↓
Depth Estimation / Multi-View Generation
    ↓
3D Mesh Generation (GLB format)
    ↓
PBR Textures (on paid methods)

Links

• HuggingFace Repo