Start building
SandBase

Appearance

Hyper3d

POST/v1/run

Rodin V2 by hyper3d - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.

Request body

Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.

stringmodelrequired

Model identifier. Set to hyper3d/rodin/v2.

Default: hyper3d/rodin/v2

stringpromptrequired

A textual prompt to guide model generation. Optional for Image-to-3D mode - if empty, AI will generate a prompt based on your images.

Default:

Optional<integer>seed

Seed value for randomization, ranging from 0 to 65535. Optional.

Range: 0 to 65535

Optional<string>quality_mesh_option

Combined quality and mesh type selection. Quad = smooth surfaces, Triangle = detailed geometry. These corresponds to `mesh_mode` (if the option contains 'Triangle', mesh_mode is 'Raw', otherwise 'Quad') and `quality_override` (the numeric part of the option) parameters in Hyper3D API.

Allowed values: 4K Quad, 8K Quad, 18K Quad, 50K Quad, 2K Triangle, 20K Triangle, 150K Triangle, 500K Triangle

Default: 500K Triangle

Optional<array<string>>input_image_urls

URL of images to use while generating the 3D model. Required for Image-to-3D mode. Up to 5 images allowed.

Optional<boolean>TAPose

Generate characters in T-pose or A-pose format, making them easier to rig and animate in 3D software.

Default: false

Optional<string>addons

The HighPack option will provide 4K resolution textures instead of the default 1K, as well as models with high-poly. It will cost **triple the billable units**.

Optional<boolean>preview_render

Generate a preview render image of the 3D model along with the model files.

Default: false

Optional<string>geometry_file_format

Format of the geometry file. Possible values: glb, usdz, fbx, obj, stl. Default is glb.

Allowed values: glb, usdz, fbx, obj, stl

Default: glb

Optional<string>material

Material type. PBR: Physically-based materials with realistic lighting. Shaded: Simple materials with baked lighting. All: Both types included.

Allowed values: PBR, Shaded, All

Default: All

Optional<boolean>use_original_alpha

When enabled, preserves the transparency channel from input images during 3D generation.

Default: false

Optional<array<integer>>bbox_condition

An array that specifies the bounding box dimensions [width, height, length].

Response Schema

The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.

stringidrequired

Opaque SandBase run identifier. Use it exactly as returned; no prefix is guaranteed.

stringstatusrequired

Current public run status.

Allowed values: pending, running, completed, failed, timeout

Optional<string>model

Public SandBase model name used for this run.

Optional<array<object>>outputs

Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.

Optional<object>error

Present only for failed or timeout runs. Contains a public error type and sanitized message.

Optional<string>error.type

Stable public error category.

Optional<string>error.message

Sanitized error message safe to show to clients.

Optional<object>usage

Usage details when available.

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: image-to-3d

stringexecution_moderequired

Execution mode declared by the model registry.

Default: async