下载转换结果

v1 实时状态

工程 API 的状态接口：

GET /api/v1/models/{modelId}/result
Authorization: Bearer <project-access-token>

返回的 status 可能为：

created → uploading → uploaded → queued → running → succeeded
                                                   ↘ failed

同时返回 phase、最新任务 task、retryable、错误信息和 timestamps。只有 status === "succeeded" 时，url 和 imageUrl 才可用于读取产物。queued 表示消息已进入 平台处理服务，running 表示平台处理服务已经开始处理。

成功后，结果接口会返回 API 鉴权下载地址。常见产物包括：

• visual：转换后的可视化数据
• preview：预览图片
• 后续转换器扩展的其他命名产物

下载时继续使用工程访问令牌：

const response = await fetch(
  `https://tiangongtuxue.com/api/v1/models/${modelId}/assets/visual`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);

const file = await response.blob();

不要依赖服务器磁盘路径，也不要把云存储凭据暴露给业务客户端。