---
title: TripoSG Image-to-3D API
emoji: 😻
colorFrom: pink
colorTo: blue
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
python_version: "3.10.12"
pinned: false
---

# TripoSG Image-to-3D API

This Space wraps the official TripoSG pipeline and exposes a `/predict` API endpoint for programmatic generation of GLB meshes.

## API usage

Python:

```python
from gradio_client import Client

client = Client("your-username/your-space")
result = client.predict(
    image_path="input.png",
    seed=0,
    num_inference_steps=50,
    guidance_scale=7.5,
    simplify=True,
    target_face_num=100000,
    api_name="/predict",
)
print(result)
```

Raw HTTP (example):

```bash
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"data": ["data:image/png;base64,......", 0, 50, 7.5, true, 100000]}' \
  https://your-username-your-space.hf.space/call/predict
```

The response contains the generated GLB file path and URL.

## Notes

- The Space will clone `VAST-AI-Research/TripoSG` at runtime and download weights from `VAST-AI/TripoSG` and `briaai/RMBG-1.4`.
- `requirements.txt` targets the default Hugging Face Spaces GPU runtime (Linux). For local runs, adjust Torch/CUDA and the `diso` wheel as needed.