seedinteger
Seed (0–65535).
Minimum: 0
Maximum: 65535
hyper3d/rodin/2.5/fast/image-to-3dRodin Gen-2.5 by Hyper3D (Deemos) generates game- and production-ready 3D assets from one to five reference images, tuned for speed with the low tiers.
Try the model
PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 5
Customize your input with more control.
Your output will appear here
Complete the inputs, then click Run.
Rodin Gen-2.5 Fast by Hyper3D turns an image set of 1–5 views into a game-ready 3D asset, using the low tiers for speed.
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string | — | Up to 1,024 characters. |
images | image URL[] (≤5), required | — | 1–5 reference images of the object. |
material | PBR / Shaded / All / None | Shaded | Material output. |
TAPose | boolean | false | Force a T/A-pose for characters. |
hd_texture | boolean | false | Higher-resolution textures. |
tier | Gen-2.5-Minimum / Gen-2.5-Extreme-Low / Gen-2.5-Low | Gen-2.5-Extreme-Low | Quality tier. |
geometry_file_format | glb / usdz / fbx / obj / stl | glb | Output file format. |
quality_mesh_option | Auto / 1K Quad / 4K Quad / 8K Quad / 18K Quad / 20K Quad / 2K Triangle / 4K Triangle / 8K Triangle / 10K Triangle / 20K Triangle | Auto | Mesh density and topology. |
seed | integer 0–65535 | random | Fix it to compare prompt changes. |
$0.10 per model.
| Request | Price |
|---|---|
| One model | $0.10 |
Failed runs are not charged.
Other Rodin endpoints: hyper3d/rodin/2.5/text-to-3d, hyper3d/rodin/2.5/image-to-3d, hyper3d/rodin/2.5/fast/text-to-3d.
Start building
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "hyper3d/rodin/2.5/fast/image-to-3d",
"tier": "Gen-2.5-Extreme-Low",
"TAPose": false,
"images": [
"https://static.sandbase.ai/examples/hyper3d/rodin/2.5/fast/image-to-3d/input_images_0.png",
"https://static.sandbase.ai/examples/hyper3d/rodin/2.5/fast/image-to-3d/input_images_1.png",
"https://static.sandbase.ai/examples/hyper3d/rodin/2.5/fast/image-to-3d/input_images_2.png"
],
"prompt": "A futuristic robot with sleek metallic design.",
"material": "Shaded",
"hd_texture": false,
"quality_mesh_option": "Auto",
"geometry_file_format": "glb"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
seedintegerSeed (0–65535).
Minimum: 0
Maximum: 65535
tierstringGeneration tier (quality / speed).
Default: "Gen-2.5-Extreme-Low"
Possible values: "Gen-2.5-Minimum", "Gen-2.5-Extreme-Low", "Gen-2.5-Low"
TAPosebooleanGenerate characters in T-pose or A-pose for rigging.
Default: false
imagesarrayrequired1 to 5 images of the object.
promptstringOptional text prompt to guide generation.
materialstringPBR, Shaded, All (both) or None.
Default: "Shaded"
Possible values: "PBR", "Shaded", "All", "None"
hd_texturebooleanEnhanced texture post-processing.
Default: false
quality_mesh_optionstringCombined 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: "Auto"
Possible values: "Auto", "1K Quad", "4K Quad", "8K Quad", "18K Quad", "20K Quad", "2K Triangle", "4K Triangle", "8K Triangle", "10K Triangle", "20K Triangle"
geometry_file_formatstringOutput file format.
Default: "glb"
Possible values: "glb", "usdz", "fbx", "obj", "stl"
{
"model": "hyper3d/rodin/2.5/fast/image-to-3d",
"tier": "Gen-2.5-Extreme-Low",
"TAPose": false,
"images": [
"https://static.sandbase.ai/examples/hyper3d/rodin/2.5/fast/image-to-3d/input_images_0.png",
"https://static.sandbase.ai/examples/hyper3d/rodin/2.5/fast/image-to-3d/input_images_1.png",
"https://static.sandbase.ai/examples/hyper3d/rodin/2.5/fast/image-to-3d/input_images_2.png"
],
"prompt": "A futuristic robot with sleek metallic design.",
"material": "Shaded",
"hd_texture": false,
"quality_mesh_option": "Auto",
"geometry_file_format": "glb"
}A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
No example output has been published yet. Use Playground → Result → JSON after a completed run to inspect your response.