Conversion

All supported parameters for conversion. This task is version-independent and available across all model versions.

Endpoint

Parameters

Required parameters

type: This field must be set to convert_model.

format: Converts glb format models from the OpenAPI into other formats. It can only be one of the following values.

• GLTF: Transforms into GLTF format.
• USDZ: Transforms into USDZ format.
• FBX: Transforms into FBX format.
• OBJ: Transforms into OBJ format. Not supported with rigged models.
• STL: Transforms into STL format. Not supported with rigged models.
• 3MF: Transforms into 3MF format. Not supported with rigged models and only exports geometry.

Notes

• GLTF and STL don't support storing quad faces — enabling quad will still perform retopology and apply face limit, but the result will store all faces as triangles.
• Textures will not be retained in the final model when choosing STL.
• If you need to perform a format conversion after an initial one, only the format parameter will be supported.

original_model_task_id: The task_id of previous model, the model_version of previous task should be in (Turbo-v1.0-20250506 or over v2.0-20240919). Only the task IDs of the tasks which has model output can be used.

Note

1.x versions of text_to_model, image_to_model and multiview_to_model tasks are not supported.

Optional parameters

quad: When set to true, enables quad remeshing (or auto retopology) for the converted model.

force_symmetry: A bool value which is effective only when quad is enabled. Force symmetry for quad remeshing.

face_limit: An integer value which limits the number of faces on the output model. The default value is 10000.

flatten_bottom: When set to true, enables flatten the bottom of converted model. The default value is false.

flatten_bottom_threshold: A float value which is effective only when flatten_bottom is enabled. Set the bottom flatten depth. The default value is 0.01.

texture_size: An integer value to set the diffuse color texture size (in pixel). The default value is 2048(4096 for model_version>=v2.0-20240919), and should be smaller than the default value.

texture_format: A text value to set the diffuse color texture format (supports BMP, DPX, HDR, JPEG, OPEN_EXR, PNG, TARGA, TIFF, WEBP). The default value is JPEG(The Default value for FBX is PNG to better support unity).

pivot_to_center_bottom: A bool value to set the pivot point to center bottom. The default value is false.

scale_factor: A number value to set the object scale. The default value is 1.

with_animation: When set to true, the exported model will include skeletal binding information and animation structure. The default value is true.

pack_uv: When set to true, combine all UV islands from different parts into one unified layout and export a single texture map. The default value is false.

bake: When set to true, bakes the model's textures, combining advanced material effects into the base textures. The default value is true.

part_names: A list value of part names referred from mesh segmentation.

animate_in_place: A bool value to determine if the model will be animated in fixed place. The default value is false.

export_vertex_colors: A bool value that controls whether to include vertex colors when exporting. Only can be used when OBJ or GLTF is selected in format. The default value is false.

export_orientation: A text to set the model facing direction. The default value is +x (supports -x, -y, +y).

fbx_preset (experimental): A text to specify the target platform for fbx export compatibility. The default value is blender (supports 3dsmax, mixamo).

Returns

task_id: The identifier for the successfully submitted task.