天工图学 API 用户手册
天工图学 API 为业务系统提供模型上传、异步处理、结果获取和三维浏览能力。接入方只需要管理工程身份和模型业务标识，文件传输、处理和结果访问由平台统一完成。
整体架构
典型流程是：创建工程并取得 Project Key，服务端换取短期访问令牌，创建模型并取得上传授权，客户端上传文件，查询模型状态，在结果就绪后通过业务地址下载或交给 Viewer 浏览。
核心标识
| 标识 | 用途 |
|---|---|
| Project Key | 工程级长期身份，只应保存在服务端 |
| Access Token | Project Key 换取的短期访问令牌 |
| modelId | 单个模型的业务标识，用于查询状态和结果 |
| taskId | 一次处理任务的标识，用于诊断和重试 |
公网地址
生产 API：https://tiangongtuxue.com/api
线上 Demo：Project Key 上传与 Viewer Demo
面向业务的高级开发能力
在完成基础上传与浏览后，开发者还可以直接基于 Viewer 当前的 tuo-document 文档实例扩展三维业务：调整对象材质与可视性、控制相机和视图、进入 pointDetecting 模式拾取对象、生成 PMI 尺寸标注，以及添加箭头、网格、包围盒等辅助标识。
这些能力适合用于质量检查、工艺评审、装配说明、尺寸测量和定制化三维交互。平台返回基础模型结果，业务方可以在浏览器中按自己的交互规则叠加视图属性和分析标识；高级开发章节提供了可复制的代码和配套图示：
当前支持的 CAD 文件格式
平台转换接口当前支持以下 CAD 源文件：
.prt、.prt.x、.step、.stp、.igs、.iges、.x_t、.sldprt、
.catpart、.jt、.par、.psm、.sat、.sab
文件扩展名不区分大小写；.prt.x 是复合扩展名，上传时请保留完整文件名。转换成功后，平台返回 .tgvdata 三维结果和可选 .png 预览图。Viewer 还可以直接加载 .stl、.obj、.fbx、.gltf、.glb、.3dm 等网格或场景文件，但这些格式不等同于平台 CAD 转换源格式。