格式转换
本页列出 conversion 支持的全部参数。该任务与模型版本无关，适用于各模型版本。
绑骨数据
网格编辑和 remesh 会重建模型几何体，不会保留骨骼（绑骨）数据，包括骨骼、蒙皮权重和动画绑定。输入模型即使已经绑骨或做过重定向也一样。
| 任务 | type | 说明 |
|---|---|---|
| 网格分割 | mesh_segmentation | 将模型拆成可编辑部件 |
| 网格补全 | mesh_completion | 应用分割结果并补全所选部件 |
| 智能低模 | highpoly_to_lowpoly | 将模型 remesh 到更低面数，包括 quad=true 的四边面输出 |
| 格式转换（remesh） | convert_model | 通过 quad=true 做 remesh；无论 with_animation 如何设置，都不保留骨骼数据 |
请先完成全部网格编辑和 remesh，再运行 animate_prerigcheck → animate_rig → animate_retarget。如果必须用上述任务处理已绑骨模型，请在得到的静态网格上重新跑完整动画流程。
接口地址
参数
必填参数
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: 成功提交任务后的唯一标识。