# tripo-h3.1 3D 模型生成

> 通用

提交异步 3D 模型生成任务，通过 `parameters.type` 选择生成方式：

| `parameters.type` | 生成方式 | 输入 |
|---|---|---|
| `text-to-model` | 文生 3D | `input.prompt` |
| `image-to-model` | 图生 3D | `input.img_url` |
| `multiview-to-model` | 多视图生 3D | `input.views` |

默认输出带 PBR 材质贴图的 GLB 模型；`quad=true` 时输出 FBX。仅开放以上 3 种生成方式，其他取值会返回参数错误。

## 请求地址

`POST https://api.modelverse.cn/v1/tasks/submit`

## 请求体

## 响应

- **200** — 任务提交成功。
- **400** — 请求参数或参数组合无效，不会创建任务，也不会计费。
- **500** — 上游服务返回错误（错误信息中包含上游错误码），不会创建任务，也不会计费。
- **default** — 错误响应。

## OpenAPI 定义

```json
{
  "openapi": "3.1.0",
  "x-language": "zh-CN",
  "info": {
    "title": "tripo-h3.1 3D 模型生成接口文档",
    "version": "1.0.0",
    "description": "这是 ModelVerse 上 `tripo-h3.1` 的 3D 模型生成接口文档，说明如何提交文生 3D、图生 3D、多视图生 3D 任务，以及如何查询任务状态、获取模型文件和计费用量。\n接口路径包括 `POST /v1/tasks/submit`、`GET /v1/tasks/status`。\n"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn",
      "description": "该模型文档中使用的 ModelVerse API 端点。"
    }
  ],
  "tags": [
    {
      "name": "tripo-h3.1",
      "description": "tripo-h3.1 异步 3D 模型生成任务。"
    }
  ],
  "paths": {
    "/v1/tasks/submit": {
      "post": {
        "tags": [
          "tripo-h3.1"
        ],
        "operationId": "submitTripoH31Task",
        "summary": "tripo-h3.1 3D 模型生成",
        "description": "提交异步 3D 模型生成任务，通过 `parameters.type` 选择生成方式：\n\n| `parameters.type` | 生成方式 | 输入 |\n|---|---|---|\n| `text-to-model` | 文生 3D | `input.prompt` |\n| `image-to-model` | 图生 3D | `input.img_url` |\n| `multiview-to-model` | 多视图生 3D | `input.views` |\n\n默认输出带 PBR 材质贴图的 GLB 模型；`quad=true` 时输出 FBX。仅开放以上 3 种生成方式，其他取值会返回参数错误。\n",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TripoH31SubmitRequest"
              },
              "examples": {
                "textToModel": {
                  "summary": "文生 3D（标准贴图）",
                  "value": {
                    "model": "tripo-h3.1",
                    "input": {
                      "prompt": "一个低面数中世纪木质宝箱，带有铁铰链和生锈的锁"
                    },
                    "parameters": {
                      "type": "text-to-model"
                    }
                  }
                },
                "textToModelNoTexture": {
                  "summary": "文生 3D（无贴图白模、超清几何）",
                  "value": {
                    "model": "tripo-h3.1",
                    "input": {
                      "prompt": "一把精致的银色长剑，剑柄有花纹",
                      "negative_prompt": "blurry, low quality, broken mesh"
                    },
                    "parameters": {
                      "type": "text-to-model",
                      "texture": false,
                      "pbr": false,
                      "geometry_quality": "detailed"
                    }
                  }
                },
                "imageToModel": {
                  "summary": "图生 3D（高清贴图）",
                  "value": {
                    "model": "tripo-h3.1",
                    "input": {
                      "img_url": "https://example.com/boy.png"
                    },
                    "parameters": {
                      "type": "image-to-model",
                      "texture_quality": "detailed"
                    }
                  }
                },
                "imageToModelQuad": {
                  "summary": "图生 3D（四边面网格，输出 FBX）",
                  "value": {
                    "model": "tripo-h3.1",
                    "input": {
                      "img_url": "https://example.com/boy.png"
                    },
                    "parameters": {
                      "type": "image-to-model",
                      "quad": true,
                      "face_limit": 10000
                    }
                  }
                },
                "multiviewToModel": {
                  "summary": "多视图生 3D（8K 贴图）",
                  "value": {
                    "model": "tripo-h3.1",
                    "input": {
                      "views": [
                        {
                          "front": "https://example.com/front.png"
                        },
                        {
                          "back": "https://example.com/back.png"
                        },
                        {
                          "right": "https://example.com/right.png"
                        }
                      ]
                    },
                    "parameters": {
                      "type": "multiview-to-model",
                      "texture_quality": "extreme"
                    }
                  }
                },
                "multiviewToModelParts": {
                  "summary": "多视图生 3D（分部件，需关闭贴图）",
                  "value": {
                    "model": "tripo-h3.1",
                    "input": {
                      "views": [
                        {
                          "front": "https://example.com/front.png"
                        },
                        {
                          "left": "https://example.com/left.png"
                        }
                      ]
                    },
                    "parameters": {
                      "type": "multiview-to-model",
                      "generate_parts": true,
                      "texture": false,
                      "pbr": false
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "任务提交成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoSubmitResponse"
                },
                "examples": {
                  "submitted": {
                    "summary": "已提交任务",
                    "value": {
                      "output": {
                        "task_id": "722d9574-7639-4be9-b98f-6adb9f6429e3"
                      },
                      "request_id": "1de5ba89-7068-461d-8e7f-16cff0edb52a"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求参数或参数组合无效，不会创建任务，也不会计费。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoErrorResponse"
                },
                "examples": {
                  "partsWithTexture": {
                    "$ref": "#/components/examples/TripoPartsWithTextureError"
                  },
                  "missingFrontView": {
                    "$ref": "#/components/examples/TripoMissingFrontViewError"
                  }
                }
              }
            }
          },
          "500": {
            "description": "上游服务返回错误（错误信息中包含上游错误码），不会创建任务，也不会计费。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoErrorResponse"
                }
              }
            }
          },
          "default": {
            "description": "错误响应。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/status": {
      "get": {
        "tags": [
          "tripo-h3.1"
        ],
        "operationId": "getTripoH31TaskStatus",
        "summary": "tripo-h3.1 3D 模型生成任务状态",
        "description": "查询异步任务状态。任务成功后，`output.urls` 中返回模型文件 URL，`output.data` 中返回预览图等上游任务信息，`usage` 中返回本次任务的计费项（计费项: 次数）。\n\n模型文件和预览图 URL 带有时效签名（约 24 小时），请在任务成功后及时下载转存。\n",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "query",
            "required": true,
            "description": "由 `/v1/tasks/submit` 返回的 `output.task_id`。",
            "schema": {
              "type": "string"
            },
            "example": "722d9574-7639-4be9-b98f-6adb9f6429e3"
          }
        ],
        "responses": {
          "200": {
            "description": "任务状态响应。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoStatusResponse"
                },
                "examples": {
                  "success": {
                    "summary": "成功任务（图生 3D，高清贴图）",
                    "value": {
                      "output": {
                        "task_id": "6b40698a-f677-4f31-b4b4-6f3825e12b5f",
                        "task_status": "Success",
                        "urls": [
                          "https://openapi.cdn.tripo3d.com/xxx/tripo_pbr_model_6b40698a-f677-4f31-b4b4-6f3825e12b5f.glb?auth_key=xxx"
                        ],
                        "data": {
                          "type": "image_to_model",
                          "progress": 100,
                          "input": {
                            "resource_url": "https://example.com/boy.png"
                          },
                          "output": {
                            "rendered_image_url": "https://openapi.cdn.tripo3d.com/xxx/legacy_mesh.webp?auth_key=xxx"
                          }
                        },
                        "submit_time": 1793155356,
                        "finish_time": 1793155477
                      },
                      "usage": {
                        "prompt_tokens": 0,
                        "completion_tokens": 0,
                        "total_tokens": 0,
                        "model3d_image_count": 1,
                        "model3d_texture_count": 1,
                        "model3d_texture_detailed_count": 1
                      },
                      "request_id": ""
                    }
                  },
                  "running": {
                    "summary": "运行中任务",
                    "value": {
                      "output": {
                        "task_id": "722d9574-7639-4be9-b98f-6adb9f6429e3",
                        "task_status": "Running",
                        "data": {
                          "type": "text_to_model",
                          "progress": 35,
                          "input": {
                            "prompt": "一个低面数中世纪木质宝箱，带有铁铰链和生锈的锁",
                            "texture": true,
                            "pbr": true,
                            "model_version": "v3.1-20260211",
                            "geometry_quality": "standard"
                          }
                        },
                        "submit_time": 1793155356
                      },
                      "usage": {
                        "prompt_tokens": 0,
                        "completion_tokens": 0,
                        "total_tokens": 0
                      },
                      "request_id": ""
                    }
                  },
                  "failure": {
                    "summary": "失败任务（不计费）",
                    "value": {
                      "output": {
                        "task_id": "722d9574-7639-4be9-b98f-6adb9f6429e3",
                        "task_status": "Failure",
                        "submit_time": 1793155356,
                        "finish_time": 1793155380,
                        "error_message": "task failed"
                      },
                      "usage": {
                        "prompt_tokens": 0,
                        "completion_tokens": 0,
                        "total_tokens": 0
                      },
                      "request_id": ""
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "任务标识无效或无权访问该任务。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoErrorResponse"
                }
              }
            }
          },
          "default": {
            "description": "错误响应。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripoErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "请在请求头中携带 `Authorization: Bearer {your_api_key}`。"
      }
    },
    "schemas": {
      "TripoH31SubmitRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "input",
          "parameters"
        ],
        "properties": {
          "model": {
            "type": "string",
            "const": "tripo-h3.1",
            "description": "模型名称。此文档固定为 `tripo-h3.1`。"
          },
          "input": {
            "$ref": "#/components/schemas/TripoInput"
          },
          "parameters": {
            "$ref": "#/components/schemas/TripoH31Parameters"
          }
        }
      },
      "TripoInput": {
        "type": "object",
        "additionalProperties": false,
        "description": "生成输入，按 `parameters.type` 填写对应字段：文生 3D 填 `prompt`，图生 3D 填 `img_url`，多视图生 3D 填 `views`。\n",
        "properties": {
          "prompt": {
            "type": "string",
            "maxLength": 1024,
            "description": "文本提示词，`text-to-model` 必填，最多 1024 个字符。建议描述形状、材质、风格和尺寸，例如「一个低面数中世纪木质宝箱，带有铁铰链和生锈的锁」；加入材质和风格描述可提升 PBR 贴图效果。\n"
          },
          "negative_prompt": {
            "type": "string",
            "maxLength": 255,
            "description": "反向提示词，仅 `text-to-model` 生效，最多 255 个字符，描述不希望在模型中出现的内容。"
          },
          "img_url": {
            "type": "string",
            "format": "uri",
            "description": "输入图片，`image-to-model` 必填。需为公网可访问的 HTTP/HTTPS 图片直链。\n\n支持 PNG、JPEG、WebP，最大 20 MB，推荐分辨率至少 256 × 256 px；主体应清晰可见、背景干净、遮挡尽量少。\n"
          },
          "views": {
            "type": "array",
            "minItems": 2,
            "maxItems": 4,
            "description": "多视角输入图片，`multiview-to-model` 必填。每个元素是只含一个视角 key 的对象，key 取 `front`（正面）、`left`（左侧）、`back`（背面）、`right`（右侧），值为公网可访问的图片 URL；元素顺序无关。\n\n规则：正面必须提供，至少 2 个视角，同一视角不可重复。所有图片应为同一物体在一致光照下拍摄；图片格式与大小要求同 `img_url`。\n",
            "items": {
              "$ref": "#/components/schemas/TripoView"
            }
          }
        }
      },
      "TripoView": {
        "type": "object",
        "minProperties": 1,
        "maxProperties": 1,
        "additionalProperties": false,
        "properties": {
          "front": {
            "type": "string",
            "format": "uri",
            "description": "正面视图 URL。"
          },
          "left": {
            "type": "string",
            "format": "uri",
            "description": "左侧视图 URL。"
          },
          "back": {
            "type": "string",
            "format": "uri",
            "description": "背面视图 URL。"
          },
          "right": {
            "type": "string",
            "format": "uri",
            "description": "右侧视图 URL。"
          }
        }
      },
      "TripoH31Parameters": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "生成方式。",
            "enum": [
              "text-to-model",
              "image-to-model",
              "multiview-to-model"
            ]
          },
          "texture": {
            "type": "boolean",
            "default": true,
            "description": "是否生成贴图。只有 `texture=false` 且 `pbr=false` 时才输出无贴图的纯几何体（白模）。"
          },
          "pbr": {
            "type": "boolean",
            "default": true,
            "description": "是否启用 PBR 材质贴图（base_color、metallic、roughness、normal）。`pbr=true` 时会强制生成贴图。"
          },
          "texture_quality": {
            "type": "string",
            "default": "standard",
            "description": "贴图质量等级，生成贴图时生效。\n- `standard`：质量与速度平衡。\n- `detailed`：高清贴图。\n- `extreme`：8K 超清贴图。\n",
            "enum": [
              "standard",
              "detailed",
              "extreme"
            ]
          },
          "texture_version": {
            "type": "string",
            "description": "贴图模型版本，可选，不传时使用 `v3.0-20250812`。贴图模型与几何模型相互独立，可任意搭配。\n- `v3.5-20260815`：最新贴图模型。使用 `delight` 时须指定此版本，否则 `delight` 不生效。\n- `v3.0-20250812`：默认贴图模型。\n\n不生成贴图（`texture=false` 且 `pbr=false`）时此参数不生效。传入其他值会返回错误，不会创建任务。\n",
            "enum": [
              "v3.5-20260815",
              "v3.0-20250812"
            ]
          },
          "texture_seed": {
            "type": "integer",
            "description": "贴图生成的随机种子。相同种子生成相同贴图；保持 `model_seed` 不变、更换 `texture_seed` 可得到相同几何体、不同贴图的模型。"
          },
          "delight": {
            "type": "boolean",
            "default": true,
            "description": "贴图前是否去除参考图中的光照信息，设为 `false` 可保留原有明暗。仅 `texture_version=v3.5-20260815` 时生效。"
          },
          "texture_alignment": {
            "type": "string",
            "default": "original_image",
            "description": "贴图对齐优先级，仅 `image-to-model`、`multiview-to-model` 生效。`original_image` 优先匹配输入图像颜色，`geometry` 优先匹配生成的几何体。",
            "enum": [
              "original_image",
              "geometry"
            ]
          },
          "orientation": {
            "type": "string",
            "default": "default",
            "description": "模型朝向，仅 `image-to-model`、`multiview-to-model` 且生成贴图时生效。`default` 自动朝向，`align_image` 对齐至输入图像视角。",
            "enum": [
              "default",
              "align_image"
            ]
          },
          "enable_image_autofix": {
            "type": "boolean",
            "default": false,
            "description": "是否在生成前自动优化输入图像（增强低分辨率或低质量图像），仅 `image-to-model` 生效。"
          },
          "geometry_quality": {
            "type": "string",
            "default": "standard",
            "description": "几何体质量等级。`standard` 质量与速度平衡；`detailed` 为超清几何（Ultra 模式），细节更精细。也可传 `ultra`，等同于 `detailed`。\n",
            "enum": [
              "standard",
              "detailed",
              "ultra"
            ]
          },
          "face_limit": {
            "type": "integer",
            "minimum": 1,
            "description": "输出网格的最大面数，不传时自适应。\n- 纯三角面：标准几何最多 1,500,000，超清几何最多 2,000,000。\n- 四边面（`quad=true`）：最多 150,000，不传时默认 10,000。\n- 智能低模（`smart_low_poly=true`）：三角面 500～20,000，四边面 500～10,000。\n\n参考：游戏资产 50,000～100,000，Web/移动端 10,000～50,000。\n"
          },
          "quad": {
            "type": "boolean",
            "default": false,
            "description": "是否输出四边面网格，开启后输出格式强制为 FBX。与 `generate_parts` 同时生效时四边面被忽略。"
          },
          "smart_low_poly": {
            "type": "boolean",
            "default": false,
            "description": "是否生成手工风格、拓扑干净的低面数模型，适合简单输入，复杂模型可能失败。"
          },
          "generate_parts": {
            "type": "boolean",
            "default": false,
            "description": "是否生成可编辑的分割部件。\n- 必须同时设置 `texture=false` 与 `pbr=false`，否则返回参数错误。\n- 与 `smart_low_poly=true` 同传时智能低模优先，不产出分块。\n- 与 `quad=true` 同传时四边面被忽略，返回三角面分块。\n"
          },
          "auto_size": {
            "type": "boolean",
            "default": false,
            "description": "是否自动缩放至真实世界尺寸（单位：米），适用于 AR/VR 或游戏引擎场景。"
          },
          "compress": {
            "type": "string",
            "description": "压缩类型。`geometry` 表示使用 meshopt 压缩，减小文件体积。",
            "enum": [
              "geometry"
            ]
          },
          "export_uv": {
            "type": "boolean",
            "default": true,
            "description": "是否在生成过程中展开 UV。设为 `false` 可加快生成速度并减小文件体积，UV 展开将在贴图阶段处理。"
          },
          "export_orientation": {
            "type": "string",
            "default": "+x",
            "description": "导出朝向（前向轴）。仅作用于本次生成；如需对模型做后续处理，建议留空。",
            "enum": [
              "+x",
              "-x",
              "-y",
              "+y"
            ]
          },
          "model_seed": {
            "type": "integer",
            "description": "几何体生成的随机种子。相同种子和相同输入生成相同的 3D 网格。"
          },
          "image_seed": {
            "type": "integer",
            "description": "文生 3D 内部「文本转图像」阶段的随机种子，仅 `text-to-model` 生效。"
          }
        }
      },
      "TripoSubmitResponse": {
        "type": "object",
        "required": [
          "output",
          "request_id"
        ],
        "properties": {
          "output": {
            "type": "object",
            "required": [
              "task_id"
            ],
            "properties": {
              "task_id": {
                "type": "string",
                "description": "异步任务唯一标识，用于查询任务状态。"
              }
            }
          },
          "request_id": {
            "type": "string",
            "description": "本次请求的唯一标识，可用于问题排查。"
          }
        }
      },
      "TripoStatusResponse": {
        "type": "object",
        "required": [
          "output",
          "request_id"
        ],
        "properties": {
          "output": {
            "$ref": "#/components/schemas/TripoStatusOutput"
          },
          "usage": {
            "$ref": "#/components/schemas/TripoUsage"
          },
          "request_id": {
            "type": "string",
            "description": "请求标识，当前固定为空字符串。"
          }
        }
      },
      "TripoStatusOutput": {
        "type": "object",
        "required": [
          "task_id",
          "task_status"
        ],
        "properties": {
          "task_id": {
            "type": "string",
            "description": "异步任务唯一标识。"
          },
          "task_status": {
            "type": "string",
            "description": "任务状态。",
            "enum": [
              "Pending",
              "Running",
              "Success",
              "Failure",
              "Expired"
            ]
          },
          "urls": {
            "type": "array",
            "description": "任务成功后返回的模型文件 URL（默认 GLB，`quad=true` 时为 FBX），带时效签名，请及时下载。",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "data": {
            "$ref": "#/components/schemas/TripoTaskData"
          },
          "submit_time": {
            "type": "integer",
            "format": "int64",
            "description": "任务提交时间（Unix 时间戳，秒）。"
          },
          "finish_time": {
            "type": "integer",
            "format": "int64",
            "description": "任务结束时间（Unix 时间戳，秒），任务到达终态后返回。"
          },
          "error_message": {
            "type": "string",
            "description": "任务失败时的错误信息。"
          }
        }
      },
      "TripoTaskData": {
        "type": "object",
        "additionalProperties": true,
        "description": "上游任务信息，字段可能随上游调整。模型文件 URL 统一在 `output.urls` 返回，此处不重复返回。",
        "properties": {
          "type": {
            "type": "string",
            "description": "上游任务类型，如 `text_to_model`、`image_to_model`、`multiview_to_model`。"
          },
          "progress": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "任务进度百分比。"
          },
          "input": {
            "type": "object",
            "additionalProperties": true,
            "description": "上游回显的实际生成参数（含未传参数的默认值），可用于核对请求。"
          },
          "output": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
              "rendered_image_url": {
                "type": "string",
                "format": "uri",
                "description": "模型预览渲染图 URL。"
              },
              "generated_image_url": {
                "type": "string",
                "format": "uri",
                "description": "文生 3D 时中间生成的参考图 URL。"
              }
            }
          }
        }
      },
      "TripoUsage": {
        "type": "object",
        "additionalProperties": true,
        "description": "用量信息。`model3d_*` 计费项仅在任务成功时返回，值为该项计费次数；未触发的计费项不返回。",
        "properties": {
          "prompt_tokens": {
            "type": "integer",
            "description": "固定为 0。"
          },
          "completion_tokens": {
            "type": "integer",
            "description": "固定为 0。"
          },
          "total_tokens": {
            "type": "integer",
            "description": "固定为 0。"
          },
          "model3d_text_count": {
            "type": "integer",
            "description": "文生 3D。"
          },
          "model3d_image_count": {
            "type": "integer",
            "description": "图生 3D。"
          },
          "model3d_multiview_count": {
            "type": "integer",
            "description": "多视图生 3D。"
          },
          "model3d_texture_count": {
            "type": "integer",
            "description": "生成贴图即计（`texture=false` 且 `pbr=false` 时不计）；高清、8K 贴图在此基础上额外计对应计费项；不同 `texture_version` 计费相同。"
          },
          "model3d_texture_detailed_count": {
            "type": "integer",
            "description": "高清贴图（`texture_quality=detailed`）。"
          },
          "model3d_texture_8k_count": {
            "type": "integer",
            "description": "8K 超清贴图（`texture_quality=extreme`）。"
          },
          "model3d_geometry_detailed_count": {
            "type": "integer",
            "description": "超清几何（`geometry_quality=detailed` 或 `ultra`）。"
          },
          "model3d_quad_count": {
            "type": "integer",
            "description": "四边面网格（`quad=true`）；与 `generate_parts=true` 同时生效时四边面被忽略，不计。"
          },
          "model3d_smart_low_poly_count": {
            "type": "integer",
            "description": "智能低模（`smart_low_poly=true`）。"
          },
          "model3d_parts_count": {
            "type": "integer",
            "description": "分部件生成（`generate_parts=true`）；与 `smart_low_poly=true` 同传时不产出分块，不计。"
          }
        }
      },
      "TripoErrorResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/components/schemas/TripoErrorObject"
          }
        }
      },
      "TripoErrorObject": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "message",
          "type"
        ],
        "properties": {
          "message": {
            "type": "string",
            "description": "错误信息，以 `[trace_id: xxx]` 开头。"
          },
          "type": {
            "type": "string",
            "description": "错误类型，如 `invalid_request_error`、`internal_error`。"
          },
          "code": {
            "type": [
              "string",
              "null"
            ],
            "description": "错误码，如 `param_error`、`model_server_error`。"
          },
          "param": {
            "type": [
              "string",
              "null"
            ],
            "description": "相关请求参数，如有。"
          },
          "trace_id": {
            "type": "string",
            "description": "请求追踪 ID。"
          }
        }
      }
    },
    "examples": {
      "TripoPartsWithTextureError": {
        "summary": "分部件未关闭贴图",
        "value": {
          "error": {
            "message": "[trace_id: b7dd6d41-bb39-4bdd-ae77-3f2879086722] Invalid param: convert task request failed: generate_parts requires texture=false and pbr=false",
            "type": "invalid_request_error",
            "param": null,
            "code": "param_error",
            "trace_id": "b7dd6d41-bb39-4bdd-ae77-3f2879086722"
          }
        }
      },
      "TripoMissingFrontViewError": {
        "summary": "多视图缺少正面",
        "value": {
          "error": {
            "message": "[trace_id: e3623db0-e9e1-4988-b4d8-6b55e55fcf78] Invalid param: convert task request failed: input.views: front view is required for multiview-to-model",
            "type": "invalid_request_error",
            "param": null,
            "code": "param_error",
            "trace_id": "e3623db0-e9e1-4988-b4d8-6b55e55fcf78"
          }
        }
      }
    }
  }
}
```