Rodin Gen-2.5

Tier	Intended use
`Gen-2.5-Extreme-Low`	Quick generation of simple assets.
`Gen-2.5-Low`	Clean assets and small hard-surface props.
`Gen-2.5-Medium`	Balanced structure and detail.
`Gen-2.5-High`	Richer structure and smoother surfaces.
`Gen-2.5-Extreme-High`	High-frequency detail reproduction.

Tier	Default `texture_mode`
`Gen-2.5-Extreme-Low`	`extreme-low`
`Gen-2.5-Low`	`low`
`Gen-2.5-Medium`	`medium`
`Gen-2.5-High`	`high`
`Gen-2.5-Extreme-High`	`high`

Item	Texture resolution
Base generation	2K
`addons=HighPack`	4K
`texture_mode=extreme-high`	6K
`texture_mode=extreme-high` + `addons=HighPack`	12K

Item	Charge
Base Gen-2.5 generation	`0.5 credits`
`tier=Gen-2.5-Extreme-High`	`+0.5 credits`
`addons` includes `HighPack`	`+1.0 credits`
`texture_mode=extreme-high`	`+2.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. Select and explicitly send a Gen-2.5 tier. If omitted, the endpoint falls back to Regular and generates a Gen-1/1.5 asset.

See Tier for more information.

This parameter may affect billing. See Pricing.

Required. Select and explicitly send a Gen-2.5 tier. If omitted, the endpoint falls back to `Regular` and generates a Gen-1/1.5 asset. See [Tier](/en/api-specification/rodin-gen2-5#tier) for more information. This parameter may affect billing. See [Pricing](/en/api-specification/rodin-gen2-5#pricing).

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`.

texture_mode?string

Optional. Texture mode for the generated model.

Higher modes generally produce richer, higher-resolution texture detail but take longer and may affect billing. See Pricing.

legacy: Use the legacy texture pipeline.

extreme-high: Can produce up to 12K textures. See How to generate 12K Textures.

The default value depends on the selected tier, see Texture mode.

Optional. Texture mode for the generated model. Higher modes generally produce richer, higher-resolution texture detail but take longer and may affect billing. See [Pricing](/en/api-specification/rodin-gen2-5#pricing). - `legacy`: Use the legacy texture pipeline. - `extreme-high`: Can produce up to 12K textures. See [How to generate 12K Textures](/en/api-specification/rodin-gen2-5#how-to-generate-12k-texture). The default value depends on the selected `tier`, see [Texture mode](/en/api-specification/rodin-gen2-5#texture-mode).

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-2.5. Defaults to medium. The mapping depends on mesh_mode:

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

Raw: high 1000000, medium 500000, low 60000, extra-low 20000.

Optional. Preset target face count for Gen-2.5. Defaults to `medium`. The mapping depends on `mesh_mode`: - `Quad`: `high` 50000, `medium` 18000, `low` 8000, `extra-low` 4000; - `Raw`: `high` 1000000, `medium` 500000, `low` 60000, `extra-low` 20000.

quality_override?number

Optional. Custom target face count from 500 to 2000000 for Gen-2.5. Takes precedence over quality when present. Gen-2.5-High and Gen-2.5-Extreme-High support up to 2000000; all other Gen-2.5 tiers support up to 1000000. Quad mode has an additional maximum of 200000.

Optional. Custom target face count from 500 to 2000000 for Gen-2.5. Takes precedence over `quality` when present. `Gen-2.5-High` and `Gen-2.5-Extreme-High` support up to 2000000; all other Gen-2.5 tiers support up to 1000000. `Quad` mode has an additional maximum of 200000.

seed?integer

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

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. Upgrades pack textures from 2K to 4K. For Gen-2.5, HighPack does not change geometry or generate an additional high-poly model. This parameter may affect billing. See Pricing.

Optional paid add-on. Upgrades pack textures from 2K to 4K. For Gen-2.5, HighPack does not change geometry or generate an additional high-poly model. This parameter may affect billing. See [Pricing](/en/api-specification/rodin-gen2-5#pricing).

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.

hd_texture?boolean

Optional. Enables an additional texture super-resolution and enhancement pass. This can improve fine-detail clarity but may also introduce artifacts. It does not select the final 2K or 4K pack resolution; use the HighPack add-on for 4K output.

Optional. Enables an additional texture super-resolution and enhancement pass. This can improve fine-detail clarity but may also introduce artifacts. It does not select the final 2K or 4K pack resolution; use the `HighPack` add-on for 4K output.

is_micro?boolean

Whether to generate micro-scale surface detail. Only allowed when tier is Gen-2.5-Extreme-High; any other tier is rejected with INVALID_REQUEST.

Whether to generate micro-scale surface detail. Only allowed when `tier` is `Gen-2.5-Extreme-High`; any other tier is rejected with `INVALID_REQUEST`.

geometry_instruct_mode?string

Optional. Selects the geometry-generation strategy. creative favors richer or more imaginative structure with less strict input fidelity; faithful stays closer to the provided image and prompt. Availability depends on the selected tier.

Optional. Selects the geometry-generation strategy. `creative` favors richer or more imaginative structure with less strict input fidelity; `faithful` stays closer to the provided image and prompt. Availability depends on the selected `tier`.

texture_delight?boolean

Optional. If true, removes highlights and baked lighting from texture-reference images before texture generation to reduce lighting artifacts in the generated material.

Optional. If `true`, removes highlights and baked lighting from texture-reference images before texture generation to reduce lighting artifacts in the generated material.

Rodin Gen-2.5

Authorization

Request Body

Response Body

`application/json`

Input

Image-to-3D

Text-to-3D

Tier

Creative mode

Texture mode

How to generate 12K Texture

Pricing

Response and lifecycle

Rodin Gen-2.5

201application/json

`application/json`