Rodin Generation
Last updated
Was this helpful?
Last updated
Was this helpful?
Use this API to submit an asynchronous task to our server. You will get a task UUID from the API which can be used to of the the task and when the task is ready.
Base Cost: 0.5 credit per generation for either Sketch
and Regular
tier.
Addons:
HighPack
: Additional 1 credit per generation.
images
file/Binary
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: null
prompt
string
A textual prompt to guide the model generation. For Image-to-3D generation: optional (if not provided, an AI-generated prompt based on the provided images will be used) For Text-to-3D generation: required
condition_mode
string
Useful only for multi-images 3D generation.
This is an optional parameter that chooses the mode of the multi-image geneartion. Possible values are fuse
and concat
. Default is concat
.
For fuse
mode, if you are uploading images of multiple objects, fuse mode will extract and fuse all the features of all the objects from the images for generation. One or more images are required.
For concat
mode, if you are uploading images of a single object, concat mode will inform the Rodin model to expect these images to be multi-view images of a single object. One or more images are required (you can upload multi-view images in any order, regardless of the order of view.)
seed
number
Optional. A seed value for randomization in the mesh generation, ranging from 0 to 65535 (both inclusive). If not provided, the seed will be randomly generated.
geometry_file_format
string
Optional. The format of the output geometry file. Possible values are glb
, usdz
, fbx
, obj
, and stl
. Default is glb
.
For Rodin Sketch, the value will fixed to glb
.
material
string
Optional. The material type. Possible values are PBR
and Shaded
. Default is PBR
.
For Rodin Sketch, the value will fixed to PBR
.
quality
string
Optional. The generation quality. Possible values are high
(50k faces), medium
(18k faces), low
(8k faces), and extra-low
(4k faces). Default is medium
.
For Rodin Sketch, the value will fixed to medium
.
use_hyper
boolean
Optional. Default is false
.
In generating objects with finer structure details, the quality of the 3D representation would be better if the user_hyper
parameter is set to true
.
For Rodin Sketch, the value is always false
.
tier
string
Optional. Tier of generation. The default value is Regular
.
For Rodin Sketch, the value should be set to Sketch
.
For Rodin Regular, the value should be set to Regular
.
TAPose
bool
Optional. When generating the human-like model, this parameter control the generation result to T/A Pose.
When true
, your model will be either T pose or A pose.
bbox_condition
Array of Integer
Optional. This is a controlnet that controls the maxmimum sized of the generated model. This array must contain 3 elements, Width(Y-axis), Height(Z-axis), and Length(X-axis), in this exact fixed sequence (y, z, x).
mesh_mode
string
Optional. It controls the type of faces of generated models, Possible values are Raw
and Quad
. Default is Quad
.
The Raw
mode generates triangular face models.
The Quad
mode generates quadrilateral face models.
When its value is Raw
, quality
will be fixed to medium, and addons
will be fixed to [].
mesh_simplify
bool
Optional. Default is true
.
If true
, The generated models will be simplified.
This parameter takes effect when the mesh_mode is set to Raw
.
mesh_smooth
bool
Optional. Default is true
.
If true
, The generated models will be smoothed. Similar to Rodin Gen-1.
This parameter takes effect when the mesh_mode is set to Quad
.
addons
array of strings
Optional. The default is []
. Possible values is HighPack
.
By selecting HighPack
, it will generate 4K resolution texture instead of the default 2K, and the number of faces will be ~16 times of the number of faces selected in the quality
parameter.
error
string
Error message, if any.
message
string
Success message or detailed error information.
uuid
string
Unique identifier for the generated task.
jobs
object
A job object, containing details of individual jobs executed as part of the generation process.
jobs.uuids
array of strings
UUIDs of the sub-jobs.
jobs.subscription_key
string
Subscription key associated with these jobs.
This API uses bearer key for authentication. You need to include a valid token in the Authorization
header for all requests. Refer to the for how to generate an API key for your account.
Use the uuid
field instead of the jobs.uuids
field for your requests to and API endpoints.
This API will generate a mesh and textures for the given images and prompt. This API provide two tiers of generation, Sketch and Regular. Sketch is optimized for generation speed, and is recommended for fast prototyping. Regular is optimized for quality, and is recommended for production.
concat
Possible values: glb
Possible values: PBR
Possible values: medium
Possible values: false
false
[]
Quad
Possible values: true
true