seedinteger
Seed (0–65535).
Minimum: 0
Maximum: 65535
Rodin 2.5 Text to 3D
hyper3d/rodin/2.5/text-to-3dRodin Gen-2.5 by Hyper3D (Deemos) generates game- and production-ready 3D assets from a text prompt.
Try the model
Playground
Input
A textual prompt to guide model generation. Required for Text-to-3D mode.
Additional Settings More
Customize your input with more control.
065535
Seed (0–65535). Range: 0 to 65535.
Combined 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 Extreme-Low, Low, and Medium. Up to 2M Triangle (as low as 20K Triangle) is supported for tiers High and Extreme-High. Auto option will choose the advised options for each tier:
1. Gen-2.5-Minimum: 50K Triangle
2. Gen-2.5-Extreme-Low: 50K Triangle
3. Gen-2.5-Low: 50K Triangle
4. Gen-2.5-Medium: 500K Triangle
5. Gen-2.5-High: 500K Triangle
Gen-2.5-Extreme-High: 1M Triangle. Allowed values: Auto, 4K Quad, 8K Quad, 18K Quad, 50K Quad, 100K Quad, 200K Quad, 2K Triangle, 20K Triangle, 50K Triangle, 150K Triangle, 500K Triangle, 1M Triangle, 2M Triangle.
PBR, Shaded, All (both) or None. Allowed values: PBR, Shaded, All, None.
Enhanced texture post-processing.
Output file format. Allowed values: glb, usdz, fbx, obj, stl.
Generate characters in T-pose or A-pose for rigging.
Optional add-on. HighPack (4K textures, high-poly) is billed +$0.80. Allowed values: HighPack.
Generation tier (quality / speed). Allowed values: Gen-2.5-Minimum, Gen-2.5-Extreme-Low, Gen-2.5-Low, Gen-2.5-Medium, Gen-2.5-High, Gen-2.5-Extreme-High.
ResultIdle
Your output will appear here
Complete the inputs, then click Run.
Rodin 2.5 Text to 3D
Rodin Gen-2.5 by Hyper3D turns a text prompt into a production-ready 3D asset with PBR materials and quad or triangle meshes.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 1,024 characters. |
seed | integer 0–65535 | random | Fix it to compare prompt changes. |
quality_mesh_option | Auto / 4K Quad / 8K Quad / 18K Quad / 50K Quad / 100K Quad / 200K Quad / 2K Triangle / 20K Triangle / 50K Triangle / 150K Triangle / 500K Triangle / 1M Triangle / 2M Triangle | Auto | Mesh density and topology. |
material | PBR / Shaded / All / None | All | Material output. |
hd_texture | boolean | false | Higher-resolution textures. |
geometry_file_format | glb / usdz / fbx / obj / stl | glb | Output file format. |
TAPose | boolean | false | Force a T/A-pose for characters. |
addons | HighPack | — | HighPack adds high-resolution textures and denser meshes. |
tier | Gen-2.5-Minimum / Gen-2.5-Extreme-Low / Gen-2.5-Low / Gen-2.5-Medium / Gen-2.5-High / Gen-2.5-Extreme-High | Gen-2.5-High | Quality tier. |
Billing
$0.48 per model ($0.96 on the Extreme-High tier), plus $0.96 for the HighPack add-on.
| Request | Price |
|---|---|
| Default tier | $0.48 |
| Extreme-High tier | $0.96 |
| Default + HighPack | $1.44 |
Failed runs are not charged.
Prompting
- Describe one object: shape, materials, and style.
Also on SandBase
Other Rodin endpoints: hyper3d/rodin/2.5/image-to-3d, hyper3d/rodin/2.5/fast/text-to-3d, hyper3d/rodin/2.5/fast/image-to-3d.
Start building
Send your first request
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/text-to-3d",
"tier": "Gen-2.5-High",
"TAPose": false,
"prompt": "A futuristic robot with sleek metallic design.",
"material": "All",
"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"2. Authentication
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.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
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"4. Files
Hosted files
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.
Uploading images
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.
5. Schema
Input
tierstring
Generation tier (quality / speed).
Default: "Gen-2.5-High"
Possible values: "Gen-2.5-Minimum", "Gen-2.5-Extreme-Low", "Gen-2.5-Low", "Gen-2.5-Medium", "Gen-2.5-High", "Gen-2.5-Extreme-High"
TAPoseboolean
Generate characters in T-pose or A-pose for rigging.
Default: false
addonsstring
Optional add-on. HighPack (4K textures, high-poly) is billed +$0.80.
Possible values: "HighPack"
promptstringrequired
A textual prompt to guide model generation. Required for Text-to-3D mode.
materialstring
PBR, Shaded, All (both) or None.
Default: "All"
Possible values: "PBR", "Shaded", "All", "None"
hd_textureboolean
Enhanced texture post-processing.
Default: false
quality_mesh_optionstring
Combined 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 Extreme-Low, Low, and Medium. Up to 2M Triangle (as low as 20K Triangle) is supported for tiers High and Extreme-High. Auto option will choose the advised options for each tier: 1. Gen-2.5-Minimum: 50K Triangle 2. Gen-2.5-Extreme-Low: 50K Triangle 3. Gen-2.5-Low: 50K Triangle 4. Gen-2.5-Medium: 500K Triangle 5. Gen-2.5-High: 500K Triangle Gen-2.5-Extreme-High: 1M Triangle.
Default: "Auto"
Possible values: "Auto", "4K Quad", "8K Quad", "18K Quad", "50K Quad", "100K Quad", "200K Quad", "2K Triangle", "20K Triangle", "50K Triangle", "150K Triangle", "500K Triangle", "1M Triangle", "2M Triangle"
geometry_file_formatstring
Output file format.
Default: "glb"
Possible values: "glb", "usdz", "fbx", "obj", "stl"
{
"model": "hyper3d/rodin/2.5/text-to-3d",
"tier": "Gen-2.5-High",
"TAPose": false,
"prompt": "A futuristic robot with sleek metallic design.",
"material": "All",
"hd_texture": false,
"quality_mesh_option": "Auto",
"geometry_file_format": "glb"
}Output
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.