# Hyper3D - Rodin V2.5 - Text to 3D - Fast

> Rodin V2.5 by Hyper3D generates realistic and production ready 3D models from text or images. Do fast prototyping using the fast model. 


## Overview

- **Endpoint**: `https://fal.run/fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast`
- **Model ID**: `fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast`
- **Category**: text-to-3d
- **Kind**: inference
**Tags**: text-to-3d



## Pricing

Your request will cost **$0.4** per generation. Furthermore, if **HighPack** is added to the `addons`, it will cost an additional **$0.8** per generation.

For more details, see [fal.ai pricing](https://fal.ai/pricing).

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:


- **`prompt`** (`string`, _required_):
  A textual prompt to guide model generation. Required for Text-to-3D mode.
  - Examples: "A futuristic robot with sleek metallic design."

- **`tier`** (`TierEnum`, _optional_):
  Generation tier. Higher tiers produce more detailed meshes but cost more. See more info in the [documentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers). Selecting Gen-2.5-Minimum will automatically configure to a minimum mode, where 50K Triangle is selected, taking priority over quality_mesh_option. Default value: `"Gen-2.5-Extreme-Low"`
  - Default: `"Gen-2.5-Extreme-Low"`
  - Options: `"Gen-2.5-Minimum"`, `"Gen-2.5-Extreme-Low"`, `"Gen-2.5-Low"`

- **`seed`** (`integer`, _optional_):
  Seed value for randomization, ranging from 0 to 65535. Optional.
  - Range: `0` to `65535`

- **`geometry_file_format`** (`GeometryFileFormatEnum`, _optional_):
  Format of the geometry file. Possible values: glb, usdz, fbx, obj, stl. Default is glb. Default value: `"glb"`
  - Default: `"glb"`
  - Options: `"glb"`, `"usdz"`, `"fbx"`, `"obj"`, `"stl"`

- **`material`** (`MaterialEnum`, _optional_):
  Material type. PBR: physically-based materials with realistic lighting. Shaded: baked lighting with no PBR maps. All: both PBR and Shaded variants. None: geometry only with no textures. Default value: `"All"`
  - Default: `"All"`
  - Options: `"PBR"`, `"Shaded"`, `"All"`, `"None"`

- **`quality_mesh_option`** (`QualityMeshOptionEnum`, _optional_):
  Combined quality and mesh type selection. Quad = smooth surfaces, Triangle = detailed geometry. Maps to `mesh_mode` (Quad/Raw) and `quality_override` (face count) on the Hyper3D API. Valid face counts depend on the selected tier. Up to 1M Triangle is supported for tiers Minimum, Extreme-Low, Low. For fast endpoint, this limit is up to 20K, primarily for prototyping and testing. For generating higher quality meshes, use the standard endpoint. Auto option will choose the advised options for each tier:
  1. Gen-2.5-Minimum: 20K Triangle
  2. Gen-2.5-Extreme-Low: 20K Triangle
  3. Gen-2.5-Low: 20K Triangle Default value: `"Auto"`
  - Default: `"Auto"`
  - Options: `"Auto"`, `"1K Quad"`, `"4K Quad"`, `"8K Quad"`, `"18K Quad"`, `"20K Quad"`, `"2K Triangle"`, `"4K Triangle"`, `"8K Triangle"`, `"10K Triangle"`, `"20K Triangle"`

- **`texture_mode`** (`Enum`, _optional_):
  Texture generation quality. When unset, the API picks a default appropriate for the tier.
  - Options: `"legacy"`, `"extreme-low"`, `"low"`, `"medium"`, `"high"`

- **`enable_creative_mode`** (`boolean`, _optional_):
  If enabled, the generation will have enhanced generative robustness while ensuring output consistency. This corresponds to `geometry_instruct_mode` being equal to `creative` on the Hyper3D API.
  - Default: `false`

- **`hd_texture`** (`boolean`, _optional_):
  Enables enhanced texture post-processing for higher visual fidelity.
  - Default: `false`

- **`texture_delight`** (`boolean`, _optional_):
  Removes baked lighting/highlights from the generated textures.
  - Default: `false`

- **`is_micro`** (`boolean`, _optional_):
  Generate finer micro-scale geometric detail. Only effective with `tier="Gen-2.5-Extreme-High"`.
  - Default: `false`

- **`TAPose`** (`boolean`, _optional_):
  Generate characters in T-pose or A-pose format, making them easier to rig and animate in 3D software.
  - Default: `false`

- **`bbox_condition`** (`RodinGen25BbboxField`, _optional_):
  This is a controlnet that controls the maximum sized of the generated model.

- **`addons`** (`RodinGen25Addons`, _optional_):
  Optional add-ons



**Required Parameters Example**:

```json
{
  "prompt": "A futuristic robot with sleek metallic design."
}
```

**Full Example**:

```json
{
  "prompt": "A futuristic robot with sleek metallic design.",
  "tier": "Gen-2.5-Extreme-Low",
  "geometry_file_format": "glb",
  "material": "All",
  "quality_mesh_option": "Auto"
}
```


### Output Schema

The API returns the following output format:

- **`model_mesh`** (`File`, _required_):
  Generated 3D object file.
  - Examples: {"url":"https://storage.googleapis.com/falserverless/model_tests/video_models/base_basic_shaded.glb"}

- **`model_meshes`** (`list<File>`, _optional_):
  Additional generated 3D object files returned by Hyper3D besides model_mesh.
  - Array of File

- **`seed`** (`integer`, _required_):
  Seed value used for generation.

- **`textures`** (`list<Image>`, _required_):
  Generated textures for the 3D object.
  - Array of Image



**Example Response**:

```json
{
  "model_mesh": {
    "url": "https://storage.googleapis.com/falserverless/model_tests/video_models/base_basic_shaded.glb"
  },
  "model_meshes": [
    {
      "url": "",
      "content_type": "image/png",
      "file_name": "z9RV14K95DvU.png",
      "file_size": 4404019
    }
  ],
  "textures": [
    {
      "url": "",
      "content_type": "image/png",
      "file_name": "z9RV14K95DvU.png",
      "file_size": 4404019,
      "width": 1024,
      "height": 1024
    }
  ]
}
```


## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://fal.run/fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
     "prompt": "A futuristic robot with sleek metallic design."
   }'
```

### Python

Ensure you have the Python client installed:

```bash
pip install fal-client
```

Then use the API client to make requests:

```python
import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast",
    arguments={
        "prompt": "A futuristic robot with sleek metallic design."
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)
```

### JavaScript

Ensure you have the JavaScript client installed:

```bash
npm install --save @fal-ai/client
```

Then use the API client to make requests:

```javascript
import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast", {
  input: {
    prompt: "A futuristic robot with sleek metallic design."
  },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);
```


## Additional Resources

### Documentation

- [Model Playground](https://fal.ai/models/fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast)
- [API Documentation](https://fal.ai/models/fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast/api)
- [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/hyper3d/rodin/v2.5/text-to-3d/fast)

### fal.ai Platform

- [Platform Documentation](https://docs.fal.ai)
- [Python Client](https://docs.fal.ai/clients/python)
- [JavaScript Client](https://docs.fal.ai/clients/javascript)