Browse ModelsHyper3dHyper3d Rodin V2.5 Image To 3d

Hyper3d Rodin V2.5 Image To 3d

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
    Use geometry_instruct_mode, symmetry options, and micro-detail settings to shape how the asset is built.

  • Multiple export formats
    Export as glb, usdz, fbx, obj, or stl.

  • Production-ready workflow
    Useful for concept art, product prototyping, game asset generation, and 3D content pipelines.


Parameters

ParameterRequiredDescription
imagesYesReference images for generating the 3D model. Upload 1–5 images.
promptNoOptional text prompt. If empty, the model auto-generates a prompt from the images.
tierNoGeneration 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_alphaNoPreserve the transparency channel from input images. Default: false.
geometry_file_formatNoOutput geometry file format. Supported values: glb, usdz, fbx, obj, stl. Default: glb.
materialNoMaterial output type. Supported values: PBR, Shaded, All, None. Default: All.
quality_and_meshNoCombined 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_modeNoTexture generation quality. Supported values: legacy, extreme-low, low, medium, high. Leave empty to let the provider choose.
geometry_instruct_modeNoGeometry instruction mode. Supported values: faithful, creative. Default: faithful.
hd_textureNoEnable enhanced texture post-processing. Default: false.
texture_delightNoRemove baked lighting and highlights from generated textures. Default: false.
is_symmetricNoSymmetry mode for the generated mesh. Supported values: symmetric, balanced, asymmetric, unknown. Default: unknown.
is_microNoGenerate finer micro-scale geometric detail. Only effective with Gen-2.5-Extreme-High. Default: false.
ta_poseNoGenerate characters in T-pose or A-pose format. Default: false.
addonsNoOptional add-on. Supported value: HighPack. Enables 4K textures and higher-poly geometry.
preview_renderNoGenerate a preview render image of the 3D model. Default: false.

How to Use

  1. Upload your reference images — provide 1–5 images of the object, character, or asset you want to generate.
  2. Add a prompt (optional) — describe the asset if you want to guide shape, style, or design intent more explicitly.
  3. Choose a tier — use the default tier for general work, or select Gen-2.5-Extreme-High when you need the highest-quality generation.
  4. Choose mesh and format settings — set quality_and_mesh, geometry_file_format, and material based on your downstream use.
  5. Adjust geometry and texture controls (optional) — fine-tune texture_mode, geometry_instruct_mode, is_symmetric, hd_texture, and related settings.
  6. Add HighPack (optional) — enable addons = HighPack if you need higher-end texture and geometry output.
  7. 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.

ConfigurationCost
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-High costs the base price
  • HighPack adds an additional $0.80 per generation
  • HighPack and Gen-2.5-Extreme-High stack 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 faithful geometry mode when image fidelity matters more than creative interpretation.
  • Use creative when you want the model to take more design liberties.
  • Choose quad output when downstream retopology or sculpting workflows matter.
  • Use texture_delight if you want cleaner textures with less baked lighting.
  • Only enable is_micro when using Gen-2.5-Extreme-High, since it has no effect otherwise.
  • Add HighPack only when you need the extra texture and geometry quality, since it increases cost significantly.

Notes

  • images is required.
  • You can upload up to 5 reference images.
  • prompt is optional; if omitted, the model can infer guidance from the images.
  • Gen-2.5-Extreme-High doubles the base generation cost.
  • HighPack adds an extra fixed charge on top of the selected tier.
  • is_micro is only effective with Gen-2.5-Extreme-High.
  • geometry_file_format defaults to glb.
  • material defaults to All.
  • quality_and_mesh defaults to 500K Triangle.

  • 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

ParameterTypeRequiredDefaultRangeDescription
imagesarrayYes[]1 ~ 5 itemsReference images for generating the 3D model. Up to 5 images are allowed.
promptstringNo-Optional text prompt. If empty, the model auto-generates a prompt from the images.
tierstringNoGen-2.5-MediumGen-2.5-Extreme-Low, Gen-2.5-Low, Gen-2.5-Medium, Gen-2.5-High, Gen-2.5-Extreme-HighGeneration tier. Extreme-High bills at double the base rate.
use_original_alphabooleanNofalse-Preserve the transparency channel from input images.
geometry_file_formatstringNoglbglb, usdz, fbx, obj, stlOutput geometry file format.
materialstringNoAllPBR, Shaded, All, NoneMaterial output type.
quality_and_meshstringNo500K Triangle4K Quad, 8K Quad, 18K Quad, 50K Quad, 2K Triangle, 20K Triangle, 150K Triangle, 500K TriangleCombined quality and mesh type selection.
texture_modestringNo-legacy, extreme-low, low, medium, highTexture generation quality. Leave empty to let the provider choose.
geometry_instruct_modestringNofaithfulfaithful, creativeFaithful follows the input closely; creative allows more variation.
hd_texturebooleanNofalse-Enable enhanced texture post-processing.
texture_delightbooleanNofalse-Remove baked lighting and highlights from generated textures.
is_symmetricstringNounknownsymmetric, balanced, asymmetric, unknownSymmetry mode for the generated mesh.
is_microbooleanNofalse-Generate finer micro-scale geometric detail. Only effective with Extreme-High tier.
ta_posebooleanNofalse-Generate characters in T-pose or A-pose format.
addonsstringNo-HighPackOptional HighPack add-on for 4K textures and higher-poly geometry.
preview_renderbooleanNofalse-Generate a preview render image of the 3D model.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.