Tripo3D

重拓扑

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /mesh/decimate
通过两种算法减少模型面数。使用 model=v2.0（默认）进行智能低模重拓扑，保留干净拓扑结构；使用 model=v1.0 进行基础减面。
注意
  • 此接口需要 API Key 认证。请在 Authorization 请求头中传入 Bearer {api_key}。
  • 此接口为异步 API。提交请求后，请使用 任务查询接口 轮询获取结果，或配置 Webhook 接收任务完成时的自动通知。

请求参数

请求体

inputstring必选
模型来源。接受 task_id 或 file_token。 接受以下输入类型：
以下三种方式任选其一，不可同时传入多种类型。
  • task_id：此前 3D 生成任务（text_to_model、image_to_model 或 multiview_to_model）返回的任务 ID。系统会自动使用该任务的 3D 模型输出。
    示例： task_abc123
  • file_token：先通过文件上传 API上传 3D 模型文件，然后传入返回的 token。
    示例： file_abc123
  • URL：可公开访问的 3D 模型文件直链。
    示例： https://example.com/model.glb
说明
  • 支持格式：GLB、GLTF、FBX、OBJ、STL
  • 最大文件大小：150 MB
modelstring默认值: v2.0
重拓扑算法版本。
智能重拓扑：P 系列 AI 模型，重建干净拓扑，保边保细节。
  • face_limit：可选。三角面：500–20,000；四边面：500–10,000。省略则自适应。
  • quad：支持
  • bake：支持（默认 true）
  • part_names：支持
  • format：不支持（输出 GLB）
face_limitinteger条件必选
目标面数。
可选。三角面：500–20,000。四边面：500–10,000。省略则自适应减面。
quadboolean默认值: false
输出四边面网格。v1.0 和 v2.0 均支持。
bakeboolean默认值: true
v1.0 不支持该参数。
将贴图烘焙到低面数模型上。
part_namesstring[]
v1.0 不支持该参数。
要减面的部件名称（来自语义分割）。

示例

v2.0 智能重拓扑
{
  "input": "task_abc123",
  "model": "v2.0",
  "face_limit": 5000,
  "quad": false,
  "bake": true
}
v1.0 基础减面
{
  "input": "task_abc123",
  "model": "v1.0",
  "face_limit": 3000
}
创建任务
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}
任务结果
{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "text_to_model",
    "status": "success",
    "progress": 100,
    "output": {
      "model_url": "https://cdn.tripo3d.ai/output/model_pbr.glb",
      "rendered_image_url": "https://cdn.tripo3d.ai/output/preview.png"},
    "credits_consumed": 100,
    "created_at": "2026-04-28T12:00:00Z",
    "completed_at": "2026-04-28T12:01:30Z"}
}