Rodin Gen-1/1.5

Item	Charge
Base Gen-1/1.5 generation	`0.5 credits`
`addons` includes `HighPack`	`+1.0 credits`

images*array<string>

Images to be used in generation, up to 5 images. As the form data request will preserve the order of the images, the first image will be the image for material generation.

For Image-to-3D generation: required (one or more images are needed, maximum 5 images)

For Text-to-3D generation: omit this field.

Images to be used in generation, up to 5 images. As the form data request will preserve the order of the images, the first image will be the image for material generation. For Image-to-3D generation: required (one or more images are needed, maximum 5 images) For Text-to-3D generation: omit this field.

prompt?string

A textual prompt to guide the model generation.

For Image-to-3D generation: optional, provide orientation-level guidance (symmetric, sharp, detail...) for generation process

For Text-to-3D generation: required. The prompt is first rendered to an image, so a text-only request can also be rejected with IMAGE_CONTENT_VIOLATION.

A textual prompt to guide the model generation. For Image-to-3D generation: optional, provide orientation-level guidance (symmetric, sharp, detail...) for generation process For Text-to-3D generation: required. The prompt is first rendered to an image, so a text-only request can also be rejected with `IMAGE_CONTENT_VIOLATION`.

tier*string

Required. Rodin Gen-1/1.5 generation tier: Sketch, Regular, Detail, or Smooth.

Required. Rodin Gen-1/1.5 generation tier: `Sketch`, `Regular`, `Detail`, or `Smooth`.

mesh_mode?string

Optional. Mesh topology of the generated model. Raw stands for Triangle face, Quad stands for Quad face.

When omitted the default depends on tier: Gen-2.5 tiers default to Raw, every other tier defaults to Quad.

Optional. Mesh topology of the generated model. `Raw` stands for Triangle face, `Quad` stands for Quad face. When omitted the default depends on `tier`: Gen-2.5 tiers default to `Raw`, every other tier defaults to `Quad`.

geometry_file_format?string

Optional. Output geometry file format. Supported formats: glb, usdz, fbx, obj, and stl.

Optional. Output geometry file format. Supported formats: `glb`, `usdz`, `fbx`, `obj`, and `stl`.

material?string

Optional. Material type.

PBR: Physically Based Materials, including base color texture, metallicness texture, normal texture and roughness texture, providing high realism and physically accurate response to dynamic lighting.

Shaded: Only base color texture with baked lighting, providing stylized visuals.

All: Both PBR and Shaded will be delivered.

None: Asset without material. This will speed up generation.

Optional. Material type. - `PBR`: Physically Based Materials, including base color texture, metallicness texture, normal texture and roughness texture, providing high realism and physically accurate response to dynamic lighting. - `Shaded`: Only base color texture with baked lighting, providing stylized visuals. - `All`: Both PBR and Shaded will be delivered. - `None`: Asset without material. This will speed up generation.

quality?string

Optional. Preset target face count for Gen-1/1.5. Defaults to medium. The preset mapping is the same for both mesh modes:

Quad: high 50000, medium 18000, low 8000, extra-low 4000;

Raw: high 50000, medium 18000, low 8000, extra-low 4000.

Optional. Preset target face count for Gen-1/1.5. Defaults to `medium`. The preset mapping is the same for both mesh modes: - `Quad`: `high` 50000, `medium` 18000, `low` 8000, `extra-low` 4000; - `Raw`: `high` 50000, `medium` 18000, `low` 8000, `extra-low` 4000.

quality_override?number

Optional. Custom target face count from 500 to 200000 for Gen-1/1.5. Takes precedence over quality when present.

Optional. Custom target face count from 500 to 200000 for Gen-1/1.5. Takes precedence over `quality` when present.

seed?integer

Optional. A seed value for randomization in the mesh and texture generation.

condition_mode?string

Multi-image generation mode. Optional. This parameter only applies to Gen-1/1.5.

fuse: combines features from all uploaded images; useful when images contain multiple objects;

concat: treats uploaded images as multi-view captures of one object.

Multi-image generation mode. Optional. This parameter only applies to Gen-1/1.5. - `fuse`: combines features from all uploaded images; useful when images contain multiple objects; - `concat`: treats uploaded images as multi-view captures of one object.

bbox_condition?array<>

Optional. Controls the maximum dimensions of the generated model. Provide exactly three integers in Width (X-axis), Height (Y-axis), Length (Z-axis) order (x, y, z). See BBOX Control.

Optional. Controls the maximum dimensions of the generated model. Provide exactly three integers in Width (X-axis), Height (Y-axis), Length (Z-axis) order `(x, y, z)`. See [BBOX Control](/en/api-specification/bbox-control).

addons?array<>

Optional paid add-on. Always upgrades pack textures from 2K to 4K. For Sketch and Regular in Quad mode, an explicitly supplied quality_override of 100000 or less also requests a high-poly model with about 16 times that face count. For Detail and Smooth, HighPack changes texture resolution only.

Optional paid add-on. Always upgrades pack textures from 2K to 4K. For `Sketch` and `Regular` in `Quad` mode, an explicitly supplied `quality_override` of 100000 or less also requests a high-poly model with about 16 times that face count. For `Detail` and `Smooth`, HighPack changes texture resolution only.

TAPose?boolean

Optional. For a human-like subject, enables rest-pose conditioning so the result is generated in a T-pose or A-pose suitable for animation. When false, the input pose is reconstructed as-is.

Optional. For a human-like subject, enables rest-pose conditioning so the result is generated in a T-pose or A-pose suitable for animation. When `false`, the input pose is reconstructed as-is.

use_original_alpha?boolean

Optional. If true, preserves and uses the uploaded image alpha channel during image preprocessing. Has no effect when the input image has no alpha channel.

Optional. If `true`, preserves and uses the uploaded image alpha channel during image preprocessing. Has no effect when the input image has no alpha channel.

preview_render?boolean

Optional. If true, an additional high-quality render image is provided in the download list.

Optional. If `true`, an additional high-quality render image is provided in the download list.

mesh_simplify?boolean

Controls whether generated Raw meshes are simplified. Optional. This parameter only applies to Gen-1/1.5 when mesh_mode is Raw.

Controls whether generated `Raw` meshes are simplified. Optional. This parameter only applies to Gen-1/1.5 when `mesh_mode` is `Raw`.

mesh_smooth?boolean

Controls whether generated Quad meshes are smoothed. Optional. This parameter only applies to Gen-1/1.5 when mesh_mode is Quad.

Controls whether generated `Quad` meshes are smoothed. Optional. This parameter only applies to Gen-1/1.5 when `mesh_mode` is `Quad`.

Rodin Gen-1/1.5

Authorization

Request Body

Response Body

`application/json`

Input

Multi-image behavior

Pricing

Response and lifecycle

Rodin Gen-1/1.5

Authorization

Request Body

Response Body

201application/json

Input

Multi-image behavior

Pricing

Response and lifecycle

`application/json`