# hyper3d Rodin 2.5 Image to 3D API

> Rodin Gen-2.5 by Hyper3D (Deemos) generates game- and production-ready 3D assets from one to five reference images.

Source: https://www.sandbase.ai/models/hyper3d/rodin/2.5/image-to-3d
API reference: https://www.sandbase.ai/models/hyper3d/rodin/2.5/image-to-3d/docs

## Facts

- Provider: hyper3d
- Type: Image model
- Model ID: `hyper3d/rodin/2.5/image-to-3d`
- Price: From $0.48 per run
- Capabilities: image to 3d
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hyper3d/rodin/2.5/image-to-3d",
  "tier": "Gen-2.5-High",
  "TAPose": false,
  "images": [
    "https://v3.fal.media/files/panda/l7mQrG8plbB42lBNqVjm0_image.png",
    "https://v3b.fal.media/files/b/kangaroo/scq50Bf1PB2NZOW8szphV_image.png",
    "https://v3.fal.media/files/penguin/X21qtlVMazAtljzRCJD2__image.png"
  ],
  "prompt": "A futuristic robot with sleek metallic design.",
  "material": "All",
  "hd_texture": false,
  "quality_mesh_option": "Auto",
  "geometry_file_format": "glb"
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call hyper3d Rodin 2.5 Image to 3D through SandBase?

Create a SandBase API key, then send requests with the model ID "hyper3d/rodin/2.5/image-to-3d" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate hyper3d account?

No. One SandBase API key and balance gives you access to hyper3d Rodin 2.5 Image to 3D and the other models in the catalog; you do not need to sign up with hyper3d separately.

## README

### Rodin 2.5 Image to 3D

Rodin Gen-2.5 by Hyper3D turns an image set of 1–5 views into a production-ready 3D asset with PBR materials and quad or triangle meshes.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string | — | Up to 1,024 characters. |
| `images` | image URL[] (≤5), required | — | 1–5 reference images of the object. |
| `geometry_file_format` | `glb` / `usdz` / `fbx` / `obj` / `stl` | `glb` | Output file format. |
| `quality_mesh_option` | `Auto` / `4K Quad` / `8K Quad` / `18K Quad` / `50K Quad` / `100K Quad` / `200K Quad` / `2K Triangle` / `20K Triangle` / `50K Triangle` / `150K Triangle` / `500K Triangle` / `1M Triangle` / `2M Triangle` | `Auto` | Mesh density and topology. |
| `addons` | `HighPack` | — | `HighPack` adds high-resolution textures and denser meshes. |
| `TAPose` | boolean | false | Force a T/A-pose for characters. |
| `hd_texture` | boolean | false | Higher-resolution textures. |
| `tier` | `Gen-2.5-Minimum` / `Gen-2.5-Extreme-Low` / `Gen-2.5-Low` / `Gen-2.5-Medium` / `Gen-2.5-High` / `Gen-2.5-Extreme-High` | `Gen-2.5-High` | Quality tier. |
| `material` | `PBR` / `Shaded` / `All` / `None` | `All` | Material output. |
| `seed` | integer 0–65535 | random | Fix it to compare prompt changes. |

#### Billing

$0.48 per model ($0.96 on the Extreme-High tier), plus $0.96 for the HighPack add-on.

| Request | Price |
|---|---|
| Default tier | $0.48 |
| Extreme-High tier | $0.96 |
| Default + HighPack | $1.44 |

Failed runs are not charged.

#### Prompting

- Use clean, evenly lit views on a plain background.

#### Also on SandBase

Other Rodin endpoints: `hyper3d/rodin/2.5/text-to-3d`, `hyper3d/rodin/2.5/fast/text-to-3d`, `hyper3d/rodin/2.5/fast/image-to-3d`.