Hyper3D Rodin v2.5 Image to 3D API

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

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–5 images 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-High when you need the highest-quality generation.
Choose mesh and format settings — set quality_and_mesh, geometry_file_format, and material based 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 = HighPack if 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-High costs 2× 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.

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.

Rodin v2.5 Image To 3d API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/hyper3d/rodin-v2.5/image-to-3d with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Rodin v2.5 Image To 3d below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/hyper3d/rodin-v2.5/image-to-3d" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "tier": "Gen-2.5-Medium",
    "use_original_alpha": false,
    "geometry_file_format": "glb",
    "material": "All",
    "quality_and_mesh": "500K Triangle",
    "texture_mode": "legacy",
    "geometry_instruct_mode": "faithful",
    "hd_texture": false,
    "texture_delight": false,
    "is_symmetric": "unknown",
    "is_micro": false,
    "ta_pose": false,
    "addons": "HighPack",
    "preview_render": false
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("hyper3d/rodin-v2.5/image-to-3d", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "tier": "Gen-2.5-Medium",
        "use_original_alpha": false,
        "geometry_file_format": "glb",
        "material": "All",
        "quality_and_mesh": "500K Triangle",
        "texture_mode": "legacy",
        "geometry_instruct_mode": "faithful",
        "hd_texture": false,
        "texture_delight": false,
        "is_symmetric": "unknown",
        "is_micro": false,
        "ta_pose": false,
        "addons": "HighPack",
        "preview_render": false
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "hyper3d/rodin-v2.5/image-to-3d",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "tier": "Gen-2.5-Medium",
    "use_original_alpha": false,
    "geometry_file_format": "glb",
    "material": "All",
    "quality_and_mesh": "500K Triangle",
    "texture_mode": "legacy",
    "geometry_instruct_mode": "faithful",
    "hd_texture": false,
    "texture_delight": false,
    "is_symmetric": "unknown",
    "is_micro": false,
    "ta_pose": false,
    "addons": "HighPack",
    "preview_render": false
}
)

print(output["outputs"][0])  # → URL of the generated output

Rodin v2.5 Image To 3d API — Frequently asked questions

What is the Rodin v2.5 Image To 3d API?

Rodin v2.5 Image To 3d is a Hyper3d model for 3D asset generation from images, exposed as a REST API 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. You can call it programmatically or try it from the playground above.

How do I call the Rodin v2.5 Image To 3d API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/hyper3d/hyper3d-rodin-v2.5-image-to-3d.

How much does Rodin v2.5 Image To 3d cost per run?

Rodin v2.5 Image To 3d starts at $0.40 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Rodin v2.5 Image To 3d accept?

Key inputs: `prompt`, `images`, `addons`, `geometry_file_format`, `geometry_instruct_mode`, `hd_texture`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/hyper3d/hyper3d-rodin-v2.5-image-to-3d.

How do I get started with the Rodin v2.5 Image To 3d API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Rodin v2.5 Image To 3d outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Hyper3d). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

示例查看全部

相关模型

README