格式转换

本页列出 conversion 支持的全部参数。该任务与模型版本无关，适用于各模型版本。

接口地址

参数

必填参数

type: 该字段必须设置为 convert_model。

format: 将 OpenAPI 中 glb 格式模型转换为其他格式。仅支持以下值：

• GLTF：转换为 GLTF 格式。
• USDZ：转换为 USDZ 格式。
• FBX：转换为 FBX 格式。
• OBJ：转换为 OBJ 格式。不支持带骨骼绑定的模型。
• STL：转换为 STL 格式。不支持带骨骼绑定的模型。
• 3MF：转换为 3MF 格式。不支持带骨骼绑定的模型，仅导出几何体。

注意

• GLTF 和 STL 不支持存储四边形面——启用 quad 时仍会执行重拓扑并应用面数限制，但结果会将所有面存储为三角形。
• 选择 STL 格式时，最终模型不会保留贴图。
• 若需对已转换过的模型再次进行格式转换，仅支持 format 参数。

original_model_task_id: 上一个模型任务的 task_id。上游任务的 model_version 需为 Turbo-v1.0-20250506 或 v2.0-20240919 及以上。仅支持使用具有 model 输出 的任务 ID。

注意

text_to_model、image_to_model 和 multiview_to_model 的 1.x 版本任务不支持作为上游任务。

可选参数

quad: 设为 true 时，对转换后的模型启用四边面重建（或自动重拓扑）。

force_symmetry: bool 值，仅在启用 quad 时生效。用于在四边面重建时强制对称。

face_limit: integer 值，用于限制输出模型的面数。默认值为 10000。

flatten_bottom: 设为 true 时，会将转换后模型的底部压平。默认值为 false。

flatten_bottom_threshold: float 值，仅在 flatten_bottom 启用 时生效。用于设置底部压平深度。默认值为 0.01。

texture_size: integer 值，用于设置漫反射贴图尺寸（像素）。默认值为 2048（model_version>=v2.0-20240919 时为 4096），且应小于默认值。

texture_format: text 值，用于设置漫反射贴图格式（支持 BMP、DPX、HDR、JPEG、OPEN_EXR、PNG、TARGA、TIFF、WEBP）。默认值为 JPEG（FBX 的默认值为 PNG，以更好支持 Unity）。

pivot_to_center_bottom: bool 值，用于将枢轴点设置为底部中心。默认值为 false。

scale_factor: number 值，用于设置对象缩放比例。默认值为 1。

with_animation: 设为 true 时，导出模型将包含骨骼绑定信息与动画结构。默认值为 true。

pack_uv: 设为 true 时，将不同部件的 UV 岛打包到统一布局中，并导出单张贴图。默认值为 false。

bake: 设为 true 时，烘焙模型贴图，将高级材质效果合并进基础贴图。默认值为 true。

part_names: list 值，部件名称来自 网格分割。

animate_in_place: bool 值，用于控制模型是否原地播放动画。默认值为 false。

export_vertex_colors: bool 值，控制导出时是否包含顶点色。仅在 format 为 OBJ 或 GLTF 时可用。默认值为 false。

export_orientation: text 值，用于设置模型朝向。默认值为 +x（支持 -x、-y、+y）。

fbx_preset（实验性）: text 值，用于指定 fbx 导出的目标平台兼容预设。默认值为 blender（支持 3dsmax、mixamo）。

返回值

task_id: 成功提交任务后的唯一标识。