Skip to content

Hyper3D - Rodin V2.5 - Image to 3D - Fast

Integrate

Model id hyper3d/rodin/v2.5/fast
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.10 100 API credits Run it on this page

Get API key
Hyper3D Image to 3D 4K outputFast #image-to-3d

Faster Rodin V2.5 image-to-3D limited to the three lowest tiers for quick prototyping

Hyper3D · 3D

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

0 / 1024

Guide generation with text, or let the model derive a prompt automatically from the images by leaving this empty in Image-to-3D mode.

Advanced images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition
image_urls
Drop a file, or · up to 5

Source image URLs, limited to 5 images and mandatory in Image-to-3D mode, for generating the model.

geometry_file_format default glb

Geometry file format, selected from glb, usdz, fbx, obj, stl; defaults to glb.

material default Shaded

Material output selection: choose None for geometry without textures, or All to receive both material variants. For realistic lighting with physically based materials, choose PBR; for baked lighting without PBR maps, choose Shaded.

texture_mode

Choose the texture quality explicitly or leave the choice to the API, which uses a default suited to the tier.

default Gen-2.5-Extreme-Low

Generation tier; Gen-2.5-Minimum forces minimum mode and a 50K Triangle mesh regardless of `quality_mesh_option`. Tier details are available in the [Hyper3D documentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

default Auto

Choose quality together with mesh topology: Quad favors smooth surfaces, while Triangle favors geometric detail. The fast endpoint is intended mainly for testing and prototyping, with a 20K cap; use the standard endpoint for higher-quality meshes, where Minimum, Extreme-Low, and Low support up to 1M Triangle, with available face counts depending on tier. In the Hyper3D API, `quality_override` specifies face count, while `mesh_mode` specifies Quad/Raw. Auto selects the recommended settings: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Optional randomization seed with a range of 0–65535.

Limit how large the generated model can be using a ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 quote → $0.10
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Hyper3D - Rodin V2.5 - Image to 3D - Fast

Creates a 3D model from one to five images in `image_urls`, with an optional `prompt`. The `tier` is limited to Minimum, Extreme-Low (default) and Low, and mesh options top out at 20K faces. Material defaults to Shaded. Output formats are glb, usdz, fbx, obj or stl.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlsoptional images
Typeurl[] · image
≤ 5 items
Source image URLs, limited to 5 images and mandatory in Image-to-3D mode, for generating the model.
tieroptional
Typeenum
DefaultGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Generation tier; Gen-2.5-Minimum forces minimum mode and a 50K Triangle mesh regardless of `quality_mesh_option`. Tier details are available in the [Hyper3D documentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptoptional
Typestring
Default
≤ 1,024 characters
Guide generation with text, or let the model derive a prompt automatically from the images by leaving this empty in Image-to-3D mode.
use_original_alphaoptional
Typeboolean
Defaultfalse
Controls retention of input-image transparency channels when generating 3D content.
seedoptional
Typeinteger | null
0 – 65,535
Optional randomization seed with a range of 0–65535.
geometry_file_formatoptional
Typeenum
Defaultglb
glbusdzfbxobjstl
Geometry file format, selected from glb, usdz, fbx, obj, stl; defaults to glb.
materialoptional
Typeenum
DefaultShaded
PBRShadedAllNone
Material output selection: choose None for geometry without textures, or All to receive both material variants. For realistic lighting with physically based materials, choose PBR; for baked lighting without PBR maps, choose Shaded.
quality_mesh_optionoptional
Typeenum
DefaultAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Choose quality together with mesh topology: Quad favors smooth surfaces, while Triangle favors geometric detail. The fast endpoint is intended mainly for testing and prototyping, with a 20K cap; use the standard endpoint for higher-quality meshes, where Minimum, Extreme-Low, and Low support up to 1M Triangle, with available face counts depending on tier. In the Hyper3D API, `quality_override` specifies face count, while `mesh_mode` specifies Quad/Raw. Auto selects the recommended settings: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeoptional
Typeenum
legacyextreme-lowlowmediumhigh
Choose the texture quality explicitly or leave the choice to the API, which uses a default suited to the tier.
enable_creative_modeoptional
Typeboolean
Defaultfalse
Creative generation mode, equivalent to `geometry_instruct_mode` set to `creative` in the Hyper3D API. Enabling it makes generation more robust without sacrificing output consistency.
hd_textureoptional
Typeboolean
Defaultfalse
Controls advanced texture post-processing to improve visual fidelity.
texture_delightoptional
Typeboolean
Defaultfalse
Strips baked-in illumination and highlights out of generated textures.
is_microoptional
Typeboolean
Defaultfalse
Adds finer geometric detail at micro scale; takes effect only when `tier="Gen-2.5-Extreme-High"`.
TAPoseoptional
Typeboolean
Defaultfalse
Character pose setting for easier rigging and animation in 3D software: enabling it generates characters in either T-pose or A-pose.
bbox_conditionoptional
Typeobject
Limit how large the generated model can be using a ControlNet.
bbox_condition.widthoptional
Typeinteger
Default0
1 – 2,048
Bounding box constraint width along the x axis.
bbox_condition.heightoptional
Typeinteger
Default0
1 – 2,048
Bounding box constraint height along the y axis.
bbox_condition.lengthoptional
Typeinteger
Default0
1 – 2,048
Bounding box constraint length along the z axis.
preview_renderoptional
Typeboolean
Defaultfalse
Preview-render toggle that adds an image showing the generated 3D model to the delivered model files.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_meshes": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42,
    "textures": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
model_mesh
object {url, content_type, file_name, file_size}File containing the generated 3D object.
model_meshes
array of object {url, content_type, file_name, file_size}Extra 3D object files generated by Hyper3D and returned in addition to model_mesh.
seed
integerSeed applied during generation.
textures
array of object {url, content_type, file_name, file_size, width, height}Textures produced for the 3D object.

More models: Image to 3D

For AI agents: this page as Markdown is at https://doitong.com/developers/models/hyper3d/rodin/v2.5/fast.md. All models and guides: https://doitong.com/developers/llms.txt