Hyper3d Rodin V2.5 Image To 3d
Playground
Try it on WavespeedAI!Hyper3D Rodin v2.5 is a fast AI image-to-3D generation model that turns reference images into production-ready 3D assets with clean meshes, UVs, and textures. Ready-to-use REST inference API for game assets, e-commerce 3D models, product visualization, AR/VR content, digital twins, creative design, and professional 3D asset generation workflows with simple integration, no coldstarts, and affordable pricing.
Features
Hyper3D Rodin V2.5 Image-to-3D
Hyper3D Rodin V2.5 Image-to-3D generates 3D assets from one or more reference images, with optional text guidance and flexible controls for mesh density, texture output, geometry behavior, symmetry, pose, and export format. It is suitable for product concepts, stylized objects, character prototyping, game assets, and other image-to-3D workflows where you want direct control over geometry and material output.
Why Choose This?
-
Image-guided 3D generation
Turn one or more reference images into a 3D asset with minimal setup. -
Flexible mesh and quality options
Choose between quad and triangle outputs across multiple density levels. -
Material and texture control
Generate PBR, shaded, full material sets, or geometry-only output depending on your workflow. -
Geometry behavior settings
Usegeometry_instruct_mode, symmetry options, and micro-detail settings to shape how the asset is built. -
Multiple export formats
Export asglb,usdz,fbx,obj, orstl. -
Production-ready workflow
Useful for concept art, product prototyping, game asset generation, and 3D content pipelines.
Parameters
| Parameter | Required | Description |
|---|---|---|
| images | Yes | Reference images for generating the 3D model. Upload 1–5 images. |
| prompt | No | Optional text prompt. If empty, the model auto-generates a prompt from the images. |
| tier | No | Generation tier. Supported values: Gen-2.5-Extreme-Low, Gen-2.5-Low, Gen-2.5-Medium, Gen-2.5-High, Gen-2.5-Extreme-High. Default: Gen-2.5-Medium. |
| use_original_alpha | No | Preserve the transparency channel from input images. Default: false. |
| geometry_file_format | No | Output geometry file format. Supported values: glb, usdz, fbx, obj, stl. Default: glb. |
| material | No | Material output type. Supported values: PBR, Shaded, All, None. Default: All. |
| quality_and_mesh | No | Combined quality and mesh type selection. Supported values: 4K Quad, 8K Quad, 18K Quad, 50K Quad, 2K Triangle, 20K Triangle, 150K Triangle, 500K Triangle. Default: 500K Triangle. |
| texture_mode | No | Texture generation quality. Supported values: legacy, extreme-low, low, medium, high. Leave empty to let the provider choose. |
| geometry_instruct_mode | No | Geometry instruction mode. Supported values: faithful, creative. Default: faithful. |
| hd_texture | No | Enable enhanced texture post-processing. Default: false. |
| texture_delight | No | Remove baked lighting and highlights from generated textures. Default: false. |
| is_symmetric | No | Symmetry mode for the generated mesh. Supported values: symmetric, balanced, asymmetric, unknown. Default: unknown. |
| is_micro | No | Generate finer micro-scale geometric detail. Only effective with Gen-2.5-Extreme-High. Default: false. |
| ta_pose | No | Generate characters in T-pose or A-pose format. Default: false. |
| addons | No | Optional add-on. Supported value: HighPack. Enables 4K textures and higher-poly geometry. |
| preview_render | No | Generate a preview render image of the 3D model. Default: false. |
How to Use
- Upload your reference images — provide
1–5images of the object, character, or asset you want to generate. - Add a prompt (optional) — describe the asset if you want to guide shape, style, or design intent more explicitly.
- Choose a tier — use the default tier for general work, or select
Gen-2.5-Extreme-Highwhen you need the highest-quality generation. - Choose mesh and format settings — set
quality_and_mesh,geometry_file_format, andmaterialbased on your downstream use. - Adjust geometry and texture controls (optional) — fine-tune
texture_mode,geometry_instruct_mode,is_symmetric,hd_texture, and related settings. - Add HighPack (optional) — enable
addons = HighPackif you need higher-end texture and geometry output. - Submit — run the model and download the generated 3D asset.
Example Use Case
Generate a clean 3D product model from multiple reference photos, with PBR materials and quad mesh output for downstream rendering or e-commerce visualization.
Pricing
Pricing is charged per generation.
| Configuration | Cost |
|---|---|
| Standard tier | $0.40 |
| Gen-2.5-Extreme-High | $0.80 |
| Standard tier + HighPack | $1.20 |
| Gen-2.5-Extreme-High + HighPack | $1.60 |
Billing Rules
- Base price is $0.40 per generation
Gen-2.5-Extreme-Highcosts 2× the base priceHighPackadds an additional $0.80 per generationHighPackandGen-2.5-Extreme-Highstack together- Other parameters do not affect pricing
Best Use Cases
- Product concept modeling — Build 3D product shapes from reference photos.
- Game asset prototyping — Generate early 3D assets for props, items, and stylized objects.
- Character base generation — Create starting meshes for stylized or realistic character workflows.
- AR/VR content preparation — Build assets for immersive applications and previews.
- Creative 3D ideation — Rapidly test multiple visual directions before manual refinement.
Pro Tips
- Upload clean, well-lit reference images for better shape and texture consistency.
- Use multiple views when structure accuracy matters.
- Use
faithfulgeometry mode when image fidelity matters more than creative interpretation. - Use
creativewhen you want the model to take more design liberties. - Choose quad output when downstream retopology or sculpting workflows matter.
- Use
texture_delightif you want cleaner textures with less baked lighting. - Only enable
is_microwhen usingGen-2.5-Extreme-High, since it has no effect otherwise. - Add
HighPackonly when you need the extra texture and geometry quality, since it increases cost significantly.
Notes
imagesis required.- You can upload up to 5 reference images.
promptis optional; if omitted, the model can infer guidance from the images.Gen-2.5-Extreme-Highdoubles the base generation cost.HighPackadds an extra fixed charge on top of the selected tier.is_microis only effective withGen-2.5-Extreme-High.geometry_file_formatdefaults toglb.materialdefaults toAll.quality_and_meshdefaults to500K Triangle.
Related Models
- Hyper3D Rodin V2.5 Text-to-3D — Generate 3D assets directly from text prompts.
- Other Hyper3D Rodin workflows — Useful when you need different 3D generation paths or input modalities.
- 3D asset generation pipelines — Useful when image-to-3D is only one part of a broader modeling workflow.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/hyper3d/rodin-v2.5/image-to-3d" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"tier": "Gen-2.5-Medium",
"use_original_alpha": false,
"geometry_file_format": "glb",
"material": "All",
"quality_and_mesh": "500K Triangle",
"geometry_instruct_mode": "faithful",
"hd_texture": false,
"texture_delight": false,
"is_symmetric": "unknown",
"is_micro": false,
"ta_pose": false,
"preview_render": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| images | array | Yes | [] | 1 ~ 5 items | Reference images for generating the 3D model. Up to 5 images are allowed. |
| prompt | string | No | - | Optional text prompt. If empty, the model auto-generates a prompt from the images. | |
| tier | string | No | Gen-2.5-Medium | Gen-2.5-Extreme-Low, Gen-2.5-Low, Gen-2.5-Medium, Gen-2.5-High, Gen-2.5-Extreme-High | Generation tier. Extreme-High bills at double the base rate. |
| use_original_alpha | boolean | No | false | - | Preserve the transparency channel from input images. |
| geometry_file_format | string | No | glb | glb, usdz, fbx, obj, stl | Output geometry file format. |
| material | string | No | All | PBR, Shaded, All, None | Material output type. |
| quality_and_mesh | string | No | 500K Triangle | 4K Quad, 8K Quad, 18K Quad, 50K Quad, 2K Triangle, 20K Triangle, 150K Triangle, 500K Triangle | Combined quality and mesh type selection. |
| texture_mode | string | No | - | legacy, extreme-low, low, medium, high | Texture generation quality. Leave empty to let the provider choose. |
| geometry_instruct_mode | string | No | faithful | faithful, creative | Faithful follows the input closely; creative allows more variation. |
| hd_texture | boolean | No | false | - | Enable enhanced texture post-processing. |
| texture_delight | boolean | No | false | - | Remove baked lighting and highlights from generated textures. |
| is_symmetric | string | No | unknown | symmetric, balanced, asymmetric, unknown | Symmetry mode for the generated mesh. |
| is_micro | boolean | No | false | - | Generate finer micro-scale geometric detail. Only effective with Extreme-High tier. |
| ta_pose | boolean | No | false | - | Generate characters in T-pose or A-pose format. |
| addons | string | No | - | HighPack | Optional HighPack add-on for 4K textures and higher-poly geometry. |
| preview_render | boolean | No | false | - | Generate a preview render image of the 3D model. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |