如何通过Model Derivative的GET Properties API获取完整物理属性元数据？

架构老林

2026-6-27

如何获取Autodesk Model Derivative API中的完整物理属性元数据

要拿到缺失的质量属性（面积、体积、重心这类），可以从这几个方面调整排查：

转换模型时开启物理属性提取
默认情况下，Model Derivative转SVF格式不会自动提取物理属性，提交转换作业时必须在请求payload里添加advanced参数，明确开启物理属性提取：
```
{
  "input": {
    "urn": "你的模型URN"
  },
  "output": {
    "formats": [
      {
        "type": "svf",
        "views": ["2d", "3d"],
        "advanced": {
          "extractPhysicalProperties": true,
          "extractProperties": true
        }
      }
    ]
  }
}
```
核心是extractPhysicalProperties参数，它是触发物理属性提取的关键开关。
确认原始模型包含目标属性
如果原始设计文件（比如Revit、Inventor）本身就没定义体积、重心这些数据，转换后API也无法返回对应内容。先在设计软件里检查模型是否已正确生成并保存了这些物理属性。
调用API时强制刷新数据
服务可能返回缓存的旧数据，调用GET /metadata/{urn}/metadata/{guid}/properties时，可以添加forceget=true参数，强制获取最新的属性内容：
```
GET /modelderivative/v2/designdata/{urn}/metadata/{guid}/properties?forceget=true
```
指定具体构件ID获取属性
物理属性可能仅绑定在特定构件上，如果请求未指定构件，返回的内容可能不全。可以在请求里添加objectid参数，指定目标构件的ID来获取对应的物理属性：
```
GET /modelderivative/v2/designdata/{urn}/metadata/{guid}/properties?objectid=xxx
```