{
  "openapi": "3.0.3",
  "info": {
    "title": "AHOLO Open API",
    "version": "1.0.0",
    "description": "本文档为 AHOLO OpenAPI 说明，**侧重世界重建与世界生成**：从图片、视频等资源发起 **3D 高斯溅射（3DGS）世界重建**，或使用文案与图片发起 **世界生成（Spatial Gen）**，并支持按 worldId **查询详情**与**分页列表**等。请在请求头按平台约定携带 `Authorization`（见各接口安全定义）。默认网关地址见 **Servers**。",
    "x-scalar-sdk-installation": [
      {
        "lang": "TypeScript",
        "description": "从 npm 安装。完整文档：https://labs.aholo.cn/api-docs/sdk/typescript",
        "source": "npm install @manycore/aholo-sdk-asset @manycore/aholo-sdk-world @manycore/aholo-sdk-lux3d"
      },
      {
        "lang": "Java",
        "description": "Java 8+。Maven Central `com.manycoreapis:aholo-sdk-*`。完整文档：https://labs.aholo.cn/api-docs/sdk/java",
        "source": "<dependency>\n  <groupId>com.manycoreapis</groupId>\n  <artifactId>aholo-sdk-world</artifactId>\n  <version>1.5.0</version>\n</dependency>"
      },
      {
        "lang": "Python",
        "description": "Python 3.9+。PyPI `manycore-aholo-sdk-*`。完整文档：https://labs.aholo.cn/api-docs/sdk/python",
        "source": "pip install manycore-aholo-sdk-asset manycore-aholo-sdk-world manycore-aholo-sdk-lux3d"
      }
    ]
  },
  "servers": [
    {
      "url": "https://api.aholo.cn",
      "description": "Aholo 开放平台 HTTPS 入口"
    }
  ],
  "tags": [
    {
      "name": "Asset",
      "description": "获取 OUS token 后，在同一标签下对 globalDomain（COS）发起 ousCos* 直传步骤，再将可访问 URL 用于业务接口。",
      "x-displayName": "资产"
    },
    {
      "name": "World",
      "description": "3D 高斯溅射世界重建相关接口",
      "x-displayName": "世界"
    },
    {
      "name": "Lux3D",
      "description": "异步图像生成、3D 生成、模型处理、格式导出和任务查询接口。",
      "x-displayName": "Lux3D 3D生成"
    },
    {
      "name": "RenderCloudOpenUSDGuide",
      "x-displayName": "RenderCloud OpenUSD 格式说明",
      "description": "本条目用于说明 `usdContent` 支持的 OpenUSD/USDA 格式，帮助开发者构造离线渲染和实时渲染请求。\n\n`usdContent` 的传输格式为：\n\n```text\nusdContent = Base64(UTF-8(USDA 纯文本))\n```\n\n文件建议以 `#usda 1.0` 开头，编码为 UTF-8。服务端会解析场景中的相机、外部资产引用和渲染设置；未列出的 Prim 类型或属性会被忽略，语法错误会导致任务或会话失败。\n\n## 使用场景\n\n| 场景 | API | `usdContent` 内容 | 说明 |\n|------|-----|-------------------|------|\n| 离线渲染提交 | `POST /rendercloud/v1/jobs` | 完整场景 USDA | 解析相机、Mesh、3DGS、RenderSettings 后发起离线渲染 |\n| 实时渲染创建 | `POST /rendercloud/v1/streams` | 完整场景 USDA | 解析完整场景并创建实时渲染流 |\n| 实时渲染增量推送 | `POST /rendercloud/v1/streams/{sessionId}:push` | Patch USDA（`over`） | 区分更新相机、模型、灯光和环境光 |\n\n## 推荐顶层结构\n\n```usda\n#usda 1.0\n(\n    defaultPrim = \"World\"\n)\n\ndef Xform \"World\"\n{\n    def Xform \"MeshModel1\" { ... }\n    def Xform \"Cameras\"\n    {\n        def Camera \"MainCamera\" { ... }\n    }\n    def Xform \"Lights\"\n    {\n        def RectLight \"KeyRect\" { ... }\n        def SphereLight \"FillPoint\" { ... }\n    }\n}\n\ndef Scope \"Render\"\n{\n    def RenderSettings \"MainRenderSettings\"\n    {\n        custom float3 manycore:environment:giIntensity = (1, 1, 1)\n    }\n}\n```\n\n支持 `def` 定义完整场景，也支持 `over` 在实时增量推送中覆盖已有 Prim。\n\n## Stage 元数据\n\n| 字段 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `defaultPrim` | `token` 字符串 | 否 | 默认根 Prim 名称，如 `\"World\"` |\n| `doc` | 三引号字符串 | 否 | 文档说明；解析后保留，不参与渲染 |\n| `upAxis` | `token` 字符串 | 否 | 可选文档元信息；不改变云端渲染坐标轴 |\n| `metersPerUnit` | 浮点数 | 否 | 可选文档元信息；不改变云端渲染单位 |\n\n云端渲染固定使用 Z-up，且固定按 **1 单位 = 1 毫米** 处理。用户不需要设置 `upAxis` 或 `metersPerUnit`；若携带这两个 Stage 字段，服务端仅将其作为文档元信息读取，不会据此转换坐标或灯光尺寸。\n\n## Xform 变换容器\n\n`def Xform` 用于包裹模型或相机，并向子 Prim 继承变换矩阵。\n\n| 属性 | USDA 类型 | 必填 | 说明 |\n|------|-----------|------|------|\n| `matrix4d xformOp:transform` | `matrix4d` | 否 | 4x4 变换矩阵；有值时应用于子级资产或相机 |\n| `uniform token[] xformOpOrder` | `token[]` | 否 | 建议填写 `[\"xformOp:transform\"]` |\n\n矩阵采用 USD 行向量约定，平移分量位于第 4 行：\n\n```usda\nmatrix4d xformOp:transform = (\n    (m00, m01, m02, m03),\n    (m10, m11, m12, m13),\n    (m20, m21, m22, m23),\n    (m30, m31, m32, m33)\n)\n```\n\n## 外部资产\n\n### Mesh\n\n```usda\ndef Mesh \"myMesh\" (\n    payload = @manycore:/mesh/{meshId}@</mesh>\n)\n{\n}\n```\n\n### 3D Gaussian Splatting\n\n```usda\ndef ParticleField3DGaussianSplat \"MyGaussianSplat\" (\n    payload = @manycore:/mesh/{meshId}@</GaussianSplatData>\n)\n{\n}\n```\n\n`payload` 的 `assetPath` 用于引用已上传资产，`meshId` 取路径最后一段。为保持格式明确且一致，本文所有示例均使用带 target Prim 路径的规范形式：`Mesh` 使用 `@manycore:/mesh/{meshId}@</mesh>`，3DGS 使用 `@manycore:/mesh/{meshId}@</GaussianSplatData>`；不使用裸资产 ID 形式。\n\n## Camera\n\n完整场景中使用遍历顺序遇到的第一个相机。实时**相机 Patch** 中使用第一个带相机属性的 `over` 节点；该规则不适用于模型、灯光或环境光 Patch。\n\n| 属性 | USDA 类型 | 必填 | 说明 |\n|------|-----------|------|------|\n| `token projection` | `token` | 否 | 投影类型，如 `\"perspective\"` |\n| `float2 clippingRange` | `(near, far)` | 否 | 近/远裁剪面 |\n| `float focalLength` | `float` | 否 | 焦距，单位 mm |\n| `float focusDistance` | `float` | 否 | 对焦距离 |\n| `float fStop` | `float` | 否 | 光圈 f 值 |\n| `float horizontalAperture` | `float` | 否 | 水平感光面宽度，单位 mm |\n| `float verticalAperture` | `float` | 否 | 垂直感光面高度，单位 mm |\n| `matrix4d xformOp:transform` | `matrix4d` | 否 | 相机位姿 |\n| `uniform token[] xformOpOrder` | `token[]` | 否 | 建议填写 `[\"xformOp:transform\"]` |\n\n示例：\n\n```usda\ndef Camera \"MainCamera\"\n{\n    float2 clippingRange = (0.1, 1000)\n    float focalLength = 28\n    float fStop = 0\n    float horizontalAperture = 24.447495\n    float verticalAperture = 13.7517\n    token projection = \"perspective\"\n    matrix4d xformOp:transform = (\n        (1, 0, 0, 0),\n        (0, 1, 0, 0),\n        (0, 0, 1, 0),\n        (0, 0, 8.0, 1)\n    )\n    uniform token[] xformOpOrder = [\"xformOp:transform\"]\n}\n```\n\n## RenderSettings\n\n`def RenderSettings` 建议放在 `def Scope \"Render\"` 下。\n\n| 属性 | USDA 类型 | 必填 | 说明 |\n|------|-----------|------|------|\n| `rel camera` | Prim 路径 | 否 | 活动相机路径，如 `</World/Cameras/MainCamera>` |\n| `int2 resolution` | `(width, height)` | 离线渲染必填 | 输出分辨率 |\n\n离线渲染分辨率从 `RenderSettings.resolution` 读取，也兼容 Camera 节点上的 `resolution`；宽高必须为正数，且任一边不能超过服务端配置上限，默认上限为 4500 像素。存在多个 `RenderSettings` 时，使用第一个。\n\n## 灯光和环境光\n\n灯光与环境光可以在创建实时会话时写入完整 USDA，也可以在会话状态为 `ACTIVE` 后通过 `POST /rendercloud/v1/streams/{sessionId}:push` 增量更新。请求中的 `usdContent` 始终使用 `Base64(UTF-8(USDA 纯文本))` 编码。\n\n### 灯光\n\n当前支持 `RectLight` 矩形面光源和 `SphereLight` 球形点光源。灯光应放在完整场景中稳定且唯一的 Prim 路径下，并保存完整路径；后续更新和删除必须命中同一条路径。灯光的距离和尺寸始终按云端固定的 **1 单位 = 1 毫米、Z-up** 解释，无需设置 `metersPerUnit` 或 `upAxis`。\n\n| Prim / 属性 | 约束 |\n|-------------|------|\n| `RectLight` | `inputs:width`、`inputs:height` 必须为正数；支持 `inputs:color`、`inputs:intensity`、`inputs:exposure`、`inputs:specular` 和 `xformOp:transform` |\n| `SphereLight` | `inputs:radius` 必须为正数；支持 `inputs:color`、`inputs:intensity`、`inputs:exposure`、`inputs:specular` 和 `xformOp:transform` |\n| `inputs:color` | 线性 RGB；省略时为白色 |\n| `inputs:intensity` / `inputs:exposure` | 实际亮度为 `intensity × 2^exposure` |\n| `inputs:normalize` | 可省略或设置为 `false`；设置为 `true` 不支持 |\n| `xformOp:transform` / `xformOpOrder` | 设置灯光变换时必须同时写入 `uniform token[] xformOpOrder = [\"xformOp:transform\"]`，否则 Transform 不参与 USD 变换栈 |\n| `manycore:affectReflections` | `customData` 中的 `0` 或 `1`；省略时为 `1` |\n| `manycore:doubleFace` | `RectLight` 的 `customData` 布尔值；省略时为 `false` |\n\n当前不支持 `DistantLight`、`DiskLight`、`DomeLight`、Spot/IES/MeshLight、灯光链接、贴图投影、色温，也不支持 `SphereLight` 的非均匀缩放。`inputs:normalize` 可省略或设置为 `false`，但不能设置为 `true`。矩阵继续使用本文约定的行向量格式，平移分量在第 4 行。\n\n### 环境光\n\n环境光亮度写在当前生效的 `RenderSettings` Prim 上，推荐与相机和分辨率放在同一个 Prim：\n\n```usda\ncustom float3 manycore:environment:giIntensity = (1.25, 1.25, 1.25)\n```\n\n`manycore:environment:giIntensity` 是 GI 环境光 RGB 三通道的绝对强度倍率。三个值都必须是可表示为 32 位浮点数的有限正数；普通亮度滑杆应将标量 `v` 转成 `(v, v, v)`。省略该属性表示保留场景默认值，不等价于 `(1, 1, 1)`；该属性也不是灯光颜色，不受 `metersPerUnit`、`upAxis` 或 sRGB/Gamma 影响。\n\n### Patch 总则\n\n只有会话轮询到 `ACTIVE` 后才允许发送 Patch。更新时使用 `over`，路径必须与初始化场景一致；新增模型或灯光使用 `def` 并提供完整创建字段，删除模型或灯光使用 `manycore:operation:type = \"del\"`。同一个 session 的相机、模型、灯光和环境光 Patch 应按用户操作顺序串行发送，高频输入应防抖并 flush 最终值。\n\n## 实时渲染最小初始化示例\n\n以下是一个可读性优先的最小完整场景：包含一个 Mesh、一个相机、一盏矩形面光源和环境光。需要更多资产或灯光时，可在此基础上扩展；它不包含可选的 `upAxis` 或 `metersPerUnit`。\n\n```usda\n#usda 1.0\n(\n    defaultPrim = \"World\"\n)\n\ndef Xform \"World\"\n{\n    def Xform \"Model\"\n    {\n        matrix4d xformOp:transform = (\n            (1, 0, 0, 0),\n            (0, 1, 0, 0),\n            (0, 0, 1, 0),\n            (0, 0, 0, 1)\n        )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/{meshId}@</mesh>\n        ) {}\n    }\n\n    def Xform \"Cameras\"\n    {\n        def Camera \"MainCamera\"\n        {\n            float2 clippingRange = (0.1, 5000)\n            float focalLength = 28\n            float horizontalAperture = 24.447495\n            float verticalAperture = 13.7517\n            token projection = \"perspective\"\n            matrix4d xformOp:transform = (\n                (1, 0, 0, 0),\n                (0, 1, 0, 0),\n                (0, 0, 1, 0),\n                (0, 0, 8, 1)\n            )\n            uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        }\n    }\n\n    def Xform \"Lights\"\n    {\n        def RectLight \"KeyRect\"\n        {\n            color3f inputs:color = (1, 1, 1)\n            float inputs:intensity = 4\n            float inputs:width = 1200\n            float inputs:height = 600\n            float inputs:specular = 1\n            bool inputs:normalize = false\n            matrix4d xformOp:transform = (\n                (1, 0, 0, 0),\n                (0, 1, 0, 0),\n                (0, 0, 1, 0),\n                (1200, 600, 2400, 1)\n            )\n            uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        }\n    }\n}\n\ndef Scope \"Render\"\n{\n    def RenderSettings \"MainRenderSettings\"\n    {\n        rel camera = </World/Cameras/MainCamera>\n        int2 resolution = (1024, 576)\n        custom float3 manycore:environment:giIntensity = (1, 1, 1)\n    }\n}\n```\n\n## 实时渲染初始化完整示例\n\n下面是包含多个 Mesh、3DGS、相机、灯光和环境光的完整参考场景，不是最小请求体。实际请求时需要将 USDA 文本按 `Base64(UTF-8(USDA 纯文本))` 编码后传入 `usdContent`。示例中的 `payload` 统一使用带 target Prim 路径的规范形式。\n\n```usda\n#usda 1.0\n(\n    defaultPrim = \"World\"\n)\n\ndef Xform \"World\"\n{\n    def Xform \"MainSplat\" {\n        matrix4d xformOp:transform = ( (0.000051545731,0.000085786507,0,0), (-0.000085786507,0.000051545731,0,0), (0,0,0.000100081398,0), (0.174798629761,1.721153564453,0.3,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def ParticleField3DGaussianSplat \"SplatModel\" (\n            payload = @manycore:/mesh/YYKIL7BVAJQPYPTUKU888888@</GaussianSplatData>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_0_JVAIX5WPTUL4\" {\n        matrix4d xformOp:transform = ( (0.001,0,0,0), (0,0.001,0,0), (0,0,0.001,0), (0.18688556,1.6863253,1.321402,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/YYWWKOJVAIX5WPTUL4888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_1_ZVAIPWOPTULY\" {\n        matrix4d xformOp:transform = ( (0.001,0.000000000073,0,0), (-0.000000000073,0.001,0,0), (0,0,0.001,0), (-1.6171633,0.8850137,0.46721213,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/YRNLYLZVAIPWOPTULY888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_2_ZVAXAG6PTUJU\" {\n        matrix4d xformOp:transform = ( (-0.00000000008,0.0018392428,0,0), (-0.0018392428,-0.00000000008,0,0), (0,0,0.00015876645,0), (-1.638599,0.9451463,0.0005,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZSGMVMZVAXAG6PTUJU888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_3_BVAII3SPTUJU\" {\n        matrix4d xformOp:transform = ( (-0.00055461276,-0.0007359958,0,0), (0.0007359958,-0.00055461276,0,0), (0,0,0.00092156667,0), (0.06702871,0.49209814,0.32490457,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/YR3NPCBVAII3SPTUJU888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_4_RVALFX2PTUJQ\" {\n        matrix4d xformOp:transform = ( (0.00083867055,0.00054463905,0,0), (-0.00054463905,0.00083867055,0,0), (0,0,0.001,0), (-0.7005493,0.28526813,0.037392548,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/YWMNBJRVALFX2PTUJQ888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_5_RVAIIECPTULA\" {\n        matrix4d xformOp:transform = ( (-0.00000000004,0.0009199465,0,0), (-0.0009199465,-0.00000000004,0,0), (0,0,0.0009199465,0), (-3.0077407,0.81905786,0.3764504,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZC42U2RVAIIECPTULA888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_6_BVAJRHAPTUKQ\" {\n        matrix4d xformOp:transform = ( (0.0010743258,0,0,0), (0,0.0010743258,0,0), (0,0,0.0010743258,0), (0.1153041,2.9576484,1.8342776,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZDAFHEBVAJRHAPTUKQ888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_7_JVAUMCKPTULM\" {\n        matrix4d xformOp:transform = ( (-0.000000000048,0.0010972692,0,0), (-0.0010972692,-0.000000000048,0,0), (0,0,0.0010972692,0), (-1.0990643,2.1746306,0.23665573,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZS4RG7JVAUMCKPTULM888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_8_ZVAX3LMPTUJU\" {\n        matrix4d xformOp:transform = ( (0.0009108356,0.00056915325,0,0), (-0.00056915325,0.0009108356,0,0), (0,0,0.0010740377,0), (-3.3463013,2.5292085,0.863,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZSBUJIZVAX3LMPTUJU888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_9_ZVAJYACPTULU\" {\n        matrix4d xformOp:transform = ( (0.0008437305,0,0,0), (0,0.0008437305,0,0), (0,0,0.0008437305,0), (0.12560691,2.9127068,0.46892435,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZCCN76ZVAJYACPTULU888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_10_JVAIHW6PTULA\" {\n        matrix4d xformOp:transform = ( (0.00061403894,0,0,0), (0,0.00061403894,0,0), (0,0,0.00061403894,0), (-1.4365238,3.085212,1.3550343,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZG55YXJVAIHW6PTULA888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_11_UTDD52GSRTL4\" {\n        matrix4d xformOp:transform = ( (0.001,0,0,0), (0,0.0009986295,-0.00005233596,0), (0,0.00005233596,0.0009986295,0), (-0.9053951,3.1488496,1.6107593,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/6DM4O3UTDD52GSRTL4888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_12_JVAITAAPTULE\" {\n        matrix4d xformOp:transform = ( (0.0011506461,0,0,0), (0,0.0011506461,0,0), (0,0,0.0011506461,0), (-1.6382509,2.5568164,0.444,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/Z65NBFJVAITAAPTULE888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_13_JVAIJG2PTULA\" {\n        matrix4d xformOp:transform = ( (0.001,0,0,0), (0,0.001,0,0), (0,0,0.001,0), (-1.0495006,3.1262092,1.0833826,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/ZMXLP3JVAIJG2PTULA888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Model_14_JVAVUWOPTULM\" {\n        matrix4d xformOp:transform = ( (-0.000000000067,0.0015338801,0,0), (-0.0011504536,-0.00000000005,0,0), (0,0,0.0011504536,0), (-3.763693,2.7723376,1.2795,1) )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/6JVR45JVAVUWOPTULM888888@</mesh>\n        )\n        {\n        }\n    }\n\n    def Xform \"Cameras\"\n    {\n        def Camera \"MainCamera\"\n        {\n            float2 clippingRange = (0.1, 5000)\n            float focalLength = 20.7846\n            float fStop = 0\n            float horizontalAperture = 42.6667\n            float verticalAperture = 24.0000\n            token projection = \"perspective\"\n            matrix4d xformOp:transform = ( (0.7333269715309143,0.6797372698783875,-0.01374034397304058,0), (-0.0885528177022934,0.11553312093019485,0.9893485307693481,0), (0.6740845441818237,-0.7242991924285889,0.14491620659828186,0), (0.8263652324676514,-0.030662942677736282,0.8460000157356262,1) )\n            uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        }\n    }\n\n    def Xform \"Lights\"\n    {\n        def RectLight \"KeyRect\" (\n            customData = {\n                int manycore:affectReflections = 1\n                bool manycore:doubleFace = false\n            }\n        )\n        {\n            color3f inputs:color = (1.0, 0.95, 0.90)\n            float inputs:intensity = 4.0\n            float inputs:exposure = 0.0\n            float inputs:width = 1200\n            float inputs:height = 600\n            float inputs:specular = 1\n            bool inputs:normalize = false\n            matrix4d xformOp:transform = (\n                (1, 0, 0, 0),\n                (0, 1, 0, 0),\n                (0, 0, 1, 0),\n                (1200, 600, 2400, 1)\n            )\n            uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        }\n\n        def SphereLight \"FillPoint\"\n        {\n            color3f inputs:color = (0.70, 0.80, 1.00)\n            float inputs:intensity = 40.0\n            float inputs:exposure = -1.0\n            float inputs:radius = 80\n            float inputs:specular = 1\n            bool inputs:normalize = false\n            matrix4d xformOp:transform = (\n                (1, 0, 0, 0),\n                (0, 1, 0, 0),\n                (0, 0, 1, 0),\n                (-500, 900, 1800, 1)\n            )\n            uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        }\n    }\n}\n\ndef Scope \"Render\"\n{\n    def RenderSettings \"MainRenderSettings\"\n    {\n        rel camera = </World/Cameras/MainCamera>\n        int2 resolution = (1024, 576)\n        custom float3 manycore:environment:giIntensity = (1.25, 1.25, 1.25)\n    }\n}\n```\n\n## 实时增量 Patch\n\n实时增量推送不重建完整场景，而是分别通过 Patch 更新相机、模型、灯光和环境光。只有会话状态为 `ACTIVE` 时才能发送；每次 Patch 使用 `over`，并保持与初始化完整 USDA 一致的 Prim 路径。\n\n### 相机 Patch\n\n```usda\n#usda 1.0\n\nover \"World\"\n{\n    over \"Cameras\"\n    {\n        over \"MainCamera\"\n        {\n            token projection = \"perspective\"\n            float focalLength = 50\n            float focusDistance = 100\n            float horizontalAperture = 36.0\n            float verticalAperture = 24.0\n            float2 clippingRange = (0.1, 5000.0)\n            matrix4d xformOp:transform = (\n                (1, 0, 0, 0),\n                (0, 1, 0, 0),\n                (0, 0, -1, 0),\n                (10, 20, 30, 1)\n            )\n        }\n    }\n}\n```\n\n### 模型 Patch\n\n模型使用 `Xform` 作为稳定的父 Prim，模型数据可使用 `Mesh` 或 `ParticleField3DGaussianSplat` 的 `payload` 引用已上传资产。模型新增、Transform 修改和删除都必须使用完整且一致的 Prim 路径；父级 `Xform` 必须是完整场景或此前已成功 Patch 的已知节点。\n#### 3DGS 模型\n\n**添加 3DGS 模型**：使用 `def`，同时提供模型的 Transform、`xformOpOrder` 和 `payload`。\n\n```usda\nover \"World\"\n{\n    def Xform \"GaussianSplatModel2\"\n    {\n        matrix4d xformOp:transform = (\n            (0.001, 0.0, 0.0, 0.0),\n            (0.0, 0.0, 0.001, 0.0),\n            (0.0, -0.001, 0.0, 0.0),\n            (0.0, 0.0, 0.0, 1.0)\n        )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def ParticleField3DGaussianSplat \"MyGaussianSplat2\" (\n            payload = @manycore:/mesh/YYPZPUETQYRLIPTUKE888888@</GaussianSplatData>\n        )\n        {\n        }\n    }\n}\n```\n\n**修改 3DGS 模型 Transform**：对已有父 `Xform` 使用 `over`，写入新的完整行向量矩阵；子模型可用空的 `over` 节点明确命中路径。\n\n```usda\nover \"World\"\n{\n    over \"GaussianSplatModel2\"\n    {\n        matrix4d xformOp:transform = (\n            (0.001, 0.0, 0.0, 0.0),\n            (0.0, 0.0, 0.001, 0.0),\n            (0.0, -0.001, 0.0, 0.0),\n            (-2.01571919623, -0.262131040274, 1.279749806075, 1.0)\n        )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        over ParticleField3DGaussianSplat \"MyGaussianSplat2\"\n        {\n        }\n    }\n}\n```\n\n**删除 3DGS 模型**：在原模型路径下，对 `ParticleField3DGaussianSplat` 添加 `manycore:operation:type = \"del\"`。不要先修改模型名称或路径再删除。\n\n```usda\nover \"World\"\n{\n    over \"GaussianSplatModel2\"\n    {\n        over ParticleField3DGaussianSplat \"MyGaussianSplat2\"\n        (\n            customData = {\n                string manycore:operation:type = \"del\"\n            }\n        )\n        {\n        }\n    }\n}\n```\n\n#### Mesh 模型\n\n`Mesh` 模型的 Patch 语义与 3DGS 一致，只是 `payload` 的 target Prim 使用 `</mesh>`。\n\n**添加 Mesh 模型**：\n\n```usda\nover \"World\"\n{\n    def Xform \"MeshModel2\"\n    {\n        matrix4d xformOp:transform = (\n            (0.001, 0.0, 0.0, 0.0),\n            (0.0, 0.0, 0.001, 0.0),\n            (0.0, -0.001, 0.0, 0.0),\n            (0.0, 0.0, 0.0, 1.0)\n        )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        def Mesh \"Geom\" (\n            payload = @manycore:/mesh/YYPZPUETQYRLIPTUKE888888@</mesh>\n        )\n        {\n        }\n    }\n}\n```\n\n**修改 Mesh 模型 Transform**：\n\n```usda\nover \"World\"\n{\n    over \"MeshModel2\"\n    {\n        matrix4d xformOp:transform = (\n            (0.001, 0.0, 0.0, 0.0),\n            (0.0, 0.0, 0.001, 0.0),\n            (0.0, -0.001, 0.0, 0.0),\n            (-2.01571919623, -0.262131040274, 1.279749806075, 1.0)\n        )\n        uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        over Mesh \"Geom\"\n        {\n        }\n    }\n}\n```\n\n**删除 Mesh 模型**：\n\n```usda\nover \"World\"\n{\n    over \"MeshModel2\"\n    {\n        over Mesh \"Geom\"\n        (\n            customData = {\n                string manycore:operation:type = \"del\"\n            }\n        )\n        {\n        }\n    }\n}\n```\n\n模型 Patch 与相机、灯光、环境光 Patch 共用同一个 session 级发送队列；只有服务端返回成功且会话仍为 `ACTIVE` 后，前端才更新本地已提交场景状态。\n\n### 灯光 Patch\n\n修改灯光时只写发生变化的字段；更新位置、旋转或缩放时写入完整的行向量 `matrix4d xformOp:transform`，并同时写入 `uniform token[] xformOpOrder = [\"xformOp:transform\"]`。例如修改 `/World/Lights/KeyRect` 的颜色和亮度：\n\n```usda\nover \"World\"\n{\n    over \"Lights\"\n    {\n        over RectLight \"KeyRect\"\n        {\n            color3f inputs:color = (1.0, 0.72, 0.50)\n            float inputs:intensity = 8.0\n        }\n    }\n}\n```\n\n新增灯光使用 `def` 并填写完整字段；删除已有灯光时使用相同路径和 `manycore:operation:type = \"del\"`：\n\n```usda\nover \"World\"\n{\n    over \"Lights\"\n    {\n        def SphereLight \"Accent\"\n        {\n            color3f inputs:color = (0.2, 0.4, 1.0)\n            float inputs:intensity = 12.0\n            float inputs:exposure = 0.0\n            float inputs:radius = 50.0\n            float inputs:specular = 1\n            bool inputs:normalize = false\n            matrix4d xformOp:transform = (\n                (1, 0, 0, 0),\n                (0, 1, 0, 0),\n                (0, 0, 1, 0),\n                (300, 400, 500, 1)\n            )\n            uniform token[] xformOpOrder = [\"xformOp:transform\"]\n        }\n\n        over SphereLight \"FillPoint\" (\n            customData = { string manycore:operation:type = \"del\" }\n        ) {}\n    }\n}\n```\n\n### 环境光 Patch\n\n环境光 Patch 必须命中初始化阶段记录的同一个 `RenderSettings` Prim 路径，推荐显式写出类型：\n\n```usda\n#usda 1.0\n\nover Scope \"Render\"\n{\n    over RenderSettings \"MainRenderSettings\"\n    {\n        custom float3 manycore:environment:giIntensity = (0.8, 0.8, 0.8)\n    }\n}\n```\n\n环境光更新使用绝对值覆盖，例如从 `2.0` 更新到 `0.8` 直接发送 `(0.8, 0.8, 0.8)`。不能发送 `0`、负数或 `None`，也不能通过删除属性、删除 `RenderSettings` 或 `manycore:operation:type = \"del\"` 清除环境光；恢复倍率 1 时显式发送 `(1, 1, 1)`。\n\n## 已支持 Prim / 属性\n\n| Prim 类型 | 支持 | 关键属性 / 元数据 |\n|-----------|------|-------------------|\n| `Xform` | 支持 | `xformOp:transform`, `xformOpOrder`；可作为模型父节点进行 `def` / `over` |\n| `Mesh` | 支持 | 元数据 `payload`；可通过 `over` 和删除标记移除 |\n| `ParticleField3DGaussianSplat` | 支持 | 元数据 `payload`；可通过 `over` 和删除标记移除 |\n| `Camera` | 支持 | 相机参数和位姿 |\n| `RectLight` | 支持 | `inputs:color`, `inputs:intensity`, `inputs:exposure`, `inputs:width`, `inputs:height`, `inputs:specular`, `xformOp:transform` |\n| `SphereLight` | 支持 | `inputs:color`, `inputs:intensity`, `inputs:exposure`, `inputs:radius`, `inputs:specular`, `xformOp:transform` |\n| `RenderSettings` | 支持 | `camera`, `resolution`, `manycore:environment:giIntensity` |\n| `Scope` | 支持 | 作为层级容器 |\n| 其他 USD 类型 | 忽略 | 不参与渲染 |\n\n## 限制与常见错误\n\n| 项 | 说明 |\n|----|------|\n| **固定单位与坐标轴** | 云端固定按 1 单位 = 1 毫米、Z-up 渲染；不需要设置 `metersPerUnit` 或 `upAxis`，携带时也不会触发坐标或尺寸换算 |\n| **重要：矩阵约定不一致** | 前端显示使用的矩阵约定可能与云端渲染不同；云端渲染要求 USDA 中模型和相机的 `xformOp:transform` 都按行优先 / 行向量表示，平移分量位于第 4 行 |\n| 灯光 Transform | 只写 `xformOp:transform` 不会进入 USD 变换栈；必须同时写入 `xformOpOrder` |\n| 环境光亮度 | `manycore:environment:giIntensity` 的三个值必须是有限正数；不支持用 `0`、删除属性或删除 Prim 清除环境光 |\n| 不支持的灯光类型 | `DistantLight`、`DiskLight`、`DomeLight`、Spot/IES/MeshLight、灯光链接、贴图投影和色温不参与渲染 |\n| 非完整 USD | 不支持 `references`、`subLayers`、`variantSets`、材质网络等标准 USD 合成能力 |\n| 多相机 / 多 RenderSettings | 使用遍历顺序遇到的第一个 |\n| 未知属性 | 忽略，不报错 |\n| 语法错误 | 未闭合 `{}`、非法属性值等会导致解析失败 |\n| 资产不存在 | `payload` 中引用的资产不存在时，渲染可能失败或缺少对应资产 |\n",
      "x-scalar-doc-only": true
    },
    {
      "name": "RenderCloud",
      "description": "OpenUSD 渲染云接口",
      "x-displayName": "渲染云"
    },
    {
      "name": "RealityGuide",
      "x-displayName": "开发指南",
      "x-scalar-doc-only": true,
      "description": "上传照片、多段普通视频、Insta360 INSV 或 DJI OSV，也可提供文件 URL，提交异步任务并下载三维高斯模型。支持空间或物体、多相机、位姿、完整 IMU 与遮罩，以及按次重建下载图片和 mask。\n\n照片适合静物与空间；普通视频适合边走边拍；360 视频一次覆盖更大范围。上传后都在同一个项目页里看进度、看模型。\n\n[快速开始](#reality-guide-quickstart) · [相机与鱼眼](#reality-guide-cameras) · [IMU 接入](#reality-guide-imu) · [多段视频 / URL](#reality-guide-videos) · [INSV / OSV](#reality-guide-insv) · [结果下载](#reality-guide-results) · [错误与重试](#reality-guide-errors)\n\n用 AI 助手提交重建，见 [Reality Skill 使用指南](/api-docs/skills/reality)。生成客户端可下载[中文 OpenAPI YAML](/api-docs/specifications/services/reality/openapi.yaml)。\n\n<span id=\"reality-guide-quickstart\"></span>\n\n## 快速开始\n\n在[API Key 控制台](https://labs.aholo.cn/api-keys)创建密钥，保存到服务端环境变量 `AHOLO_OPENAPI_KEY`。下面以一组照片为例，每一步都链接到对应接口的参数和 cURL 示例。\n\n1. **[创建重建项目](#tag/reality/POST/web-scan/v2/reconstructions)**。为这次拍摄命名，保存返回的项目 ID（`PROJECT_ID`）。\n2. **[上传图片](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/images/{fid})**。准备至少 12 张清晰、有重叠的照片。每张使用独立的图片 ID 和拍摄序号，等所有图片就绪。\n3. **[创建重建任务](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/jobs)**。在同一项目下提交场景或物体重建，选择 PLY 或 SPZ，保存任务 ID（`JOB_ID`）。\n4. **[查看任务进度](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/jobs/{rid})**。cURL 示例用 `-D -` 显示响应头。按 `Retry-After` 指定的秒数间隔查询，直到成功或失败。失败时查看 `error`。\n5. **[下载成果](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/jobs/{rid}/artifacts/{name})**。成功后从 `artifacts` 选择实际生成的模型文件，将模型与 `scale.json` 一起保存。\n\n创建项目、提交任务或通过 URL 上传后，响应头 `Location` 是以 `/web-scan/v2/` 开头的相对路径。将它原样保存到 `LOCATION`，接在网关域名 `https://api.aholo.cn` 后即可查询。以下示例也会显示轮询所需的 `Retry-After` 响应头。\n\n```bash\ncurl --fail-with-body -D - \"https://api.aholo.cn${LOCATION}\" -H \"Authorization: $AHOLO_OPENAPI_KEY\"\n```\n\n模型的 `href`、原图的 `content_href` 和非空的 `mask_href` 也使用这种相对路径。例如，把 `artifacts` 中 `scene.spz` 的 `href` 保存到 `HREF` 后，可这样下载：\n\n```bash\ncurl --fail --location \"https://api.aholo.cn${HREF}\" -H \"Authorization: $AHOLO_OPENAPI_KEY\" -o scene.spz\n```\n\n下载接口若返回 HTTP 302，此时 `Location` 是完整的签名 URL。上例会跟随跳转，跨域请求不携带平台 Key。\n\n<span id=\"reality-guide-cameras\"></span>\n\n## 相机与鱼眼\n\n普通单相机照片可以直接上传。使用原始鱼眼照片或多相机设备时，先在[创建项目](#tag/reality/POST/web-scan/v2/reconstructions)时声明镜头，再分别上传各镜头的照片。相机模型、内参顺序和标定示例见该接口。带标定或遮罩的照片要先统一像素方向，详见[上传图片](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/images/{fid})。\n\n已有位姿时，上传图片后[设置图片元数据](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/images/{fid}/metadata)；多相机同一次曝光使用同一帧标识。做物体重建且已有前景轮廓时，可逐图[上传遮罩](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/images/{fid}/mask)，再提交物体重建任务。\n\n<span id=\"reality-guide-imu\"></span>\n\n## IMU 接入\n\n照片有真实曝光时间，且设备记录了原始陀螺仪数据时，可以用 IMU 辅助求解相邻曝光的旋转。平移仍由图像求解。接入前要对齐相机和传感器时钟；已经提供相机或设备位姿的项目不能同时使用原始 IMU。\n\n先逐图[设置曝光时间](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/images/{fid}/metadata)，再按[上传 IMU](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/imu)里的数组格式和 Python 示例生成并上传 NPZ。[核对采样数与时间范围](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/imu)后提交任务。补拍时可以[追加 IMU 分段](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/imu/segments/{segmentid})，沿用原有标定和时间轴。\n\n<span id=\"reality-guide-videos\"></span>\n\n## 多段视频 / URL\n\n同一场景的多段普通视频可以与照片一起重建。每段分别[创建视频资源](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/videos)。有公网下载地址时，直接提供 URL 和文件大小；文件在本机时，按服务返回的块大小[上传分块](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/videos/{vid}/parts/{part})，再[完成上传并抽帧](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/videos/{vid}/complete)。长视频先根据该接口的图像数和像素上限选择帧率。\n\n逐段[查询导入进度](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/videos/{vid})，所有视频就绪后再[创建一个重建任务](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/jobs)。图片、遮罩或 IMU 通过 URL 上传时，先[等待异步上传成功](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/uploads/{uid})。\n\n<span id=\"reality-guide-insv\"></span>\n\n## INSV / OSV\n\n使用 Insta360 或 DJI 的双镜头原片时，保留相机导出的原始文件。服务会读取内嵌标定和陀螺仪数据。先建一个未声明相机的空项目，按[创建 INSV/OSV 导入](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/insv)核对机型并登记文件。\n\n本地文件可以[分块续传](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/insv/parts/{part})。单段录制在[完成上传](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/insv/complete)后自动提交重建，[查询导入进度](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/insv)拿到任务 ID 后即可跟踪结果。多段连续录制则要[逐段确认](#tag/reality/POST/web-scan/v2/reconstructions/{pid}/insv/{iid}/complete)，待全部导入后手动创建同一个重建任务。\n\n<span id=\"reality-guide-results\"></span>\n\n## 结果下载\n\n任务成功后，从[任务详情](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/jobs/{rid})选择已生成的 PLY 或压缩的 SPZ，按文件名[下载模型](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/jobs/{rid}/artifacts/{name})，将 `scale.json` 与模型一起保存。要做测量或坐标转换，先用这个文件确认单位和坐标系。分块模型以 ZIP 提供。\n\n相机位姿和遮罩可在任务详情中按需选取。要复现某次重建，[查看该任务实际使用的图片和遮罩](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/jobs/{rid}/images)；要取项目保存的原图，[查看项目图片列表](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/images)。下游服务需要免密下载时，可为指定任务[开启或关闭公开访问](#tag/reality/PUT/web-scan/v2/reconstructions/{pid}/jobs/{rid}/public-access)。补拍后再提交新任务，旧结果仍可按原任务 ID 下载。\n\n<span id=\"reality-guide-errors\"></span>\n\n## 错误与重试\n\n先判断失败发生在哪里。请求被拒绝时，按该接口的 HTTP 状态码和响应内容排查：先核对密钥和资源归属，再检查输入格式、大小以及是否还有上传或任务进行中。查询任务返回 HTTP 200 时，也要检查任务状态；`failed` 的原因在[任务详情](#tag/reality/GET/web-scan/v2/reconstructions/{pid}/jobs/{rid})的 `error` 中。\n\nHTTP 401 时按响应的 `Content-Type` 读取错误消息。网关返回 `application/json` 时读 `m`，业务服务返回 `application/problem+json` 时读 `detail`。\n\n遇到限流或临时服务故障，优先按 `Retry-After` 等待，未给出间隔时使用指数退避。重试同一次创建请求时复用原幂等键；重传图片或分块时复用原 ID 和文件内容。参数校验失败先修正输入，再提交。\n"
    },
    {
      "name": "Reality",
      "x-displayName": "接口参考"
    },
    {
      "name": "SpatialUnderstanding",
      "description": "空间理解：用室内点云（.ply）创建异步任务，轮询详情获取 Wall / Door / Window / Bbox 文本结果，或分页查询任务列表。",
      "x-displayName": "空间理解"
    }
  ],
  "paths": {
    "/asset/v1/token": {
      "get": {
        "tags": [
          "Asset"
        ],
        "summary": "获取 OUS 上传凭证",
        "description": "本接口仅返回上传前置凭证；**真实直传发生在 OUS 的 `globalDomain` 上**（与开放平台网关域名不同），与同标签 **「Upload」** 中的 `ousCosSingleUpload`、`ousCosBlockUploadInit`、`ousCosBlockUploadPart`、`ousCosUploadStatus` 衔接。\n\n**推荐流程：**\n1. 调用本接口，取得 `ousToken`、`globalDomain`（示例：`https://ous-cos.kujiale.com`）、`blockSize`。\n2. 若文件大小 **≤ `blockSize`**：调用 `ousCosSingleUpload`；若 **> `blockSize`**：依次调用 `ousCosBlockUploadInit` 与多次 `ousCosBlockUploadPart`。\n3. 轮询 `ousCosUploadStatus`，直到任务成功并取得 `url`。\n4. 将得到的可访问 URL 填入 其他业务接口，比如「创建 3DGS 世界重建任务」的 `resources[].url`。\n",
        "operationId": "getUploadToken",
        "responses": {
          "200": {
            "description": "成功时响应体为 OUS 上传凭证（`ousToken`、`globalDomain`、`blockSize`），用于在返回的 COS 域名上继续直传或分片上传。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_UploadTokenOuterOpen"
                },
                "examples": {
                  "success": {
                    "summary": "获取凭证成功",
                    "description": "success",
                    "value": {
                      "ousToken": "<token>",
                      "globalDomain": "https://ous-cos.kujiale.com",
                      "blockSize": 1048576
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "参数/业务校验失败（ApiError，`details.metaData.bizCode` 为原业务码）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "参数校验失败",
                    "description": "业务码 10001（PARAMS_INVALID）",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004（NOT_LOGGED_IN）",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 5,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createAssetClient } from '@manycore/aholo-sdk-asset';\n\n// SDK 封装 token / 分片 / 轮询，无需手写本接口\nconst asset = createAssetClient({ region: 'cn' });\nconst result = await asset.uploadFile('./video.mp4');\nconsole.log(result.url);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.asset.AssetClient;\nimport com.manycoreapis.sdk.asset.UploadResult;\nimport com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\n\nAssetClient asset = AssetClient.create(AholoClientConfig.ofRegion(\"cn\"));\nUploadResult result = asset.uploadFile(Paths.get(\"video.mp4\"));\nSystem.out.println(result.url());"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_asset import create_asset_client\n\n# SDK 封装 token / 分片 / 轮询，无需手写本接口\nasset = create_asset_client(region='cn')\nresult = asset.upload_file('./video.mp4')\nprint(result.url)"
          }
        ]
      }
    },
    "/ous/api/v2/single/upload": {
      "post": {
        "tags": [
          "Asset"
        ],
        "summary": "OUS 单文件上传（≤ blockSize）",
        "description": "当文件字节数 **≤** token 接口返回的 `blockSize` 时使用；详情见 `requestBody` 与 `components.schemas.OusCosSingleUploadForm`。",
        "operationId": "ousCosSingleUpload",
        "requestBody": {
          "description": "单文件上传请求体。",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/asset_OusCosSingleUploadForm"
              },
              "encoding": {
                "file": {
                  "contentType": "application/octet-stream"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时 `c` 为 `0`，`d` 含 `taskId`；随后轮询 `GET /ous/api/v2/upload/status`。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_OusV2SingleUploadApiResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "OusTokenV2": []
          }
        ],
        "servers": [
          {
            "url": "https://ous-cos.kujiale.com",
            "description": "OUS 返回的 `globalDomain`；生产环境常见为该 COS 域名（以 token 接口实际返回为准）。"
          }
        ],
        "x-scalar-order": 6
      }
    },
    "/ous/api/v2/block/upload/init": {
      "post": {
        "tags": [
          "Asset"
        ],
        "summary": "OUS 分片上传 — 初始化",
        "description": "当文件字节数 **>** `blockSize` 时使用。**常用调用**：`POST`，必填参数放在 **URL Query**（无 request body，无需 `Content-Type: application/json`），例如 `…/ous/api/v2/block/upload/init?md5=…&blocks=…&size=…&name=…`。",
        "operationId": "ousCosBlockUploadInit",
        "parameters": [
          {
            "name": "md5",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "文件 MD5，十六进制小写",
              "example": "e99a18c428cb38d5f260853678922e03"
            }
          },
          {
            "name": "blocks",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "description": "总分片数",
              "format": "int64",
              "example": 11
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "description": "文件总字节数",
              "format": "int64",
              "example": 5942880
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "原始文件名",
              "example": "photo.jpg"
            }
          },
          {
            "name": "metadata",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "元数据（可选）"
            }
          },
          {
            "name": "customPrefix",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "自定义存储前缀（可选）"
            }
          },
          {
            "name": "customFilename",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "自定义文件名（可选）"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功时 `c` 为 `0`，`d` 含 `taskId`、`lackBlocks`、`progress`、`deduplicated`。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_OusV2BlockInitApiResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "OusTokenV2": []
          }
        ],
        "servers": [
          {
            "url": "https://ous-cos.kujiale.com",
            "description": "OUS 返回的 `globalDomain`；生产环境常见为该 COS 域名（以 token 接口实际返回为准）。"
          }
        ],
        "x-scalar-order": 7
      }
    },
    "/ous/api/v2/block/upload/part": {
      "post": {
        "tags": [
          "Asset"
        ],
        "summary": "OUS 分片上传 — 上传单个分片",
        "description": "每个分片调用一次；见 `OusCosBlockUploadPartForm`。",
        "operationId": "ousCosBlockUploadPart",
        "requestBody": {
          "description": "单个分片上传请求体。",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/asset_OusCosBlockUploadPartForm"
              },
              "encoding": {
                "file": {
                  "contentType": "application/octet-stream"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时 `c` 为 `0`，`d` 为 `null`。同文件分片并发建议不超过 2。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_OusV2BlockPartApiResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "OusTokenV2": []
          }
        ],
        "servers": [
          {
            "url": "https://ous-cos.kujiale.com",
            "description": "OUS 返回的 `globalDomain`；生产环境常见为该 COS 域名（以 token 接口实际返回为准）。"
          }
        ],
        "x-scalar-order": 8
      }
    },
    "/ous/api/v2/upload/status": {
      "get": {
        "tags": [
          "Asset"
        ],
        "summary": "OUS — 查询上传状态（轮询）",
        "description": "轮询当前上传任务；`d` 在单文件与分片任务下结构不同（见 response schema 中 `d` 的 oneOf）。请求仅携带 `ous-token-v2`，无 body。建议轮询间隔 ≥200ms、总时长约 5s 量级。",
        "operationId": "ousCosUploadStatus",
        "responses": {
          "200": {
            "description": "成功时 `c` 为 `0`；`d` 为单文件或分片任务状态/结果（`status=5` 为成功终态，详见内嵌字段说明与文档状态表）。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/asset_OusV2UploadStatusApiResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "OusTokenV2": []
          }
        ],
        "servers": [
          {
            "url": "https://ous-cos.kujiale.com",
            "description": "OUS 返回的 `globalDomain`；生产环境常见为该 COS 域名（以 token 接口实际返回为准）。"
          }
        ],
        "x-scalar-order": 9
      }
    },
    "/world/v1/reconstructions": {
      "post": {
        "tags": [
          "World"
        ],
        "summary": "创建 3DGS 世界重建任务",
        "description": "异步创建一条 3DGS 世界重建任务。受理成功后返回 `WorldAsyncOperation`，仅含 `worldId`，与「查询世界详情」路径 `{worldId}` 一致。**资源格式**：image：.jpg / .jpeg / .png / .webp；video：.mp4 / .mov；insv：.insv。\n**输入规则**：若 `resources` 中含有图片类资源（`type=image` 或省略 `type`），则图片类条数须 **至少 20 条**；仅使用视频时请设 `type=video`，Insta360 全景视频请设 `type=insv`（均不触发「至少 20 张图」限制）。",
        "operationId": "createWorld",
        "parameters": [
          {
            "name": "x-source",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "创建任务请求体。含图时须满足图片张数与「CreateWorldRequest」中说明一致。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/world_CreateWorldRequest"
              },
              "examples": {
                "createWorldWithVideo": {
                  "description": "单视频 + 空间场景；`type: video`，支持 .mp4 / .mov",
                  "value": {
                    "name": "客厅重建",
                    "resources": [
                      {
                        "url": "https://cdn.example.com/input/room-001.mp4",
                        "type": "video"
                      }
                    ],
                    "taskQuality": "high",
                    "scene": "space"
                  }
                },
                "createWorldWithInsv": {
                  "description": "Insta360 全景视频；`type: insv`，支持 .insv",
                  "value": {
                    "name": "全景客厅重建",
                    "resources": [
                      {
                        "url": "https://cdn.example.com/input/room-001.insv",
                        "type": "insv"
                      }
                    ],
                    "taskQuality": "high",
                    "scene": "space"
                  }
                },
                "createWorldWithImages": {
                  "description": "多图：须 ≥20 条 image（或省略 type 按图计），支持 .jpg / .jpeg / .png / .webp；此处为结构示意",
                  "value": {
                    "name": "客厅重建",
                    "resources": [
                      {
                        "url": "https://cdn.example.com/in/1.jpg",
                        "type": "image"
                      },
                      {
                        "url": "https://cdn.example.com/in/2.jpg",
                        "type": "image"
                      }
                    ],
                    "taskQuality": "high",
                    "scene": "space"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "受理成功：返回 `WorldAsyncOperation`，含 `worldId`。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_WorldAsyncOperation"
                },
                "examples": {
                  "success": {
                    "summary": "创建受理成功",
                    "description": "success",
                    "value": {
                      "worldId": "A1b2C3d4E5"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "参数/请求体校验失败、积分不足等（ApiError，`details.metaData.bizCode` 为原业务码）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "参数/请求体校验失败",
                    "description": "业务码 10001（PARAMS_INVALID）",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  },
                  "insufficientCredits": {
                    "summary": "积分不足以完成任务",
                    "description": "业务码 11003；若当前环境创建接口未扣积分则可能不出现",
                    "value": {
                      "code": 400,
                      "message": "insufficient credits to complete task",
                      "status": "FAILED_PRECONDITION",
                      "details": {
                        "reason": "BIZ_11003",
                        "domain": "api.aholo.cn",
                        "message": "insufficient credits to complete task",
                        "metaData": {
                          "bizCode": "11003"
                        }
                      }
                    }
                  },
                  "taskMattingError": {
                    "summary": "任务域其它错误（示例）",
                    "description": "业务码 11004，与本创建链路未必出现",
                    "value": {
                      "code": 400,
                      "message": "matting error",
                      "status": "FAILED_PRECONDITION",
                      "details": {
                        "reason": "BIZ_11004",
                        "domain": "api.aholo.cn",
                        "message": "matting error",
                        "metaData": {
                          "bizCode": "11004"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004（NOT_LOGGED_IN）",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "全局任务并发或限流（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "taskGlobalRateLimit": {
                    "summary": "全局任务并发达上限",
                    "description": "业务码 11001",
                    "value": {
                      "code": 429,
                      "message": "task global rate limit",
                      "status": "RESOURCE_EXHAUSTED",
                      "details": {
                        "reason": "BIZ_11001",
                        "domain": "api.aholo.cn",
                        "message": "task global rate limit",
                        "metaData": {
                          "bizCode": "11001"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 10,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createWorldClient } from '@manycore/aholo-sdk-world';\n\nconst world = createWorldClient({ region: 'cn' });\nconst { worldId } = await world.reconstructions.create({\n  name: '客厅',\n  resources: [{ url: 'https://cdn.example.com/room.mp4', type: 'video' }],\n  taskQuality: 'normal',\n  scene: 'model',\n});\nconst detail = await world.waitFor(worldId);\nconsole.log(detail.assets?.splats?.urls?.plyPath);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.world.WorldClient;\nimport com.manycoreapis.sdk.world.model.ReconstructionCreateParams;\nimport com.manycoreapis.sdk.world.model.GenerationCreateParams;\nimport com.manycoreapis.sdk.world.model.WorldListParams;\nimport com.manycoreapis.sdk.world.model.WorldAsyncOperation;\nimport com.manycoreapis.sdk.world.model.WorldDetail;\nimport com.manycoreapis.sdk.world.model.WorldPagedList;\n\nWorldClient world = WorldClient.create(AholoClientConfig.ofRegion(\"cn\"));\nWorldAsyncOperation op = world.reconstructions().create(\n    ReconstructionCreateParams.builder()\n        .name(\"客厅\")\n        .addResource(\"https://cdn.example.com/room.mp4\", \"video\")\n        .taskQuality(\"normal\")\n        .scene(\"model\")\n        .build());\nWorldDetail detail = world.waitFor(op.worldId());"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_world import create_world_client\n\nworld = create_world_client(region='cn')\nop = world.reconstructions.create(\n    name='客厅',\n    resources=[{'url': 'https://cdn.example.com/room.mp4', 'type': 'video'}],\n    task_quality='normal',\n    scene='model',\n)\ndetail = world.wait_for(op['worldId'])\nprint(detail.get('assets', {}).get('splats', {}).get('urls', {}).get('plyPath'))"
          }
        ]
      }
    },
    "/world/v1/generations": {
      "post": {
        "tags": [
          "World"
        ],
        "summary": "创建 3DGS 世界生成任务",
        "description": "异步创建一条3DGS 世界生成任务（Spatial Gen）。当前 **室内空间** 场景效果更成熟、更稳定，建议优先用于室内。也允许提交 **非室内** 类文案或素材，但非室内生成仍处于 **Beta**，质量与一致性可能明显弱于室内，请按需评估风险。受理成功后返回 `WorldAsyncOperation`（仅含 `worldId`）。支持纯文案、单张图片或图文组合。若 `resources` 中含图片，最多允许 1 张（image：.jpg / .jpeg / .png / .webp。）。",
        "operationId": "generateWorld",
        "parameters": [
          {
            "name": "x-source",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "生成世界请求体。支持纯文案、单张图片或图文组合。至多 1 张图片（image：.jpg / .jpeg / .png / .webp。）。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/world_GenerateWorldRequest"
              },
              "examples": {
                "generateWorldRequest": {
                  "summary": "图文组合示例",
                  "description": "generateWorldRequest",
                  "value": {
                    "name": "客厅生成",
                    "cover": "https://cdn.example.com/cover/gen-cover.jpg",
                    "prompt": "现代简约风格客厅",
                    "resources": [
                      {
                        "url": "https://cdn.example.com/input/room.jpg",
                        "type": "image"
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "受理成功：返回 `WorldAsyncOperation`，含 `worldId`。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_WorldAsyncOperation"
                },
                "examples": {
                  "success": {
                    "summary": "创建受理成功",
                    "description": "success",
                    "value": {
                      "worldId": "B2c3D4e5F6"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "参数/请求体校验失败等业务错误（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "参数/请求体校验失败",
                    "description": "业务码 10001（PARAMS_INVALID）",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004（NOT_LOGGED_IN）",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 15,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createWorldClient } from '@manycore/aholo-sdk-world';\n\nconst world = createWorldClient({ region: 'cn' });\nconst { worldId } = await world.generations.create({\n  name: '森林小屋',\n  prompt: '森林中的现代风格小木屋',\n});\nconst detail = await world.waitFor(worldId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.world.WorldClient;\nimport com.manycoreapis.sdk.world.model.ReconstructionCreateParams;\nimport com.manycoreapis.sdk.world.model.GenerationCreateParams;\nimport com.manycoreapis.sdk.world.model.WorldListParams;\nimport com.manycoreapis.sdk.world.model.WorldAsyncOperation;\nimport com.manycoreapis.sdk.world.model.WorldDetail;\nimport com.manycoreapis.sdk.world.model.WorldPagedList;\n\nWorldClient world = WorldClient.create(AholoClientConfig.ofRegion(\"cn\"));\nWorldAsyncOperation op = world.generations().create(\n    GenerationCreateParams.builder()\n        .name(\"森林小屋\")\n        .prompt(\"森林中的现代风格小木屋\")\n        .build());\nWorldDetail detail = world.waitFor(op.worldId());"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_world import create_world_client\n\nworld = create_world_client(region='cn')\nop = world.generations.create(\n    name='森林小屋',\n    prompt='森林中的现代风格小木屋',\n)\ndetail = world.wait_for(op['worldId'])"
          }
        ]
      }
    },
    "/world/v1/{worldId}": {
      "get": {
        "tags": [
          "World"
        ],
        "summary": "查询世界详情",
        "description": "根据世界 id 查询详情。重建成功且产出可用时，响应中包含 splat（ply/spz）等重建产物的下载地址；若已完成 LOD 后处理，`assets.splats.urls.lodMetaPath` 将包含 LOD 分块元数据文件的下载地址。AI 生成（Spatial Gen）世界在全景图产出后，`assets.imagery.panoUrl` 返回全景图下载地址。",
        "operationId": "getWorldDetail",
        "parameters": [
          {
            "name": "worldId",
            "in": "path",
            "description": "世界 id（与创建接口成功响应 `WorldAsyncOperation.worldId` 一致）",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "A1b2C3d4E5"
          }
        ],
        "responses": {
          "200": {
            "description": "成功时响应体为世界详情对象。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_WorldDetail"
                },
                "examples": {
                  "reconstructionWorldDetail": {
                    "summary": "3D 重建世界详情",
                    "description": "重建成功，含 splats 与坐标系元数据，无 imagery。",
                    "value": {
                      "worldId": "A1b2C3d4E5",
                      "name": "客厅重建",
                      "cover": "https://cdn.example.com/cover/world-001.jpg",
                      "scene": "space",
                      "createTime": 1699339916000,
                      "updateTime": 1699340120000,
                      "status": "SUCCEEDED",
                      "progress": 1,
                      "assets": {
                        "splats": {
                          "urls": {
                            "plyPath": "https://cdn.example.com/output/world-001.ply",
                            "spzPath": "https://cdn.example.com/output/world-001.spz",
                            "lodMetaPath": "https://cdn.example.com/output/world-001-lod-meta.json"
                          }
                        },
                        "semanticsMetadata": {
                          "upAxis": "Z"
                        }
                      }
                    }
                  },
                  "generateWorldDetail": {
                    "summary": "AI 生成世界详情",
                    "description": "生成成功，含全景图 imagery.panoUrl 与 splats。",
                    "value": {
                      "worldId": "B2c3D4e5F6",
                      "name": "现代简约客厅",
                      "cover": "https://cdn.example.com/cover/world-gen-001.jpg",
                      "scene": "ai_gen",
                      "createTime": 1699339916000,
                      "updateTime": 1699340120000,
                      "status": "SUCCEEDED",
                      "progress": 1,
                      "assets": {
                        "imagery": {
                          "panoUrl": "https://cdn.example.com/output/world-gen-001-pano.jpg"
                        },
                        "splats": {
                          "urls": {
                            "plyPath": "https://cdn.example.com/output/world-gen-001.ply",
                            "spzPath": "https://cdn.example.com/output/world-gen-001.spz",
                            "lodMetaPath": "https://cdn.example.com/output/world-gen-001-lod-meta.json"
                          }
                        },
                        "semanticsMetadata": {
                          "upAxis": "Z"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "路径参数校验失败等业务错误（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "路径参数校验失败",
                    "description": "业务码 10001",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004（NOT_LOGGED_IN）",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "无访问权限（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "noPermission": {
                    "summary": "无权限查看",
                    "description": "业务码 12003",
                    "value": {
                      "code": 403,
                      "message": "no permission",
                      "status": "PERMISSION_DENIED",
                      "details": {
                        "reason": "BIZ_12003",
                        "domain": "api.aholo.cn",
                        "message": "no permission",
                        "metaData": {
                          "bizCode": "12003"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "世界不存在（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "projectNotExist": {
                    "summary": "世界（项目）不存在",
                    "description": "业务码 12001",
                    "value": {
                      "code": 404,
                      "message": "project not exist",
                      "status": "NOT_FOUND",
                      "details": {
                        "reason": "BIZ_12001",
                        "domain": "api.aholo.cn",
                        "message": "project not exist",
                        "metaData": {
                          "bizCode": "12001"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 20,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createWorldClient } from '@manycore/aholo-sdk-world';\n\nconst world = createWorldClient({ region: 'cn' });\nconst detail = await world.retrieve('A1b2C3d4E5');\nconsole.log(detail.status);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.world.WorldClient;\nimport com.manycoreapis.sdk.world.model.ReconstructionCreateParams;\nimport com.manycoreapis.sdk.world.model.GenerationCreateParams;\nimport com.manycoreapis.sdk.world.model.WorldListParams;\nimport com.manycoreapis.sdk.world.model.WorldAsyncOperation;\nimport com.manycoreapis.sdk.world.model.WorldDetail;\nimport com.manycoreapis.sdk.world.model.WorldPagedList;\n\nWorldClient world = WorldClient.create(AholoClientConfig.ofRegion(\"cn\"));\nWorldDetail detail = world.retrieve(\"A1b2C3d4E5\");\ndetail.status().ifPresent(System.out::println);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_world import create_world_client\n\nworld = create_world_client(region='cn')\ndetail = world.retrieve('A1b2C3d4E5')\nprint(detail.get('status'))"
          }
        ]
      }
    },
    "/world/v1/list": {
      "post": {
        "tags": [
          "World"
        ],
        "summary": "分页查询我的世界列表",
        "description": "分页查询当前账号下的 3DGS 世界列表。",
        "operationId": "getMyWorldList",
        "requestBody": {
          "description": "分页与筛选条件。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/world_WorldListQueryRequest"
              },
              "examples": {
                "listWorldRequest": {
                  "description": "示例：第一页、每页 20、按运行中与成功筛选",
                  "value": {
                    "pageNum": 0,
                    "pageSize": 20,
                    "statusList": [
                      "RUNNING",
                      "SUCCEEDED"
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时响应体为分页列表对象（含 `pageNum`、`pageSize`、列表项等）。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_WorldPagedList"
                },
                "examples": {
                  "success": {
                    "summary": "查询成功",
                    "description": "success",
                    "value": {
                      "pageNum": 0,
                      "pageSize": 20,
                      "count": 1,
                      "totalCount": 1,
                      "hasMore": false,
                      "result": [
                        {
                          "worldId": "A1b2C3d4E5",
                          "name": "客厅重建",
                          "cover": "https://cdn.example.com/cover/world-001.jpg",
                          "scene": "space",
                          "createTime": 1699339916000,
                          "updateTime": 1699340120000,
                          "status": "RUNNING",
                          "progress": 0.45
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "分页参数等校验失败（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "请求体/参数校验失败",
                    "description": "业务码 10001",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败（ApiError）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/world_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004（NOT_LOGGED_IN）",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 30,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createWorldClient } from '@manycore/aholo-sdk-world';\n\nconst world = createWorldClient({ region: 'cn' });\nconst page = await world.list({ pageNum: 1, pageSize: 20 });\npage.result?.forEach((w) => console.log(w.worldId, w.status));"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.world.WorldClient;\nimport com.manycoreapis.sdk.world.model.ReconstructionCreateParams;\nimport com.manycoreapis.sdk.world.model.GenerationCreateParams;\nimport com.manycoreapis.sdk.world.model.WorldListParams;\nimport com.manycoreapis.sdk.world.model.WorldAsyncOperation;\nimport com.manycoreapis.sdk.world.model.WorldDetail;\nimport com.manycoreapis.sdk.world.model.WorldPagedList;\n\nWorldClient world = WorldClient.create(AholoClientConfig.ofRegion(\"cn\"));\nWorldPagedList page = world.list(\n    WorldListParams.builder().pageNum(1).pageSize(20).build());\npage.result().ifPresent(items ->\n    items.forEach(w -> System.out.println(w.worldId() + \" \" + w.status())));"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_world import create_world_client\n\nworld = create_world_client(region='cn')\npage = world.list(page_num=1, page_size=20)\nfor w in page.get('result', []):\n    print(w.get('worldId'), w.get('status'))"
          }
        ]
      }
    },
    "/lux3d/v1/generate/multimodal-to-image/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建多模态单图生成任务",
        "description": "根据图片、文字提示词或图文组合创建异步单图生成任务，img 和 prompt 至少提供一个。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果图片 URL。\n",
        "operationId": "createMultimodalToImageTask",
        "requestBody": {
          "description": "多模态单图生成请求体，img 和 prompt 至少提供一个。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_MultimodalToImageRequest"
              },
              "examples": {
                "promptOnly": {
                  "summary": "纯文字生成单图",
                  "value": {
                    "prompt": "一把现代简约浅色原木餐椅，纯白背景"
                  }
                },
                "imageOnly": {
                  "summary": "使用参考图生成单图",
                  "value": {
                    "img": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg"
                  }
                },
                "imageAndPrompt": {
                  "summary": "按提示词修改参考图",
                  "value": {
                    "img": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg",
                    "prompt": "把椅子改成浅色原木材质，保持造型和视角"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功时返回任务 ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256174
                    }
                  },
                  "invalidInput": {
                    "summary": "img 和 prompt 均未提供",
                    "value": {
                      "f": null,
                      "c": "-1",
                      "m": "img or prompt is required",
                      "d": null
                    }
                  },
                  "concurrencyLimit": {
                    "summary": "生成任务并发已达上限",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "当前已有进行中的生成任务，请等待完成后再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 1,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.multimodalToImage.create({\n  prompt: '木椅产品图，白色背景',\n  img: 'https://example.com/object.jpg',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.multimodalToImage().create(\n    MultimodalToImageCreateParams.builder()\n        .prompt(\"木椅产品图，白色背景\")\n        .img(\"https://example.com/object.jpg\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.multimodal_to_image.create(\n    prompt='木椅产品图，白色背景',\n    img='https://example.com/object.jpg',\n)\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/generate/image-to-four-view/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建多模态四视图任务",
        "description": "根据图片、文字提示词或图文组合生成物体的四个视角，img 和 prompt 至少提供一个。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果。成功结果包含四张图片 URL，顺序为 FRONT_THREE_QUARTER、OPPOSITE_THREE_QUARTER、SIDE、BACK。\n",
        "operationId": "createImageToFourViewTask",
        "requestBody": {
          "description": "多模态四视图任务请求体。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_ImageToFourViewRequest"
              },
              "examples": {
                "promptOnly": {
                  "summary": "纯文字生成四视图",
                  "value": {
                    "prompt": "一把现代简约浅色原木餐椅"
                  }
                },
                "imageOnly": {
                  "summary": "使用单图生成四视图",
                  "value": {
                    "img": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg"
                  }
                },
                "imageAndPrompt": {
                  "summary": "使用参考图和提示词生成四视图",
                  "value": {
                    "img": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg",
                    "prompt": "把椅子改成浅色原木材质，保持造型和视角"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功时返回任务 ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256173
                    }
                  },
                  "invalidInput": {
                    "summary": "img 和 prompt 均未提供",
                    "value": {
                      "f": null,
                      "c": "-1",
                      "m": "img or prompt is required",
                      "d": null
                    }
                  },
                  "concurrencyLimit": {
                    "summary": "生成任务并发已达上限",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "当前已有进行中的生成任务，请等待完成后再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 2,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.imageToFourView.create({\n  img: 'https://example.com/object.jpg',\n  prompt: '产品四视图，白色背景',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.imageToFourView().create(\n    ImageToFourViewCreateParams.builder()\n        .img(\"https://example.com/object.jpg\")\n        .prompt(\"产品四视图，白色背景\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.image_to_four_view.create(\n    img='https://example.com/object.jpg',\n    prompt='产品四视图，白色背景',\n)\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/generate/img-to-3d/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建图生 3D 任务",
        "description": "根据一张或多张图片创建异步 3D 生成任务，可选择 G1 或 G1-Turbo。省略 version 时使用默认版本。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果。\n",
        "operationId": "createImgTo3dTask",
        "requestBody": {
          "description": "图生 3D 任务请求体。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_ImgTo3dRequest"
              },
              "examples": {
                "createTaskG1": {
                  "summary": "创建图生 3D 任务（推荐：G1）",
                  "value": {
                    "img": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg",
                    "version": "G1",
                    "faceCount": 300000,
                    "outputFormat": [
                      "zip",
                      "glb"
                    ]
                  }
                },
                "createTaskG1TurboMultiImage": {
                  "summary": "创建多图输入的图生 3D 任务（推荐：G1-Turbo）",
                  "value": {
                    "version": "G1-Turbo",
                    "imgs": [
                      "https://qhstaticssl.kujiale.com/image/png/1784775590866/multiview_input_1.png",
                      "https://qhstaticssl.kujiale.com/image/png/1784775591151/multiview_input_2.png"
                    ],
                    "outputFormat": [
                      "glb"
                    ],
                    "faceCount": 300000,
                    "enablePbr": true
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时返回任务ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256173
                    }
                  },
                  "concurrencyLimit": {
                    "summary": "生成任务并发已达上限",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "当前已有进行中的生成任务，请等待完成后再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 3,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.imgTo3d.create({\n  img: 'https://example.com/object.jpg',\n  version: 'G1',\n});\nconst result = await lux3d.tasks.waitFor(taskId);\nconsole.log(result.outputs[0]?.content);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.imgTo3d().create(\n    ImgTo3dCreateParams.builder()\n        .img(\"https://example.com/object.jpg\")\n        .version(\"G1\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);\nresult.outputs().forEach(o -> o.content().ifPresent(System.out::println));"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.img_to_3d.create(img='https://example.com/object.jpg', version='G1')\nresult = lux3d.tasks.wait_for(task_id)\nprint(result['outputs'][0]['content'])"
          }
        ]
      }
    },
    "/lux3d/v1/generate/text-to-3d/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建文生 3D 任务",
        "description": "根据文本和一张可选参考图片创建异步 3D 生成任务，可选择 G1 或 G1-Turbo。省略 version 时使用默认版本。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果。\n",
        "operationId": "createTextTo3dTask",
        "requestBody": {
          "description": "文生 3D 任务请求体。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_TextTo3dRequest"
              },
              "examples": {
                "textOnlyG1": {
                  "summary": "纯文本生成（推荐：G1）",
                  "value": {
                    "prompt": "生成一个高质量的3D木椅模型",
                    "style": "photorealistic",
                    "version": "G1",
                    "faceCount": 300000,
                    "outputFormat": [
                      "zip",
                      "glb"
                    ]
                  }
                },
                "textWithImage": {
                  "summary": "文本+参考图生成（推荐：G1）",
                  "value": {
                    "prompt": "生成一个高质量的3D木椅模型",
                    "style": "photorealistic",
                    "img": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg",
                    "version": "G1"
                  }
                },
                "textG1ZipGlb": {
                  "summary": "G1 文生 3D（ZIP + GLB）",
                  "value": {
                    "prompt": "生成一把现代木质餐椅",
                    "style": "photorealistic",
                    "version": "G1",
                    "outputFormat": [
                      "zip",
                      "glb"
                    ],
                    "faceCount": 300000
                  }
                },
                "textG1TurboPly": {
                  "summary": "G1-Turbo 文生 3D（仅 PLY）",
                  "value": {
                    "prompt": "生成一把现代木质餐椅",
                    "style": "photorealistic",
                    "version": "G1-Turbo",
                    "outputFormat": [
                      "ply"
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时返回任务ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256173
                    }
                  },
                  "concurrencyLimit": {
                    "summary": "生成任务并发已达上限",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "当前已有进行中的生成任务，请等待完成后再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 4,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.textTo3d.create({\n  prompt: '带雕花腿的木椅',\n  version: 'G1',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.textTo3d().create(\n    TextTo3dCreateParams.builder()\n        .prompt(\"带雕花腿的木椅\")\n        .version(\"G1\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.text_to_3d.create(prompt='带雕花腿的木椅', version='G1')\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/generate/material-transfer/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建模型材质重绘任务",
        "description": "根据材质参考图片和 GLB 模型创建异步材质重绘任务。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果。\n",
        "operationId": "createMaterialTransferTask",
        "requestBody": {
          "description": "模型材质重绘任务请求体。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_MaterialTransferRequest"
              },
              "examples": {
                "createTaskDefault": {
                  "summary": "创建材质重绘任务",
                  "value": {
                    "img": "https://qhstaticssl.kujiale.com/image/png/1784776951878/material_transfer_input.png",
                    "meshUrl": "https://qhstaticssl.kujiale.com/application/octetstream/1784776896628/material_transfer_model.glb",
                    "version": "v3.0-standard"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时返回任务ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256173
                    }
                  },
                  "concurrencyLimit": {
                    "summary": "生成任务并发已达上限",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "当前已有进行中的生成任务，请等待完成后再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 5,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.materialTransfer.create({\n  img: 'https://example.com/material.jpg',\n  meshUrl: 'https://example.com/model.glb',\n  version: 'v3.0-standard',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.materialTransfer().create(\n    MaterialTransferCreateParams.builder()\n        .img(\"https://example.com/material.jpg\")\n        .meshUrl(\"https://example.com/model.glb\")\n        .version(\"v3.0-standard\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.material_transfer.create(\n    img='https://example.com/material.jpg',\n    mesh_url='https://example.com/model.glb',\n    version='v3.0-standard',\n)\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/part-split/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建部件拆分任务",
        "description": "根据一个可由服务端访问的 GLB 模型 URL 创建异步部件拆分任务。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和包含拆分结果的 GLB 文件 URL。\n若当前账号已有同类任务进行中，本次请求不会创建任务，请稍后重试。\n",
        "operationId": "createPartSplitTask",
        "requestBody": {
          "description": "部件拆分任务请求体。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_PartSplitRequest"
              },
              "examples": {
                "createTask": {
                  "summary": "创建部件拆分任务",
                  "value": {
                    "glbUrl": "https://qhstaticssl.kujiale.com/model/gltfbinary/1790144390549/14B82261CD6DF53FA6B406240E20CB2C.glb"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功时返回任务 ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256174
                    }
                  },
                  "temporarilyUnavailable": {
                    "summary": "暂时无法创建任务",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "服务繁忙，请稍候再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 6,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.partSplit.create({\n  glbUrl: 'https://example.com/model.glb',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.partSplit().create(\n    PartSplitCreateParams.builder()\n        .glbUrl(\"https://example.com/model.glb\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.part_split.create(glb_url='https://example.com/model.glb')\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/multi-format-export/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建多格式导出任务",
        "description": "根据 ZIP 或 GLB 模型 URL 创建异步格式导出任务，可选择一个或多个支持的目标格式。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果。\n",
        "operationId": "createMultiFormatExportTask",
        "requestBody": {
          "description": "多格式导出任务请求体。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_MultiFormatExportRequest"
              },
              "examples": {
                "createTaskDefault": {
                  "summary": "创建多格式导出任务（glb 输入，导出 usdz）",
                  "value": {
                    "modelUrl": "https://qhstaticssl.kujiale.com/application/octetstream/1784776896628/model.glb",
                    "outputFormat": [
                      "usdz"
                    ]
                  }
                },
                "createTaskWithPrintFormats": {
                  "summary": "创建多格式导出任务（glb 输入，导出 STL 和 3MF）",
                  "value": {
                    "modelUrl": "https://qhstaticssl.kujiale.com/application/octetstream/1784776896628/model.glb",
                    "outputFormat": [
                      "stl",
                      "3mf"
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "成功时返回任务ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 1256173
                    }
                  },
                  "glbNoFormat": {
                    "summary": "glb 输入未选择任何导出格式",
                    "value": {
                      "f": null,
                      "c": "-1",
                      "m": "glb input requires at least one export format in outputFormat (usdz/obj_zip/fbx_zip/stl/3mf)",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 7,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.multiFormatExport.create({\n  modelUrl: 'https://example.com/model.glb',\n  outputFormat: ['usdz', 'obj_zip', 'stl'],\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.multiFormatExport().create(\n    MultiFormatExportCreateParams.builder()\n        .modelUrl(\"https://example.com/model.glb\")\n        .outputFormat(java.util.Arrays.asList(\"usdz\", \"obj_zip\", \"stl\"))\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.multi_format_export.create(\n    model_url='https://example.com/model.glb',\n    output_format=['usdz', 'obj_zip', 'stl'],\n)\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/articulation-animation/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建模型关节化与动画任务",
        "description": "根据 GLB 模型 URL 和运动提示词创建异步关节化与动画任务。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和结果文件 URL。\n",
        "operationId": "createArticulationAnimationTask",
        "requestBody": {
          "description": "模型关节化与动画请求。glbUrl 和 prompt 均必填，不接受其他字段。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_ArticulationAnimationRequest"
              },
              "examples": {
                "glbAndPrompt": {
                  "summary": "GLB 模型与运动提示词",
                  "value": {
                    "glbUrl": "https://assets.aholo3d.cn/examples/cubely/joint-motion/target-model.glb",
                    "prompt": "保持底座固定，为盖子添加旋转关节，让盖子缓慢打开和闭合。"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功时返回任务 ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": 3725821
                    }
                  },
                  "invalidInput": {
                    "summary": "GLB 地址无效或提示词为空",
                    "value": {
                      "f": null,
                      "c": "-1",
                      "m": "glbUrl must be an HTTP(S) URL and prompt is required",
                      "d": null
                    }
                  },
                  "concurrencyLimit": {
                    "summary": "生成任务并发已达上限",
                    "value": {
                      "f": null,
                      "c": "GENERATION_CONCURRENCY_LIMIT_EXCEEDED",
                      "m": "当前已有进行中的生成任务，请等待完成后再试",
                      "d": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "JSON 格式错误或包含不支持的请求字段。"
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 8,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.articulationAnimation.create({\n  glbUrl: 'https://example.com/model.glb',\n  prompt: '保持底座固定，让盖子缓慢打开和闭合',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.articulationAnimation().create(\n    ArticulationAnimationCreateParams.builder()\n        .glbUrl(\"https://example.com/model.glb\")\n        .prompt(\"保持底座固定，让盖子缓慢打开和闭合\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.articulation_animation.create(\n    glb_url='https://example.com/model.glb',\n    prompt='保持底座固定，让盖子缓慢打开和闭合',\n)\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/animations/rig/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建数字人自动绑骨任务",
        "description": "根据数字人 GLB 模型创建异步自动绑骨任务。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和已绑骨 GLB 文件 URL。\n",
        "operationId": "createHumanoidAutoRigTask",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_HumanoidAutoRigRequest"
              },
              "example": {
                "modelUrl": "https://example.com/model.glb"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "请求成功（c=\"0\"）后，d 返回任务 ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "example": {
                  "f": null,
                  "c": "0",
                  "m": "",
                  "d": 3742500
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 9,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.humanoidAutoRig.create({\n  modelUrl: 'https://example.com/human.glb',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.humanoidAutoRig().create(\n    HumanoidAutoRigCreateParams.builder()\n        .modelUrl(\"https://example.com/human.glb\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.humanoid_auto_rig.create(model_url='https://example.com/human.glb')\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/animations/retarget/task/create": {
      "post": {
        "tags": [
          "Lux3D"
        ],
        "summary": "创建数字人动画重定向任务",
        "description": "根据已绑骨模型和所选动作创建异步动画重定向任务，支持逐动作输出或合并输出，可选择 GLB 或 FBX 格式。请求成功后返回任务 ID（taskid），可通过任务查询接口获取状态和动作结果。\n",
        "operationId": "createHumanoidAnimationRetargetTask",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/lux3d_HumanoidAnimationRetargetRequest"
              },
              "example": {
                "rigModelUrl": "https://qhstaticssl.kujiale.com/application/octetstream/1790240555913/rigModel.glb",
                "animationIds": [
                  "Dance_Loop",
                  "Swim_Fwd_Loop"
                ],
                "animationOutputMode": "separate",
                "outFormat": "glb",
                "animateInPlace": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "请求成功（c=\"0\"）后，d 返回任务 ID。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskCreateResponse"
                },
                "example": {
                  "f": null,
                  "c": "0",
                  "m": "",
                  "d": 3742500
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 10,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst taskId = await lux3d.humanoidAnimationRetarget.create({\n  rigModelUrl: 'https://example.com/rig.glb',\n  animationIds: ['Idle_Loop', 'Walk_Loop'],\n  outFormat: 'glb',\n});\nconst result = await lux3d.tasks.waitFor(taskId);"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nlong taskId = lux3d.humanoidAnimationRetarget().create(\n    HumanoidAnimationRetargetCreateParams.builder()\n        .rigModelUrl(\"https://example.com/rig.glb\")\n        .animationIds(java.util.Arrays.asList(\"Idle_Loop\", \"Walk_Loop\"))\n        .outFormat(\"glb\")\n        .build());\nTaskResult result = lux3d.tasks().waitFor(taskId);"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\ntask_id = lux3d.humanoid_animation_retarget.create(\n    rig_model_url='https://example.com/rig.glb',\n    animation_ids=['Idle_Loop', 'Walk_Loop'],\n    out_format='glb',\n)\nresult = lux3d.tasks.wait_for(task_id)"
          }
        ]
      }
    },
    "/lux3d/v1/generate/task/get": {
      "get": {
        "tags": [
          "Lux3D"
        ],
        "summary": "查询生成任务",
        "description": "根据任务 ID 查询任务状态和结果，仅支持查询当前认证账号创建的任务。结果 URL 有效期为 2 小时。\n\n`c=\"0\"` 表示查询成功，任务是否完成由 `d.status` 判断：0-初始化，1-运行中，3-成功，4-失败，6-已取消。状态为 0 或 1 时继续查询，任务完成后从 `d.outputs` 读取结果；运行中的任务也可能返回部分已生成结果。\n\n不同任务的结果格式如下。表中的 URL 或 JSON 字符串均位于输出项的 `content` 字段。\n\n| 任务类型 | 结果格式 |\n| --- | --- |\n| 多模态单图生成 | 一个结果图片 URL。 |\n| 多模态四视图 | 包含四张图片 URL 的 JSON 数组字符串，顺序为 FRONT_THREE_QUARTER、OPPOSITE_THREE_QUARTER、SIDE、BACK。 |\n| G1 图生 / 文生 3D | 按 ZIP、GLB 顺序返回文件 URL；请求 PLY 时额外返回 PLY。 |\n| G1-Turbo 图生 / 文生 3D | 返回指定格式的文件 URL；未指定格式或传空数组时返回 ZIP。 |\n| 模型材质重绘 | 按 ZIP、GLB、USDZ、OBJ ZIP、FBX ZIP 顺序返回文件 URL。 |\n| 多格式导出 | 按 ZIP、GLB、USDZ、OBJ ZIP、FBX ZIP、STL、3MF 顺序返回文件 URL。 |\n| 部件拆分 | 一个包含拆分结果的 GLB 文件 URL。 |\n| 模型关节化与动画 | `d.outputs[0].content` 为结果文件 URL，文件格式以实际结果为准，不固定为 ZIP。 |\n| 数字人自动绑骨 | 已绑骨 GLB 文件 URL；失败时可能返回包含 `error` 的 JSON 字符串。 |\n| 数字人动画重定向 | 包含 `actions` 的 JSON 字符串，列出各动作的结果 URL 或错误信息。 |\n\n未请求的可选格式可能返回 `NOT_REQUESTED`，该值不是文件 URL。对于 JSON 字符串结果，需要解析 `content` 后再读取其中的字段。\n",
        "operationId": "getTask",
        "parameters": [
          {
            "name": "taskid",
            "in": "query",
            "description": "任务ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "example": 1389513
          }
        ],
        "responses": {
          "200": {
            "description": "成功时返回任务状态和结果。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskQueryResponse"
                },
                "examples": {
                  "humanoidRigSuccess": {
                    "summary": "数字人绑骨成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3742500,
                        "status": 3,
                        "outputs": [
                          {
                            "content": "https://example.com/rig.glb"
                          }
                        ]
                      }
                    }
                  },
                  "humanoidRigFailure": {
                    "summary": "模型不适合自动绑骨",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3742500,
                        "status": 4,
                        "outputs": [
                          {
                            "content": "{\"error\": {\"code\": \"MODEL_NOT_RIGGABLE\", \"message\": \"Model does not meet rigging requirements\"}}"
                          }
                        ]
                      }
                    }
                  },
                  "humanoidRetargetGlbSuccess": {
                    "summary": "GLB 动作生成成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3742500,
                        "status": 3,
                        "outputs": [
                          {
                            "content": "{\"actions\":[{\"animation_id\":\"Dance_Loop\",\"status\":\"success\",\"animationGlbUrl\":\"https://example.com/dance.glb\"}]}"
                          }
                        ]
                      }
                    }
                  },
                  "humanoidRetargetAllFailed": {
                    "summary": "所有动作失败",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3742500,
                        "status": 4,
                        "outputs": [
                          {
                            "content": "{\"actions\":[{\"animation_id\":\"Swim_Fwd_Loop\",\"status\":\"failed\",\"error\":{\"code\":\"ANIMATION_RETARGET_FAILED\",\"message\":\"Action delivery failed: animation retarget failed\"}}]}"
                          }
                        ]
                      }
                    }
                  },
                  "humanoidRetargetFbxSuccess": {
                    "summary": "FBX 动作交付成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3742500,
                        "status": 3,
                        "outputs": [
                          {
                            "content": "{\"actions\":[{\"animation_id\":\"Dance_Loop\",\"status\":\"success\",\"fbxUrl\":\"https://example.com/dance.fbx\"}]}"
                          }
                        ]
                      }
                    }
                  },
                  "running": {
                    "summary": "任务进行中",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389513,
                        "status": 1
                      }
                    }
                  },
                  "successMaterialTransferAllFormats": {
                    "summary": "材质重绘成功（全部格式）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389513,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/output/result.zip"
                          },
                          {
                            "content": "https://cdn.example.com/output/textured.glb"
                          },
                          {
                            "content": "https://cdn.example.com/output/RealityKitPreview.usdz"
                          },
                          {
                            "content": "https://cos.example.com/lux3d/xxx/model_obj.zip"
                          },
                          {
                            "content": "https://cos.example.com/lux3d/xxx/model_fbx.zip"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successMaterialTransferPartialFormats": {
                    "summary": "材质重绘成功（ZIP、GLB、USDZ）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389514,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/output/result.zip"
                          },
                          {
                            "content": "https://cdn.example.com/output/textured.glb"
                          },
                          {
                            "content": "https://cdn.example.com/output/RealityKitPreview.usdz"
                          },
                          {
                            "content": "NOT_REQUESTED"
                          },
                          {
                            "content": "NOT_REQUESTED"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successMultiFormatExport": {
                    "summary": "多格式导出成功（全部格式）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389518,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/input/source.zip"
                          },
                          {
                            "content": "https://cdn.example.com/output/model.glb"
                          },
                          {
                            "content": "https://cdn.example.com/output/RealityKitPreview.usdz"
                          },
                          {
                            "content": "https://cos.example.com/lux3d/xxx/model_obj.zip"
                          },
                          {
                            "content": "https://cos.example.com/lux3d/xxx/model_fbx.zip"
                          },
                          {
                            "content": "https://cdn.example.com/output/model.stl"
                          },
                          {
                            "content": "https://cdn.example.com/output/model.3mf"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successG1Base": {
                    "summary": "G1 成功（ZIP、GLB）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389515,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/output/results.zip"
                          },
                          {
                            "content": "https://cdn.example.com/output/result.glb"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successG1WithPly": {
                    "summary": "G1 成功（ZIP、GLB、PLY）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389516,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/output/results.zip"
                          },
                          {
                            "content": "https://cdn.example.com/output/result.glb"
                          },
                          {
                            "content": "https://cdn.example.com/output/result.ply"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successG1TurboPly": {
                    "summary": "G1-Turbo 成功（仅 PLY）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389517,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/output/result.ply"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successMultimodalToImage": {
                    "summary": "多模态单图生成成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 2696732,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/multimodal-to-image/result.png"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successArticulationAnimationZIP": {
                    "summary": "关节化与动画成功（ZIP 示例）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3725821,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/articulation-animation/result.zip"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successArticulationAnimationGLB": {
                    "summary": "关节化与动画成功（GLB 示例）",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 3725821,
                        "outputs": [
                          {
                            "content": "https://cdn.example.com/articulation-animation/result.glb"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successImageToFourView": {
                    "summary": "多模态四视图生成成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 2696733,
                        "outputs": [
                          {
                            "content": "[\"https://cdn.example.com/four-view/front-three-quarter.png\",\"https://cdn.example.com/four-view/opposite-three-quarter.png\",\"https://cdn.example.com/four-view/side.png\",\"https://cdn.example.com/four-view/back.png\"]"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "successPartSplit": {
                    "summary": "部件拆分成功",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 2696734,
                        "outputs": [
                          {
                            "content": "https://qhsmodel.kujiale.com/glbPartsReconstructResult/NKZXG2IKTIHXGAABAAAAABQ8.glb"
                          }
                        ],
                        "status": 3
                      }
                    }
                  },
                  "failed": {
                    "summary": "任务失败",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "taskId": 1389513,
                        "status": 4
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskQueryResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskQueryResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 11,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst result = await lux3d.tasks.retrieve(taskId);\nconsole.log(result.status, result.outputs);\n// 或 await lux3d.tasks.waitFor(taskId) 轮询至成功"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nTaskResult result = lux3d.tasks().retrieve(taskId);\nSystem.out.println(result.status());\n// or lux3d.tasks().waitFor(taskId) 轮询至成功"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\nresult = lux3d.tasks.retrieve(task_id)\nprint(result.get('status'), result.get('outputs'))\n# 或 lux3d.tasks.wait_for(task_id) 轮询至成功"
          }
        ]
      }
    },
    "/lux3d/v1/generate/task/list": {
      "get": {
        "tags": [
          "Lux3D"
        ],
        "summary": "分页查询生成记录",
        "description": "分页查询当前认证账号创建的任务，可按状态和创建时间筛选。\n",
        "operationId": "listTasks",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "pagesize",
            "in": "query",
            "description": "每页数量，范围 1-100",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "用于筛选的任务状态：0-初始化，1-运行中，3-成功，4-失败。省略时查询全部状态，结果中仍可能出现已取消状态 6。",
            "schema": {
              "type": "integer",
              "enum": [
                0,
                1,
                3,
                4
              ]
            }
          },
          {
            "name": "starttime",
            "in": "query",
            "description": "创建时间起点，包含边界；Unix 毫秒时间戳",
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "endtime",
            "in": "query",
            "description": "创建时间终点，不包含边界；Unix 毫秒时间戳",
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "返回生成记录分页数据。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskListResponse"
                },
                "examples": {
                  "withData": {
                    "summary": "有数据",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "items": [
                          {
                            "taskId": 2667998,
                            "status": 3,
                            "created": 1786591762000,
                            "lastModified": 1786592088000
                          }
                        ],
                        "total": 1,
                        "page": 1,
                        "pageSize": 20
                      }
                    }
                  },
                  "noData": {
                    "summary": "无数据",
                    "value": {
                      "f": null,
                      "c": "0",
                      "m": "",
                      "d": {
                        "items": [],
                        "total": 0,
                        "page": 1,
                        "pageSize": 20
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization，鉴权失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskListResponse"
                }
              }
            }
          },
          "500": {
            "description": "服务端内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/lux3d_TaskListResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 12,
        "x-codeSamples": [
          {
            "lang": "TypeScript",
            "label": "Aholo SDK（TypeScript）",
            "source": "import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';\n\nconst lux3d = createLux3dClient({ region: 'cn' });\nconst page = await lux3d.tasks.list({ page: 1, pageSize: 20, status: 3 });\npage.items.forEach((task) => console.log(task.taskId, task.status));"
          },
          {
            "lang": "Java",
            "label": "Aholo SDK（Java）",
            "source": "import com.manycoreapis.sdk.core.AholoClientConfig;\nimport java.nio.file.Paths;\nimport com.manycoreapis.sdk.lux3d.Lux3dClient;\nimport com.manycoreapis.sdk.lux3d.model.ImageToFourViewCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultimodalToImageCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ImgTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TextTo3dCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MaterialTransferCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.ArticulationAnimationCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAnimationRetargetCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.HumanoidAutoRigCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.MultiFormatExportCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.PartSplitCreateParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskListParams;\nimport com.manycoreapis.sdk.lux3d.model.TaskPagedList;\nimport com.manycoreapis.sdk.lux3d.model.TaskResult;\n\nLux3dClient lux3d = Lux3dClient.create(AholoClientConfig.ofRegion(\"cn\"));\nTaskPagedList page = lux3d.tasks().list(\n    TaskListParams.builder().page(1).pageSize(20).status(3).build());\npage.items().forEach(task ->\n    System.out.println(task.taskId() + \" \" + task.status()));"
          },
          {
            "lang": "Python",
            "label": "Aholo SDK（Python）",
            "source": "from manycore.aholo_sdk_lux3d import create_lux3d_client\n\nlux3d = create_lux3d_client(region='cn')\npage = lux3d.tasks.list(page=1, page_size=20, status=3)\nfor task in page['items']:\n    print(task['taskId'], task['status'])"
          }
        ]
      }
    },
    "/rendercloud/v1/jobs": {
      "post": {
        "tags": [
          "RenderCloud"
        ],
        "summary": "提交或轮询 OpenUSD 离线渲染任务",
        "description": "提交 OpenUSD 离线渲染任务或轮询任务状态。\n\n## 提交模式\n\n当请求中 `operationId` 为空时，提交新任务。需要提供 `requestId` 和\nBase64 编码后的 `usdContent`。出图分辨率从 OpenUSD `RenderSettings.resolution`\n读取，也兼容 Camera 节点上的 `resolution`；宽高必须为正数，且任一边不能超过\n服务端配置上限，默认上限为 4500 像素。\n\n服务端返回 HTTP 202 + `{operationId, done:false}`，`operationId` 即任务 ID。\n\n`requestId` 由调用方生成，用于请求追踪和记录；服务端对同一用户同一 `requestId` 做 1 分钟幂等保护。\n若同一用户在 1 分钟内重复提交相同 `requestId`，接口返回 409 `ALREADY_EXISTS`。\n\n## 轮询模式\n\n当请求中 `operationId` 非空时，轮询该任务状态。轮询仍调用同一个 POST 端点。\n\n- 处理中：`done=false`\n- 完成：`done=true + result.taskId/resultUrl`\n- 失败：`done=true + error`\n\n## 渲染约束\n\n该接口不接收渲染模板类型等服务端参数。服务端会按 OpenUSD 内容和分辨率选择固定离线渲染链路。\n\n## REST 响应状态\n\n| HTTP 状态码 | 场景 | 响应说明 |\n|-----------|------|---------|\n| `202` | 提交模式 | 任务已提交，返回 `operationId` 用于后续轮询 |\n| `200` | 轮询模式 | 返回当前 `Operation` 状态；完成时包含 `resultUrl` |\n| `400` | 参数错误 | 缺少 `requestId`、`usdContent`、OpenUSD 分辨率缺失或非法，Base64 非法，或 OpenUSD 解析失败 |\n| `404` | 资源不存在 | `operationId` 对应任务不存在 |\n| `409` | 重复请求 | 同一用户同一 `requestId` 在 1 分钟内重复提交 |\n| `429` | 请求限流 | 用户维度离线渲染频率超过限制 |\n| `500` | 服务异常 | 任务创建、转换或渲染链路异常 |\n",
        "operationId": "runRenderCloudOfflineJob",
        "requestBody": {
          "description": "离线渲染提交或轮询请求体。提交时传 `requestId`、`usdContent`；轮询时仅传 `operationId`。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/rendercloud_OfflineRenderSubmitRequest"
                  },
                  {
                    "$ref": "#/components/schemas/rendercloud_OperationPollRequest"
                  }
                ]
              },
              "examples": {
                "submit": {
                  "summary": "提交离线渲染任务",
                  "description": "使用 OpenUSD 内容创建离线渲染任务，分辨率从 OpenUSD resolution 读取。",
                  "value": {
                    "requestId": "render-req-20260515-0001",
                    "usdContent": "I3VzZGEgMS4wCg=="
                  }
                },
                "poll": {
                  "summary": "轮询离线渲染结果",
                  "description": "使用提交响应返回的 `operationId` 查询任务状态或结果。",
                  "value": {
                    "operationId": "1305220918472257536"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "当前离线渲染操作状态。",
            "content": {
              "application/+json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/rendercloud_OfflineRenderProcessingOperation"
                    },
                    {
                      "$ref": "#/components/schemas/rendercloud_OfflineRenderSuccessOperation"
                    },
                    {
                      "$ref": "#/components/schemas/rendercloud_OperationError"
                    }
                  ]
                },
                "examples": {
                  "processing": {
                    "summary": "任务处理中",
                    "description": "离线渲染任务仍在处理中。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": false,
                      "result": null,
                      "error": null
                    }
                  },
                  "success": {
                    "summary": "渲染成功",
                    "description": "离线渲染任务完成，返回结果图片地址。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": true,
                      "result": {
                        "taskId": "1305220918472257536",
                        "resultUrl": "https://example.com/render/result.png"
                      },
                      "error": null
                    }
                  },
                  "failed": {
                    "summary": "渲染失败",
                    "description": "离线渲染任务失败，返回错误信息。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": true,
                      "result": null,
                      "error": {
                        "code": 500,
                        "message": "code: INTERNAL, details: ErrorDetails(reason=INTERNAL_ERROR, message=null, domain=render, metaData=null)",
                        "status": "INTERNAL",
                        "details": {
                          "reason": "INTERNAL_ERROR",
                          "domain": "render"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "202": {
            "description": "离线渲染任务已受理，仍在处理中。",
            "content": {
              "application/+json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_OfflineRenderProcessingOperation"
                },
                "examples": {
                  "processing": {
                    "summary": "任务处理中",
                    "description": "离线渲染任务已创建，但尚未完成。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": false,
                      "result": null,
                      "error": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/rendercloud_BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/rendercloud_NotFound"
          },
          "409": {
            "$ref": "#/components/responses/rendercloud_Conflict"
          },
          "429": {
            "$ref": "#/components/responses/rendercloud_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/rendercloud_InternalServerError"
          }
        },
        "x-scalar-order": 3
      }
    },
    "/rendercloud/v1/streams": {
      "post": {
        "tags": [
          "RenderCloud"
        ],
        "summary": "创建或轮询 OpenUSD 实时渲染流",
        "description": "创建新的实时渲染会话或轮询已有会话状态。\n\n## 提交模式\n\n当请求中 `operationId` 为空时，创建新会话。需要提供 `requestId` 和 `usdContent`。\n\n可选的 `settings.autoEnhanceAI` 用于启用 AI 增强。未传或传 `false` 时不启用。\n\n返回 HTTP 202 + `{operationId, done:false}`。返回的 `operationId` 即 `sessionId`。\n\n## 轮询模式\n\n当请求中 `operationId` 非空时，轮询该会话的状态。轮询间隔建议 2s，超时 120s。\n\n当 `status` 为 `ACTIVE` 时，返回的 `result` 中包含 `host`、`nodeId`、`streamId`、`token` 四个字段，\n用于建立 WebSocket Streaming 连接。\n\n## REST 响应状态\n\n| HTTP 状态码 | 场景 | 响应说明 |\n|-----------|------|---------|\n| `202` | 提交模式 | 会话创建中，返回 `operationId` 用于后续轮询 |\n| `200` | 轮询模式 | 返回当前 `Operation` 状态；处理中为 `done=false`，完成为 `done=true + result`，失败为 `done=true + error` |\n| `400` | 参数错误 | 请求体缺少必要字段或字段无效 |\n| `404` | 资源不存在 | `operationId` 或会话不存在 |\n| `429` | 请求限流 | 请求频率超过限制 |\n| `500` | 服务异常 | 服务端内部错误 |\n\n## WebSocket Streaming 连接协议\n\n### 连接 URL\n\n```\nwss://{host}/streaming/ws/session?nid={encodeURIComponent(nodeId)}&token={encodeURIComponent(token)}\n```\n\n创建 WebSocket 时必须设置 `ws.binaryType = 'blob'`，否则图片无法以 Blob 接收。\n\n### 握手协议\n\nWebSocket `onopen` 触发后立即发送：\n\n```json\n{\"type\":3,\"slaveInit\":{\"masterStreamingId\":\"{streamId}\",\"receiveImage\":true}}\n```\n\n| 字段 | 值 | 说明 |\n|------|-----|------|\n| type | 固定 `3` | 标识 slave 初始化消息 |\n| slaveInit.masterStreamingId | `{streamId}` | 来自本接口返回的 streamId |\n| slaveInit.receiveImage | 固定 `true` | 接收渲染图片 |\n\n### 服务端消息（Server -> Client）\n\n**类型 A：JSON 状态消息（`typeof event.data === 'string'`）**\n\n消息结构：\n\n```json\n{\"code\":\"0\",\"desc\":\"初始化成功\",\"streamId\":\"...\",\"timestamp\":0,\"queueInfo\":{\"queueSize\":0,\"currentQueuePosition\":0}}\n```\n\n状态码：\n\n| code | 含义 | 连接状态变更 |\n|------|------|-------------|\n| `\"0\"` | 初始化成功 | 进入 Success，渲染就绪 |\n| `\"1000\"` | 节点满载 | 进入 Error |\n| `\"1001\"` | 初始化失败 | 进入 Error |\n| `\"1003\"` | Slave 超限 | 进入 SlaveExceeded |\n| `\"2001\"` | 引擎渲染错误 | 状态不变，仅触发渲染失败回调，连接仍存活 |\n| `\"2002\"` | 引擎进程错误 | 状态不变，仅触发渲染失败回调，连接仍存活 |\n\n`2001` / `2002` 是渲染级错误，连接仍存活。不修改连接状态。\n\n**类型 B：二进制图片消息（`event.data instanceof Blob`）**\n\nBlob 为 JPEG 格式。使用 `FileReader.readAsDataURL(blob)` 转换为 base64 Data URL 后设置 `<img>` src。\n\n### 连接生命周期\n\n| 状态 | 触发条件 |\n|------|---------|\n| Closed | 未连接 / 已断开 |\n| BeforeConnection | `new WebSocket(url)` 已创建 |\n| Booting | `onopen` 已触发，握手已发送 |\n| Queue | 排队中，服务端推送 |\n| Success | code=`0`，渲染就绪 |\n| Error | code=`1000` / `1001` 等 |\n| Sleep | 长时间无操作休眠 |\n| RenderStart | 渲染开始 |\n| EquityDone | 快速出图完成 |\n| SlaveClosed | 服务端关闭，close code=`4003` |\n| SlaveExceeded | code=`1003` |\n| KESceneFinished | KE 场景完成 |\n\n### 关闭连接\n\n| close code | 来源 | 含义 |\n|-----------|------|------|\n| `4003` | 服务端 | 服务端关闭所有 slave 连接 |\n| 其他 | - | 一般关闭 / 网络异常 |\n\n关闭 WebSocket 后需另行调用 DELETE 接口结束服务端会话。\n\n### 常见陷阱\n\n1. 未设置 `ws.binaryType = 'blob'`：必须设置，否则图片不是 Blob。\n2. `2001` / `2002` 被当成连接断开：这两个状态仅表示渲染失败回调，不改连接状态。\n3. 先 REST 后 WS 关闭：应先 `ws.close()`，再调用 DELETE API。\n4. 图片 Blob 无异常处理：`FileReader` 建议使用 Promise + try/catch。\n5. URI 参数未编码：`nodeId` 和 `token` 需要使用 `encodeURIComponent` 编码。\n",
        "operationId": "createRenderCloudRealtimeStream",
        "requestBody": {
          "description": "实时渲染流创建或轮询请求体。创建时传 `requestId`、`usdContent`，可选传 `settings`（当前支持 `autoEnhanceAI`）；轮询时仅传 `operationId`。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/rendercloud_RealtimeSessionSubmitRequest"
                  },
                  {
                    "$ref": "#/components/schemas/rendercloud_OperationPollRequest"
                  }
                ]
              },
              "examples": {
                "submit": {
                  "summary": "创建实时渲染流",
                  "description": "使用 OpenUSD 内容创建启用 AI 增强的渲染流。",
                  "value": {
                    "requestId": "stream-req-20260515-0001",
                    "usdContent": "I3VzZGEgMS4wCg==",
                    "settings": {
                      "autoEnhanceAI": true
                    }
                  }
                },
                "poll": {
                  "summary": "轮询实时渲染流创建结果",
                  "description": "使用创建响应返回的 `operationId` 查询实时渲染流状态。",
                  "value": {
                    "operationId": "1305220918472257536"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "会话轮询结果（status=ACTIVE 时 result 包含 WebSocket 连接参数）。",
            "content": {
              "application/+json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/rendercloud_RealtimeSessionProcessingOperation"
                    },
                    {
                      "$ref": "#/components/schemas/rendercloud_RealtimeSessionSuccessOperation"
                    },
                    {
                      "$ref": "#/components/schemas/rendercloud_OperationError"
                    }
                  ]
                },
                "examples": {
                  "processing": {
                    "summary": "创建处理中",
                    "description": "实时渲染流仍在初始化。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": false,
                      "result": null,
                      "error": null
                    }
                  },
                  "success": {
                    "summary": "创建成功",
                    "description": "实时渲染流已就绪，返回连接所需参数。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": true,
                      "result": {
                        "sessionId": "1305220918472257536",
                        "status": "ACTIVE",
                        "currentQueuePosition": 0,
                        "host": "stream.example.com",
                        "nodeId": "node-01",
                        "streamId": "stream-1305220918472257536",
                        "token": "stream-token"
                      },
                      "error": null
                    }
                  },
                  "failed": {
                    "summary": "创建失败",
                    "description": "实时渲染流初始化失败，返回错误信息。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": true,
                      "result": null,
                      "error": {
                        "code": 500,
                        "message": "code: INTERNAL, details: ErrorDetails(reason=INTERNAL_ERROR, message=null, domain=render, metaData=null)",
                        "status": "INTERNAL",
                        "details": {
                          "reason": "INTERNAL_ERROR",
                          "domain": "render"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "202": {
            "description": "会话创建中（提交模式，返回 operationId 用于后续轮询）。",
            "content": {
              "application/+json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_RealtimeSessionProcessingOperation"
                },
                "examples": {
                  "processing": {
                    "summary": "会话创建中",
                    "description": "提交模式返回的异步操作，`operationId` 即 `sessionId`。",
                    "value": {
                      "operationId": "1305220918472257536",
                      "metaData": null,
                      "done": false,
                      "result": null,
                      "error": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/rendercloud_BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/rendercloud_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/rendercloud_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/rendercloud_InternalServerError"
          }
        },
        "x-scalar-order": 4
      }
    },
    "/rendercloud/v1/streams/{sessionId}:push": {
      "post": {
        "tags": [
          "RenderCloud"
        ],
        "summary": "推送实时渲染流增量 OpenUSD 内容",
        "description": "对已建立的实时渲染会话进行增量场景更新。\n\n该接口用于在 WebSocket Streaming 会话就绪后，向服务端推送增量 OpenUSD\n内容。增量内容可分别描述相机、模型、灯光或环境光 Patch；服务端会将其转换为渲染操作并下发到实时渲染链路。具体 USDA 写法见 `RenderCloud OpenUSD 格式说明`。\n\n## 调用要求\n\n- `sessionId` 必须来自 `/rendercloud/v1/streams` 创建成功后的 `operationId`。\n- 会话状态必须为 `ACTIVE`，否则更新会被拒绝。\n- `requestId` 由调用方生成，用于幂等和请求记录。\n- `usdContent` 为 Base64 编码后的增量 OpenUSD 内容。\n\n## REST 响应状态\n\n| HTTP 状态码 | 场景 | 响应说明 |\n|-----------|------|---------|\n| `200` | 更新成功 | 返回会话 ID 和当前会话状态 |\n| `400` | 参数错误 | `requestId` 或 `usdContent` 缺失，或请求体非法 |\n| `404` | 资源不存在 | `sessionId` 对应会话不存在 |\n| `429` | 请求限流 | 用户维度实时渲染请求频率超过限制 |\n| `500` | 服务异常 | 会话非 ACTIVE、转发失败或增量更新被渲染链路拒绝 |\n",
        "operationId": "pushRenderCloudRealtimeStreamUpdate",
        "parameters": [
          {
            "$ref": "#/components/parameters/rendercloud_SessionId"
          }
        ],
        "requestBody": {
          "description": "实时渲染流增量更新请求体。`usdContent` 为相机、模型、灯光或环境光的 Patch USDA。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/rendercloud_RealtimeSessionUpdateRequest"
              },
              "examples": {
                "update": {
                  "summary": "推送增量内容",
                  "description": "向已创建的实时渲染流推送相机、模型、灯光或环境光的 Patch OpenUSD 内容。",
                  "value": {
                    "requestId": "stream-update-20260515-0001",
                    "usdContent": "I3VzZGEgMS4wCg=="
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "增量内容推送成功。",
            "content": {
              "application/+json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_RealtimeSessionUpdateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "更新成功",
                    "description": "会话保持 ACTIVE，增量内容已下发到实时渲染链路。",
                    "value": {
                      "sessionId": "1305220918472257536",
                      "status": "ACTIVE"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/rendercloud_BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/rendercloud_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/rendercloud_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/rendercloud_InternalServerError"
          }
        },
        "x-scalar-order": 5
      }
    },
    "/rendercloud/v1/streams/{sessionId}": {
      "delete": {
        "tags": [
          "RenderCloud"
        ],
        "summary": "关闭实时渲染流",
        "description": "关闭指定的实时渲染会话并释放服务端资源。\n\n客户端关闭实时渲染时建议先关闭 WebSocket，再调用本接口结束服务端会话。\n服务端会释放该实时渲染会话相关资源。\n\n## REST 响应状态\n\n| HTTP 状态码 | 场景 | 响应说明 |\n|-----------|------|---------|\n| `200` | 关闭完成 | 返回 `closed=true` 表示服务端找到并关闭了会话；`closed=false` 表示会话已不存在或已被清理 |\n| `404` | 资源不存在 | 转发到持有会话的节点时，该节点返回会话不存在 |\n| `429` | 请求限流 | 用户维度实时渲染请求频率超过限制 |\n| `500` | 服务异常 | 转发失败或服务端内部错误 |\n",
        "operationId": "closeRenderCloudRealtimeStream",
        "parameters": [
          {
            "$ref": "#/components/parameters/rendercloud_SessionId"
          }
        ],
        "responses": {
          "200": {
            "description": "实时渲染流已关闭。",
            "content": {
              "application/+json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_RealtimeSessionCloseResponse"
                },
                "examples": {
                  "closed": {
                    "summary": "关闭成功",
                    "description": "服务端找到并关闭了会话。",
                    "value": {
                      "sessionId": "1305220918472257536",
                      "closed": true
                    }
                  },
                  "alreadyGone": {
                    "summary": "会话已不存在",
                    "description": "会话已经被关闭、超时清理或不在当前节点。",
                    "value": {
                      "sessionId": "1305220918472257536",
                      "closed": false
                    }
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/rendercloud_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/rendercloud_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/rendercloud_InternalServerError"
          }
        },
        "x-scalar-order": 6
      }
    },
    "/rendercloud/v1/mesh-upload-process/task/create": {
      "post": {
        "tags": [
          "RenderCloud"
        ],
        "summary": "创建3D解析并入库任务",
        "description": "创建3D解析并入库任务，用于将原始 3D文件 URL 进行解析处理。\n\n通过 `originMeshUrl` 指定原始 3D 文件 URL，可选字段 `fastUpload` 用于启用快速上传，默认 `false`。\n当 `fastUpload` 为 `true` 且文件为 GLB 格式时，使用快速上传流程；未传或为 `false` 时使用普通上传流程。\n\n## REST 响应状态\n\n| HTTP 状态码 | 场景 | 响应说明 |\n|-----------|------|---------|\n| `200` | 任务创建成功 | 返回任务 ID |\n| `400` | 参数错误 | `originMeshUrl` 缺失或无效 |\n| `500` | 服务异常 | 任务创建或处理异常 |\n",
        "operationId": "createMeshUploadAndProcessTask",
        "requestBody": {
          "description": "Mesh 上传解析任务请求体。",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/rendercloud_MeshUploadProcessRequest"
              },
              "examples": {
                "submit": {
                  "summary": "创建 Mesh 上传解析任务",
                  "description": "提交原始 Mesh URL，使用普通上传流程；fastUpload 也可省略，默认为 false。",
                  "value": {
                    "originMeshUrl": "https://example.com/mesh/original.glb",
                    "fastUpload": false
                  }
                },
                "fastSubmit": {
                  "summary": "创建 GLB 快速上传任务",
                  "description": "提交原始 GLB 文件 URL，并启用快速上传。",
                  "value": {
                    "originMeshUrl": "https://example.com/mesh/original.glb",
                    "fastUpload": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Mesh 上传解析任务创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_TaskCreateResponse"
                },
                "examples": {
                  "success": {
                    "summary": "任务创建成功",
                    "description": "返回任务 ID 用于后续查询。",
                    "value": {
                      "success": true,
                      "data": 1272794,
                      "errorMsg": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求参数无效。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_CommonErrorResponse"
                },
                "examples": {
                  "invalidArgument": {
                    "summary": "参数无效",
                    "description": "originMeshUrl 缺失或无效。",
                    "value": {
                      "success": false,
                      "data": null,
                      "errorMsg": "originMeshUrl 不能为空"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "服务内部错误。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_CommonErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "summary": "服务异常",
                    "description": "任务创建或处理异常。",
                    "value": {
                      "success": false,
                      "data": null,
                      "errorMsg": "系统错误"
                    }
                  }
                }
              }
            }
          }
        },
        "x-scalar-order": 1
      }
    },
    "/rendercloud/v1/mesh-upload-process/task/get": {
      "get": {
        "tags": [
          "RenderCloud"
        ],
        "summary": "查询 3D解析并入库 任务状态",
        "description": "查询指定的 3D解析并入库 任务状态和结果。\n\n该接口用于查询任务执行状态和结果。查询时会剔除一些不应该给用户看的数据，\n并对输出数据进行包装处理。\n任务状态：`0`=初始化，`1`=进行中，`3`=成功，`4`=失败\n\n## 调用要求\n\n- `taskid` 必须来自创建任务接口返回的任务 ID\n\n## REST 响应状态\n\n| HTTP 状态码 | 场景 | 响应说明 |\n|-----------|------|---------|\n| `200` | 查询成功 | 返回任务详情 |\n| `400` | 参数错误 | `taskid` 缺失或无效 |\n| `404` | 任务不存在 | 指定任务 ID 不存在 |\n| `500` | 服务异常 | 查询异常 |\n",
        "operationId": "getRenderCloudInstanceInAholo",
        "parameters": [
          {
            "name": "taskid",
            "in": "query",
            "required": true,
            "description": "任务 ID。",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "任务查询成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_TaskQueryResponse"
                },
                "examples": {
                  "processing": {
                    "summary": "任务处理中",
                    "description": "任务正在执行中。",
                    "value": {
                      "success": true,
                      "data": {
                        "taskId": 1272794,
                        "status": 1,
                        "outputs": null
                      },
                      "errorMsg": null
                    }
                  },
                  "success": {
                    "summary": "任务完成",
                    "description": "任务执行完成，返回处理结果。",
                    "value": {
                      "success": true,
                      "data": {
                        "taskId": 1272794,
                        "status": 3,
                        "outputs": [
                          {
                            "content": "YYZN2MZVAIQLEPTULM888888",
                            "sourceReferId": "607583273"
                          }
                        ]
                      },
                      "errorMsg": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求参数无效。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_CommonErrorResponse"
                },
                "examples": {
                  "invalidArgument": {
                    "summary": "参数无效",
                    "description": "taskid 缺失或无效。",
                    "value": {
                      "success": false,
                      "data": null,
                      "errorMsg": "taskid 不能为空"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "任务不存在。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_CommonErrorResponse"
                },
                "examples": {
                  "notFound": {
                    "summary": "任务不存在",
                    "description": "指定任务 ID 不存在。",
                    "value": {
                      "success": false,
                      "data": null,
                      "errorMsg": "任务不存在"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "服务内部错误。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rendercloud_CommonErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "summary": "服务异常",
                    "description": "查询异常。",
                    "value": {
                      "success": false,
                      "data": null,
                      "errorMsg": "系统错误"
                    }
                  }
                }
              }
            }
          }
        },
        "x-scalar-order": 2
      }
    },
    "/web-scan/v2/reconstructions": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createReconstruction",
        "x-scalar-order": 10,
        "summary": "创建重建项目",
        "description": "创建空项目，相机定义在创建后固定。创建成功返回 201，相同幂等请求返回 200。保存响应的 id，后续示例将它记为 PROJECT_ID。示例从服务端环境变量 AHOLO_OPENAPI_KEY 读取密钥，将其原样填入 Authorization 请求头。同一次创建重试时复用 Idempotency-Key。\n\n单相机使用 camera，多相机使用 cameras 数组（最多 32 个，每个都有唯一 id），上传时用 camera_id 指定镜头。两种定义不能混用。单个鱼眼相机可省略 params 自动标定；多相机设备中的鱼眼镜头须提供 params。MEI 须提供 params 和 xi。\n\n| 模型 | params |\n| --- | --- |\n| SIMPLE_PINHOLE | f, cx, cy |\n| PINHOLE | fx, fy, cx, cy |\n| OPENCV | fx, fy, cx, cy, k1, k2, p1, p2 |\n| OPENCV_FISHEYE | fx, fy, cx, cy, k1, k2, k3, k4 |\n| MEI | fx, fy, cx, cy, k1, k2, k3, p1, p2；或 fx, fy, cx, cy, d0 … d12，另传 xi |\n\n请求示例中的标定值仅用于说明格式。提供 params 后保留该镜头的标定，同时继续精化位姿；需要自动标定且模型支持时，可省略 params。像素中心采用 COLMAP 约定：左上角像素中心为 (0.5, 0.5)。若参数来自 OpenCV 标定，cx、cy 各加 0.5，其余参数不变。已去畸变图像用 PINHOLE；裁剪后的主点可以在图像外，不要再居中或重复减去裁剪偏移。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "幂等重试，返回已有项目。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Reconstruction"
                },
                "example": {
                  "id": "1234567890abcdef1234567890abcdef",
                  "name": "Example scene",
                  "camera": null,
                  "cameras": [],
                  "pose_units": "metres",
                  "created_at": "2026-10-07T00:00:00Z",
                  "status": "collecting",
                  "active_job_id": null,
                  "latest_result_job_id": null,
                  "gravity_aligned": false,
                  "remove_people": true
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Reconstruction"
                },
                "example": {
                  "id": "1234567890abcdef1234567890abcdef",
                  "name": "Example scene",
                  "camera": null,
                  "cameras": [],
                  "pose_units": "metres",
                  "created_at": "2026-10-07T00:00:00Z",
                  "status": "collecting",
                  "active_job_id": null,
                  "latest_result_job_id": null,
                  "gravity_aligned": false,
                  "remove_people": true
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "相同账号和资源下的重试标识。同一标识和相同请求可安全重试，内容冲突返回 409。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_ReconstructionCreate"
              },
              "examples": {
                "ordinary": {
                  "summary": "普通照片，自动标定",
                  "value": {
                    "name": "Example scene"
                  }
                },
                "keep_people": {
                  "summary": "保留雕塑、画中人物，只排除拍摄者",
                  "value": {
                    "name": "Museum hall",
                    "remove_people": false
                  }
                },
                "fisheye": {
                  "summary": "鱼眼相机，自动标定",
                  "value": {
                    "name": "Fisheye scene",
                    "camera": {
                      "model": "OPENCV_FISHEYE",
                      "width": 1920,
                      "height": 1920
                    }
                  }
                },
                "rig": {
                  "summary": "同一设备上的两台鱼眼相机，分别提供标定参数",
                  "value": {
                    "name": "Device capture",
                    "cameras": [
                      {
                        "model": "OPENCV_FISHEYE",
                        "width": 1920,
                        "height": 1920,
                        "params": [
                          611.2,
                          611.2,
                          960,
                          960,
                          0.01,
                          -0.002,
                          0,
                          0
                        ],
                        "id": "left",
                        "camera_to_device": [
                          [
                            1,
                            0,
                            0,
                            0
                          ],
                          [
                            0,
                            1,
                            0,
                            0
                          ],
                          [
                            0,
                            0,
                            1,
                            0
                          ],
                          [
                            0,
                            0,
                            0,
                            1
                          ]
                        ]
                      },
                      {
                        "model": "OPENCV_FISHEYE",
                        "width": 1920,
                        "height": 1920,
                        "params": [
                          611.2,
                          611.2,
                          960,
                          960,
                          0.01,
                          -0.002,
                          0,
                          0
                        ],
                        "id": "right",
                        "camera_to_device": [
                          [
                            1,
                            0,
                            0,
                            0.064
                          ],
                          [
                            0,
                            1,
                            0,
                            0
                          ],
                          [
                            0,
                            0,
                            1,
                            0
                          ],
                          [
                            0,
                            0,
                            0,
                            1
                          ]
                        ]
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X POST \"https://api.aholo.cn/web-scan/v2/reconstructions\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" \\\n  -H \"Idempotency-Key: atrium-project-01\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"中庭\"}'"
          }
        ]
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listReconstructions",
        "x-scalar-order": 360,
        "summary": "列出重建项目",
        "description": "按 ID 升序列出当前账号的项目。将 next_cursor 原样传给下一页的 cursor，直到返回 null。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Reconstructions"
                },
                "example": {
                  "items": [
                    {
                      "id": "1234567890abcdef1234567890abcdef",
                      "name": "Example scene",
                      "camera": null,
                      "cameras": [],
                      "pose_units": "metres",
                      "created_at": "2026-10-07T00:00:00Z",
                      "status": "collecting",
                      "active_job_id": null,
                      "latest_result_job_id": null,
                      "gravity_aligned": false,
                      "remove_people": true
                    }
                  ],
                  "next_cursor": null
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 20
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 32,
              "default": ""
            },
            "description": "上一页返回的游标。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body \"https://api.aholo.cn/web-scan/v2/reconstructions?limit=10\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getReconstruction",
        "x-scalar-order": 370,
        "summary": "获取重建项目",
        "description": "读取项目的相机配置、当前任务和最近一次有成果的任务 ID。项目不存在或属于其他账号时返回 404。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Reconstruction"
                },
                "example": {
                  "id": "1234567890abcdef1234567890abcdef",
                  "name": "Example scene",
                  "camera": null,
                  "cameras": [],
                  "pose_units": "metres",
                  "created_at": "2026-10-07T00:00:00Z",
                  "status": "collecting",
                  "active_job_id": null,
                  "latest_result_job_id": null,
                  "gravity_aligned": false,
                  "remove_people": true
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/images/{fid}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadImage",
        "x-scalar-order": 20,
        "summary": "上传图片",
        "description": "至少 12 张有重叠的清晰照片。每张分配一个唯一 ID 和拍摄序号；网络重试时复用同一个 ID、序号及文件。支持 JPEG、PNG、WebP、HEIC/HEIF（服务端转成 JPEG：按旋转摆正，保留 EXIF 和色彩配置），单张最多 33,550,336 字节（32 MiB − 4 KiB）；超过 3200 万像素的 JPEG 或 HEIC（最多 2.5 亿像素）会保留原图，缩小到 3200 万像素以内后重建，相机内参和 mask 一并缩放。\n\nHEIC/HEIF 上传后可能先处于 processing，轮询图片详情直至 ready。若返回 422 且图片详情为 failed、held=true，服务已保留暂时无法解码的原图。可将照片导出为 JPEG，分配新的图片 ID 和未使用的序号后上传。\n\n直接 PUT 图像字节，也可提交文件 URL。收到 202 时，用返回的上传 ID 查询 GET /web-scan/v2/reconstructions/{pid}/uploads/{uid}；上传完成后查询图像状态，等到 ready 再创建重建任务。\n\n没声明相机时，EXIF 方向不是 1 的照片（如手机竖拍）会像网页导入一样按方向转正，直接上传原图即可，不必先旋转或重新编码；首图转正后的尺寸即场景的尺寸。声明的相机、遮罩、位姿和原始 IMU 都对应上传时的像素网格，它们涉及的照片须为 EXIF 方向 1，否则拒收（422）。要用这类输入，先把像素转正并保存为方向 1，再按同一旋转变换这些输入：例如方向 6（顺时针 90°）的 W×H 图像转正后为 H×W，fx 与 fy 互换，cx 改为 H−cy，cy 改为 cx，OPENCV 的 p1、p2 改为 p2、−p1。图像尺寸须匹配所选相机。不同摄像头可使用不同分辨率和镜头模型。补拍沿用原相机定义。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "图片已上传，或已重试其预处理。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImageResource"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImageResource"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          },
          {
            "name": "sequence",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "maximum": 9007199254740991,
              "minimum": 0
            },
            "description": "图像的采集顺序，从 0 开始。"
          },
          {
            "name": "camera_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 64
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "多相机项目中的相机 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "image/jpeg": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "image/png": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "image/webp": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "image/heic": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "image/heif": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X PUT \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/images/$IMAGE_ID?sequence=0\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" \\\n  -H \"Content-Type: image/jpeg\" \\\n  --data-binary @photo.jpg"
          }
        ]
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getImage",
        "x-scalar-order": 320,
        "summary": "获取图片",
        "description": "查看单张图片的相机、顺序、位姿元数据和遮罩状态。ready 表示预处理完成，最终是否参与训练取决于重建结果。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImageResource"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/images": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listImages",
        "x-scalar-order": 310,
        "summary": "列出图片",
        "description": "GET /reconstructions/{pid}/images 返回图片列表。每页用 limit 控制数量，把 next_cursor 原样作为下一页的 cursor，直到它为 null。将每项的 content_href 或非空的 mask_href 接在网关域名后发起 GET，可分别下载完整分辨率图像或调用者上传的 mask。原图不会自动打包进模型结果。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Images"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 1000,
              "minimum": 1,
              "default": 100
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 9007199254740991,
              "minimum": -1,
              "default": -1
            },
            "description": "上一页返回的游标。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/images/{fid}/content": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadImage",
        "x-scalar-order": 330,
        "summary": "下载图片",
        "description": "下载项目保存的图片。文件未就绪时可能返回 409。遇到 302 时跟随签名地址，跨域下载时移除 Authorization。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "image/heic": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/images/{fid}/mask": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadImageMask",
        "x-scalar-order": 340,
        "summary": "下载图片遮罩",
        "description": "下载上传时提供的 PNG 遮罩，无输入遮罩时返回 404。任务生成的遮罩可从任务成果中获取。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "image/png": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          }
        ]
      },
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadImageMask",
        "x-scalar-order": 70,
        "summary": "上传图片遮罩",
        "description": "向图像的 /mask 地址 PUT 单通道 PNG，尺寸与原图完全一致，最多 8 MiB；超过 3200 万像素的图像，其遮罩随图缩小。默认 mask_type=binary：255（或 1）保留，0 排除。mask_type=alpha 接受 8 位灰度物体覆盖率：0 是背景、255 是纯前景，中间值为部分覆盖，不是置信度。同一图像的遮罩与类型不可修改，相同内容可安全重试；修改时使用新图像 ID。\n\n使用 alpha 时须为每张图上传遮罩，选择 mode=object，并省略 object_selection。系统直接使用这些轮廓，不再自动追踪或填补底面。位姿求解使用 alpha≥128，训练保留全部灰度并只以 255 像素训练纯前景颜色；人物排除独立生效，背景仍参与透明度监督。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImageResource"
                }
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          },
          {
            "name": "mask_type",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "binary",
                "alpha"
              ],
              "type": "string",
              "default": "binary"
            },
            "description": "输入遮罩类型，binary 或 alpha。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "image/png": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/imu": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadImu",
        "x-scalar-order": 80,
        "summary": "上传 IMU",
        "description": "上传含 timestamps、gyro_rad_s 和 R_rig_imu 的数值 NPZ。时间戳以秒计并严格递增，角速度单位为 rad/s。压缩前后均不超过 40 MiB，图片与 IMU 使用同一时间轴。\n\n有原始陀螺仪数据和照片时间戳时，可一起上传，用于约束相邻曝光间的旋转。平移仍由图像求解；陀螺不会提供位置、重力方向或米制尺度。没有 IMU 时可照常只上传照片。\n\nNPZ 使用数值数组，可使用 float64。必填数组如下。\n\n| 字段 | 形状 | 含义 |\n| --- | --- | --- |\n| `timestamps` | [N] | 严格递增的传感器采样时间，单位秒 |\n| `gyro_rad_s` | [N, 3] | 原始 IMU 右手 XYZ 轴角速度，单位 rad/s；度/秒先乘 π/180 |\n| `R_rig_imu` | [3, 3] | IMU 轴到设备轴的已标定正交旋转，行数组、作用于列向量 |\n\n每张照片都必须设置 timestamp_seconds，尽量使用真实曝光时间。照片与传感器先换算到可对应的秒时钟，再设置 time_offset_s（默认 0，范围 ±60 秒）。例如照片 12.000 秒对应 IMU 12.020 秒，偏移填 +0.020。不能把两条不同时间线各自归零后假定它们同步，也不要用上传时间代替曝光时间。\n\n保留原始采样时间和频率，不按抽帧率降采样。max_gap_s 默认 0.1 秒，允许 0.000001–1 秒；超过间隔不跨越积分。可选 break_before 是 [N] 的 0/1 数组，用 1 标记该采样之前的断点，推荐 uint8。可选标量 rotation_sigma_scale 默认 1，范围 0.01–100。不要补造缺失采样；图像与 IMU 时间应有有效重叠。\n\n准备真实采样数据：`gyro.csv` 的四列依次是时间戳和三轴角速度，首行为表头；`R_rig_imu.csv` 是无表头的 3×3 标定矩阵。下面的示例假定两套时钟已同步。\n\n~~~python\nimport numpy as np\n\nsamples = np.loadtxt(\"gyro.csv\", delimiter=\",\", skiprows=1)\nrotation = np.loadtxt(\"R_rig_imu.csv\", delimiter=\",\")\nnp.savez(\"imu.npz\", timestamps=samples[:, 0], gyro_rad_s=samples[:, 1:4],\n         R_rig_imu=rotation, time_offset_s=0.0, max_gap_s=0.1)\n~~~",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImuDescription"
                }
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X PUT \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/imu\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/octet-stream' \\\n  --data-binary @imu.npz"
          }
        ]
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getImu",
        "x-scalar-order": 90,
        "summary": "获取 IMU",
        "description": "读取 IMU 的单位、标定、时间范围、样本数和校验摘要。项目无 IMU 时返回 404。\n\n单文件摘要为原文件的 SHA-256；分段追加后，整体摘要对应不可变分段清单。要逐段核对文件摘要，可查询分段列表。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImuDescription"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/imu\" -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/imu/segments/{segmentid}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadImuSegment",
        "x-scalar-order": 100,
        "summary": "上传 IMU 分段",
        "description": "使用非零的 32 位小写十六进制 UUID 追加 NPZ 段。首次写入返回 201，使用同一 ID 重传相同内容返回 200，内容变化返回 409。\n\n当前任务结束后，追加补拍照片及对应 IMU，再创建新任务。每个任务在排队时固定输入版本，后续追加不会改变旧任务或结果。413 表示请求体过大；422 请核对单位、数组、旋转矩阵、时间顺序和不兼容的位姿输入。保留真实采样与断档。\n\n新段首个采样须晚于上一段末尾，各段的轴向矩阵、时钟偏移、断档阈值和不确定度参数须一致。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "相同分段已存在，返回原结果。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImuSegment"
                }
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImuSegment"
                }
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "segmentid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "追加 IMU 分段所用的非零小写十六进制 UUID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/imu/segments": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listImuSegments",
        "x-scalar-order": 110,
        "summary": "列出 IMU 分段",
        "description": "按追加顺序列出各段的 ID、样本数、时间范围、大小和 SHA-256。用 next_cursor 翻页。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImuSegments"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 1000,
              "minimum": 1,
              "default": 100
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 4096,
              "minimum": 0,
              "default": 0
            },
            "description": "上一页返回的游标。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/images/{fid}/metadata": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "setImageMetadata",
        "x-scalar-order": 60,
        "summary": "设置图片元数据",
        "description": "上传图像后，可向其 /metadata 地址 PUT camera_to_world 或 device_to_world，两者互斥。矩阵为右手系 4×4 行数组，作用于列向量，最后一行为 [0,0,0,1]。相机坐标轴为右、下、前；设备坐标系由调用者定义。世界坐标也用 OpenCV 约定：右手系，与重力对齐时 +Y 朝下；其他约定（如 WebXR、OpenGL 的右、上、后）请先转换再上传，结果保留你给的坐标系。创建场景时用 pose_units 声明所有位姿及相机外参的平移单位：默认 metres；未知物理尺度时用 relative，输出也保留相对尺度。\n\n可以全部不提供位姿；一旦提供，每张图像都须有自己的相机位姿或同曝光的显式设备位姿。相机位姿仅作用于对应图片，不会自动补给另一摄像头。缺项或冲突返回 422。\n\n同一曝光的多台相机共享 `frame_id`，并在创建项目时分别声明固定外参 `camera_to_device`。相机位姿可由 `device_to_world × camera_to_device` 得到。默认会根据照片精化输入位姿。若使用测绘、动捕或合成数据的真值，可在创建任务时设 `skip_pose_refinement: true`，同时提供所有曝光的位姿和各相机完整内参。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_ImageResource"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_ImageMetadata"
              },
              "examples": {
                "camera": {
                  "summary": "图像的相机位姿",
                  "value": {
                    "camera_to_world": [
                      [
                        1,
                        0,
                        0,
                        0
                      ],
                      [
                        0,
                        1,
                        0,
                        0
                      ],
                      [
                        0,
                        0,
                        1,
                        0
                      ],
                      [
                        0,
                        0,
                        0,
                        1
                      ]
                    ]
                  }
                },
                "device": {
                  "summary": "共享曝光的设备位姿",
                  "value": {
                    "frame_id": "exposure-0001",
                    "timestamp_seconds": 0,
                    "device_to_world": [
                      [
                        1,
                        0,
                        0,
                        0
                      ],
                      [
                        0,
                        1,
                        0,
                        0
                      ],
                      [
                        0,
                        0,
                        1,
                        0
                      ],
                      [
                        0,
                        0,
                        0,
                        1
                      ]
                    ]
                  }
                },
                "object": {
                  "summary": "采集应用记录的物体和图像位姿",
                  "value": {
                    "camera_to_world": [
                      [
                        1,
                        0,
                        0,
                        0
                      ],
                      [
                        0,
                        1,
                        0,
                        0
                      ],
                      [
                        0,
                        0,
                        1,
                        0
                      ],
                      [
                        0,
                        0,
                        0,
                        1
                      ]
                    ],
                    "timestamp_seconds": 12.5,
                    "object": {
                      "box": [
                        0.38,
                        0.37,
                        0.77,
                        0.69
                      ],
                      "seen": true,
                      "tap": true,
                      "outline": [
                        [
                          [
                            0.38,
                            0.45
                          ],
                          [
                            0.55,
                            0.37
                          ],
                          [
                            0.77,
                            0.52
                          ],
                          [
                            0.6,
                            0.69
                          ],
                          [
                            0.4,
                            0.62
                          ]
                        ]
                      ]
                    },
                    "object_pose": [
                      [
                        1,
                        0,
                        0,
                        0
                      ],
                      [
                        0,
                        1,
                        0,
                        0
                      ],
                      [
                        0,
                        0,
                        1,
                        -0.42
                      ],
                      [
                        0,
                        0,
                        0,
                        1
                      ]
                    ],
                    "object_epoch": 1,
                    "object_map": 0
                  }
                },
                "clear": {
                  "summary": "移除元数据",
                  "value": {}
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X PUT \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/images/$IMAGE_ID/metadata\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/json' \\\n  -d '{\"timestamp_seconds\":12.0}'"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createJob",
        "x-scalar-order": 30,
        "summary": "创建重建任务",
        "description": "用当前输入创建异步重建任务。照片重建至少需要 12 张可用图片。未完成上传或已有活动任务时返回 409。可指定场景或物体模式，以及 PLY、SPZ 输出。保存响应的 id，后续示例将它记为 JOB_ID。同一次提交重试时复用 Idempotency-Key，新任务使用新的键。\n\n任务 mode 默认为 scene。设为 object 可自动选取并追踪前景物体；也可用 object_selection 指定某张图的目标框，坐标为归一化的 [左, 上, 右, 下]。追踪失败会明确返回任务失败。该功能用于多视角下隔离同一目标，不补偿物体任意运动。\n\n补拍无需特殊操作：当前任务结束后，上传新的图像 ID，序号接着已有图像递增，再以新的 Idempotency-Key 创建任务。新任务使用当前全部图像，旧任务和结果仍可查询、下载。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "幂等重试，返回已有任务。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Job"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Job"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "相同账号和资源下的重试标识。同一标识和相同请求可安全重试，内容冲突返回 409。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_JobCreate"
              },
              "examples": {
                "scene": {
                  "summary": "场景重建",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "mode": "scene"
                  }
                },
                "object": {
                  "summary": "追踪选定的物体",
                  "value": {
                    "mode": "object",
                    "object_selection": {
                      "image_id": "abcdef1234567890abcdef1234567890",
                      "bounding_box": [
                        0.1,
                        0.1,
                        0.9,
                        0.9
                      ]
                    }
                  }
                },
                "video": {
                  "summary": "按完整镜头分辨率导入 INSV",
                  "value": {
                    "video": {
                      "fps": 10,
                      "image_size": 3840
                    }
                  }
                },
                "manycore": {
                  "summary": "PLY 和 SPZ 使用右、前、上坐标系",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "axes": "manycore"
                  }
                },
                "public": {
                  "summary": "向下游服务提供公开结果地址",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "public_access": true
                  }
                },
                "gaussians": {
                  "summary": "高斯数量上限 1500 万",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "max_gaussians": 15000000
                  }
                },
                "steps": {
                  "summary": "训练 10 万步",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "steps": 100000
                  }
                },
                "epochs": {
                  "summary": "对输入图像训练 30 遍",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "epochs": 30
                  }
                },
                "keep_people": {
                  "summary": "保留拍摄者以外的人物",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "remove_people": false
                  }
                },
                "blocks": {
                  "summary": "大场景分块训练，每块最多 600 万个高斯",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "block_training": true,
                    "block_max_gaussians": 6000000
                  }
                },
                "quality": {
                  "summary": "高质量 INSV 或 OSV 重建",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "quality": "high"
                  }
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X POST \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/jobs\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" \\\n  -H \"Idempotency-Key: atrium-job-01\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"mode\":\"scene\",\"output_formats\":[\"ply\",\"spz\"]}'"
          }
        ]
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listJobs",
        "x-scalar-order": 380,
        "summary": "列出重建任务",
        "description": "按创建顺序分页列出任务。include=cameras 和 include=masks 可重复传入，用于列出可选成果。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Jobs"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 20
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "上一页返回的游标。"
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "enum": [
                  "cameras",
                  "masks"
                ],
                "type": "string"
              },
              "maxItems": 2,
              "default": []
            },
            "description": "额外列出的成果，可重复传入 cameras 和 masks。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getJob",
        "x-scalar-order": 40,
        "summary": "获取重建任务",
        "description": "按 Retry-After 建议的间隔查询任务。queued、running 表示未结束。HTTP 200 且 status=failed 表示任务失败。成功后从 artifacts 中选择成果，将 href 接在 https://api.aholo.cn 后发起 GET 即可下载。也可用任务 ID 和文件名调用下载接口。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Job"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "enum": [
                  "cameras",
                  "masks"
                ],
                "type": "string"
              },
              "maxItems": 2,
              "default": []
            },
            "description": "额外列出的成果，可重复传入 cameras 和 masks。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -D - \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/jobs/$JOB_ID\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          },
          {
            "lang": "Shell",
            "label": "cURL（含相机与遮罩）",
            "source": "curl --fail-with-body -D - \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/jobs/$JOB_ID?include=cameras&include=masks\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}/public-access": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "setJobPublicAccess",
        "x-scalar-order": 350,
        "summary": "设置成果公开访问",
        "description": "开启或关闭任务成果及留存输入图片、遮罩的公开链接。任何持有有效链接的人都能下载。关闭后原公开入口失效，再次开启会生成新链接。\n\n任务成功后，从 `artifacts[].public_url` 取文件地址，从 `public_images_url` 取该次任务的图片列表。持有链接即可读取；将 `public_access` 设为 `false` 可关闭公开入口。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Job"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_JobPublicAccess"
              },
              "examples": {
                "on": {
                  "summary": "开启结果公开访问",
                  "value": {
                    "public_access": true
                  }
                },
                "off": {
                  "summary": "关闭公开访问，原公开地址返回 404",
                  "value": {
                    "public_access": false
                  }
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X PUT \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/jobs/$JOB_ID/public-access\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/json' \\\n  -d '{\"public_access\":true}'"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}/artifacts/{name}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadArtifact",
        "x-scalar-order": 50,
        "summary": "下载成果",
        "description": "下载任务实际生成的文件。单模型可输出 PLY 或 SPZ，分块模型以 ZIP 提供。可选成果包括相机清单和遮罩。遇到 302 时跨域下载应移除 Authorization。\n\n请将 scale.json 与模型一起保存。其 world_from_result 矩阵将 PLY 坐标（该任务的轴向）转换回求解的世界坐标：没给位姿时是摆正后的世界，提供了位姿时即调用者的坐标系（位姿的单位）；SPZ 坐标先按 model_axes 换回。高斯尺寸也需应用相同的统一缩放。mode、output_units 和 pose_refinement_skipped 记录尺度及位姿选项；SPZ 本身不保留原始世界原点。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/reality_ResultCoordinates"
                    },
                    {
                      "$ref": "#/components/schemas/reality_ResultCameras"
                    }
                  ]
                }
              },
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "point_cloud.ply",
                "scene.spz",
                "point_cloud.zip",
                "scene.zip",
                "scale.json",
                "cameras.json",
                "masks.zip"
              ],
              "type": "string"
            },
            "description": "要下载的成果文件名。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -L \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/jobs/$JOB_ID/artifacts/point_cloud.ply\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -o point_cloud.ply"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}/images": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listJobImages",
        "x-scalar-order": 270,
        "summary": "列出任务输入图片",
        "description": "分页读取指定任务所用的输入快照，包括保留的像素、位姿和遮罩链接。\n\n后续改变抽帧设置重新重建，不会替换旧结果的输入。图片和 mask 始终按需下载，不会自动加入模型包。没有保存输入索引的历史任务返回空列表，重新重建后可用。\n\n任务图片列表中的 `image_id` 可与 `cameras.json` 的 `image_id` 对应。图像和遮罩共用该图片的像素网格，`camera_to_result` 将相机坐标变换到本次任务的 PLY 坐标系。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_JobImages"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 1000,
              "minimum": 1,
              "default": 100
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 9007199254740991,
              "minimum": -1,
              "default": -1
            },
            "description": "上一页返回的游标。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/jobs/$JOB_ID/images?limit=100\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}/images/{fid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getJobImage",
        "x-scalar-order": 280,
        "summary": "获取任务输入图片",
        "description": "读取指定任务中单张输入图片的尺寸、相机和文件链接。位姿使用该任务的结果坐标系。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_JobImage"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}/images/{fid}/content": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadJobImage",
        "x-scalar-order": 290,
        "summary": "下载任务输入图片",
        "description": "按任务和图片 ID 下载该结果保留的输入图像。跨域跟随存储跳转时移除 Authorization。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "image/heic": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/jobs/{rid}/images/{fid}/masks/{role}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadJobMask",
        "x-scalar-order": 300,
        "summary": "下载任务遮罩",
        "description": "按角色下载指定任务图片的遮罩。original 为输入遮罩，person 为人物遮罩，validity 为有效像素，foreground 为物体前景。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "image/png": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "rid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "description": "重建任务 ID。"
          },
          {
            "name": "fid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "图片 ID。上传时使用 32 位小写十六进制 UUID。"
          },
          {
            "name": "role",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "original",
                "person",
                "validity",
                "foreground"
              ],
              "type": "string"
            },
            "description": "要下载的遮罩角色。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/insv": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createInsvImport",
        "x-scalar-order": 190,
        "summary": "创建 INSV/OSV 导入",
        "description": "在未定义相机的空项目中登记 Insta360 INSV 或 DJI OSV 文件，可分块上传或从公开 URL 导入。原始全景文件须保留双镜头及相机标定数据。\n\n场景只填名称，不声明相机。fingerprint 为文件前 1 MiB、后 1 MiB 与十进制字节数依次拼接后的 SHA-256（小写十六进制）。重复 POST 同一文件返回已收到的分块摘要，用于续传。\n\n支持 Insta360 X4、X4 Air、X5、X6、Antigravity A1，以及 DJI Osmo 360、Osmo 360 II、Avata 360。请使用保留双镜头和标定数据的原片。用 source.url 导入完整文件时填写准确的 size，可省略 fingerprint。\n\n加速度计尺度估计的不确定度在 2% 以内时输出米制结果。仅保存融合姿态的第一代 Osmo 360 和 Avata 360 输出相对尺度。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "返回同一文件的已有导入，或恢复已暂停的导入。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_InsvCreate"
              },
              "examples": {
                "insv": {
                  "summary": "INSV 文件，每秒 5 对帧",
                  "value": {
                    "name": "VID_20261013_101500_00_001.insv",
                    "size": 5600000000,
                    "fingerprint": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
                    "fps": 5
                  }
                },
                "osv": {
                  "summary": "DJI Osmo 360 的 OSV 文件",
                  "value": {
                    "name": "CAM_20261020192927_0127_D.OSV",
                    "size": 900746228,
                    "fingerprint": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
                    "fps": 5
                  }
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X POST \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/insv\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/json' \\\n  -d \"{\\\"name\\\":\\\"capture.insv\\\",\\\"size\\\":$SIZE,\\\"fingerprint\\\":\\\"$FINGERPRINT\\\"}\""
          }
        ]
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getInsvImport",
        "x-scalar-order": 220,
        "summary": "获取 INSV/OSV 导入",
        "description": "查询全景文件的上传和导入状态。导入排队或进行中时继续轮询，返回任务 ID 后查询重建任务。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/insv\" -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/insv/parts/{part}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadInsvPart",
        "x-scalar-order": 200,
        "summary": "上传 INSV/OSV 分块",
        "description": "第 n 块是文件 [n×8 MiB, (n+1)×8 MiB) 的原始字节，最后一块可以更短。跳过 received 中摘要一致的块；可同时上传最多 4 块。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvPart"
                }
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "part",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 8192,
              "exclusiveMaximum": true
            },
            "description": "文件内的分块索引，从 0 开始。"
          },
          {
            "name": "X-Content-SHA256",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "该分块或文件字节的 SHA-256 十六进制摘要。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X PUT \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/insv/parts/0\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/octet-stream' \\\n  -H \"X-Content-SHA256: $PART_SHA256\" --data-binary @part-0000.bin"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/insv/complete": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "completeInsvImport",
        "x-scalar-order": 210,
        "summary": "完成 INSV/OSV 上传",
        "description": "单段录制收齐后提交导入，返回 202。照片就绪后自动创建场景重建任务。多段录制应分别确认每一段，待全部导入后手动创建任务。\n\n全部分块收到后调用 complete，加 \"quality\":\"high\" 按高质量档训练（文字和细节更清楚，训练时间约 3 倍，额度相同）。轮询 GET /insv 查看导入阶段；出现 job_id 后按普通任务轮询并下载。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_InsvComplete"
              },
              "examples": {
                "default": {
                  "summary": "PLY 和 SPZ 模型",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ]
                  }
                },
                "public": {
                  "summary": "提供公开结果地址",
                  "value": {
                    "output_formats": [
                      "ply",
                      "spz"
                    ],
                    "public_access": true
                  }
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X POST \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/insv/complete\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/json' \\\n  -d '{\"output_formats\":[\"ply\",\"spz\"]}'"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/insv/{iid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getInsvRecording",
        "x-scalar-order": 250,
        "summary": "获取连续录制",
        "description": "按录制 ID 查询指定段的导入状态和上传进度。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "iid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 32
            },
            "description": "同一项目中的录制段 ID。"
          }
        ]
      },
      "delete": {
        "tags": [
          "Reality"
        ],
        "operationId": "cancelInsvRecording",
        "x-scalar-order": 260,
        "summary": "取消连续录制",
        "description": "取消尚未导入的后续录制并删除其已上传分块。首段或已经导入的录制返回 409。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "iid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 32
            },
            "description": "同一项目中的录制段 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/insv/{iid}/parts/{part}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadInsvRecordingPart",
        "x-scalar-order": 230,
        "summary": "上传连续录制分块",
        "description": "向指定录制段上传一个分块，序号从 0 开始。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvPart"
                }
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "iid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 32
            },
            "description": "同一项目中的录制段 ID。"
          },
          {
            "name": "part",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 8192,
              "exclusiveMaximum": true
            },
            "description": "文件内的分块索引，从 0 开始。"
          },
          {
            "name": "X-Content-SHA256",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "该分块或文件字节的 SHA-256 十六进制摘要。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/insv/{iid}/complete": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "completeInsvRecording",
        "x-scalar-order": 240,
        "summary": "完成连续录制",
        "description": "确认指定段上传完毕并异步导入。返回 202 后轮询该段状态，待全部录制段导入后再提交重建。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_InsvImport"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "iid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 32
            },
            "description": "同一项目中的录制段 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getHesaiImport",
        "x-scalar-order": 470,
        "summary": "获取禾赛导入",
        "description": "查询禾赛工程文件、接收进度及重建任务 ID。参与重建的文件就绪后即可排队，其他工程文件仍可继续上传。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiImport"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ]
      },
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createHesaiImport",
        "x-scalar-order": 390,
        "summary": "创建禾赛导入",
        "description": "在空项目中登记禾赛 Kosmo One 工程。提供 session_info.json 的原文及标准工程文件的相对路径、大小，按响应指定顺序上传。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiImport"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiImport"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_HesaiCreate"
              },
              "examples": {
                "default": {
                  "summary": "禾赛工程目录（示例只列出 3 个文件），输出 PLY 和 SPZ",
                  "value": {
                    "session": "{\"product_model\": \"Kosmo One\", \"files\": [{\"name\": \"Raw Data/calib_info.yaml\", \"size\": 2234}, {\"name\": \"Project Data/slam_result/pointcloud_voxelslam_tum_traj.txt\", \"size\": 2599043}, {\"name\": \"Raw Data/camera_0000.mcap\", \"size\": 2149190789}]}",
                    "files": [
                      {
                        "path": "Project Data/session_info.json",
                        "size": 241
                      },
                      {
                        "path": "Raw Data/calib_info.yaml",
                        "size": 2234
                      },
                      {
                        "path": "Project Data/slam_result/pointcloud_voxelslam_tum_traj.txt",
                        "size": 2599043
                      },
                      {
                        "path": "Raw Data/camera_0000.mcap",
                        "size": 2149190789
                      }
                    ],
                    "output_formats": [
                      "ply",
                      "spz"
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/content": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadHesaiFile",
        "x-scalar-order": 480,
        "summary": "下载禾赛文件",
        "description": "按文件索引下载扫描仪写入的原始工程文件。文件尚未接收完整时返回 409。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "startHesaiFile",
        "x-scalar-order": 400,
        "summary": "创建禾赛文件上传",
        "description": "开始或继续上传指定文件。remote 为 true 时按返回的签名请求启动对象存储分块上传，否则直接向分块端点上传。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiFileUpload"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/upload": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "setHesaiUpload",
        "x-scalar-order": 410,
        "summary": "登记禾赛上传",
        "description": "登记对象存储返回的 UploadId。一旦已有分块到达，更换上传 ID 将返回 409。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiUploadId"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_HesaiUploadId"
              },
              "examples": {
                "default": {
                  "summary": "登记开始上传时返回的 UploadId",
                  "value": {
                    "upload_id": "1698765432a1b2c3"
                  }
                }
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/parts": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "signHesaiParts",
        "x-scalar-order": 420,
        "summary": "签名禾赛分块",
        "description": "每次为最多 64 个分块获取签名 PUT 地址。按签名请求给定的长度和请求头上传，保存返回的 ETag 供确认使用。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiPartUrls"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_HesaiParts"
              },
              "examples": {
                "default": {
                  "summary": "签名第 1、2 号分块",
                  "value": {
                    "parts": [
                      1,
                      2
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/parts/complete": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "receiveHesaiParts",
        "x-scalar-order": 440,
        "summary": "确认禾赛分块",
        "description": "确认已经上传到对象存储的分块，提供索引、SHA-256 和 ETag。同一索引的内容变化时返回 409。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiReceived"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_HesaiReceipts"
              },
              "examples": {
                "default": {
                  "summary": "第 1 号分块已上传",
                  "value": {
                    "parts": [
                      {
                        "part": 1,
                        "sha256": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
                        "etag": "\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/parts/{part}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadHesaiPart",
        "x-scalar-order": 430,
        "summary": "上传禾赛分块",
        "description": "用于 remote=false 的文件，向服务直接上传指定序号的分块。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiPart"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          },
          {
            "name": "part",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 8192,
              "exclusiveMaximum": true
            },
            "description": "文件内的分块索引，从 0 开始。"
          },
          {
            "name": "X-Content-SHA256",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "该分块或文件字节的 SHA-256 十六进制摘要。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/complete": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "completeHesaiFile",
        "x-scalar-order": 450,
        "summary": "完成禾赛文件",
        "description": "收齐分块后合并文件。若返回签名完成请求，按指定地址、请求头和正文发送，再调用文件接收确认。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiCompletion"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/hesai/files/{file}/received": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "receivedHesaiFile",
        "x-scalar-order": 460,
        "summary": "确认禾赛文件",
        "description": "确认完整文件已存储并核对声明大小。服务记录校验值，处理相机文件，并在重建输入齐备后创建任务。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_HesaiImport"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "file",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "exclusiveMaximum": true
            },
            "description": "禾赛文件索引，从 0 开始。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/uploads/{uid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getUpload",
        "x-scalar-order": 180,
        "summary": "获取异步上传",
        "description": "轮询异步上传直到 succeeded 或 failed。成功后 result 包含原上传操作的结果。\n\n文件 URL 须可从公网通过 HTTP(S) 读取，可使用签名链接。每个账号最多同时有 4 个待处理 URL 上传。提交时可用 expected_bytes 和 sha256 校验文件。收到 202 后，将响应头 Location 中的相对路径接在网关域名后，按该地址轮询上传进度。成功时读取 result，失败时读取 error_status 和 error。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "uid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "异步上传 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/videos": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createVideo",
        "x-scalar-order": 120,
        "summary": "创建普通视频",
        "description": "同一场景可添加多段 MP4、MOV、M4V、MKV、WebM 或 AVI。每段 POST /videos 创建资源，按返回的 part_bytes 分块 PUT 到 /videos/{vid}/parts/{part}，再 POST /videos/{vid}/complete。也可在创建时提供 source.url，由服务端下载整个视频。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoResource"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoResource"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "相同账号和资源下的重试标识。同一标识和相同请求可安全重试，内容冲突返回 409。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_VideoCreate"
              },
              "examples": {
                "binary": {
                  "summary": "分块上传本地 MP4",
                  "value": {
                    "name": "clip.mp4",
                    "size": 8388608,
                    "fps": 2
                  }
                },
                "url": {
                  "summary": "从 URL 下载一段视频",
                  "value": {
                    "name": "clip.mp4",
                    "size": 8388608,
                    "source": {
                      "url": "https://files.example.com/clip.mp4"
                    }
                  }
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body -X POST \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/videos\" \\\n  -H \"Authorization: $AHOLO_OPENAPI_KEY\" -H 'Content-Type: application/json' \\\n  -H 'Idempotency-Key: atrium-video-01' \\\n  -d '{\"name\":\"clip.mp4\",\"size\":8388608,\"fps\":2,\"source\":{\"url\":\"https://files.example.com/clip.mp4\"}}'"
          }
        ]
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listVideos",
        "x-scalar-order": 160,
        "summary": "列出普通视频",
        "description": "分页列出项目的视频片段及各自的上传和导入状态。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoList"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 100
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^(?:[0-9a-f]{32})?$",
              "default": ""
            },
            "description": "上一页返回的游标。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/videos/{vid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getVideo",
        "x-scalar-order": 150,
        "summary": "获取普通视频",
        "description": "查询单个视频的下载、解码和导入进度。就绪帧可从项目图片列表读取。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoResource"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "vid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "普通视频片段 ID。"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl --fail-with-body \"https://api.aholo.cn/web-scan/v2/reconstructions/$PROJECT_ID/videos/$VIDEO_ID\" -H \"Authorization: $AHOLO_OPENAPI_KEY\""
          }
        ]
      },
      "delete": {
        "tags": [
          "Reality"
        ],
        "operationId": "cancelVideo",
        "x-scalar-order": 170,
        "summary": "取消普通视频",
        "description": "取消尚未完成的导入，已完成的视频输入不可修改。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoResource"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "vid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "普通视频片段 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/videos/{vid}/parts/{part}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadVideoPart",
        "x-scalar-order": 130,
        "summary": "上传普通视频分块",
        "description": "以原始字节上传一个至多 8 MiB 的分块，末块长度应与剩余文件大小一致。相同内容可重试。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoResource"
                }
              }
            }
          },
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Upload"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              },
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "vid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "普通视频片段 ID。"
          },
          {
            "name": "part",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 8192,
              "exclusiveMaximum": true
            },
            "description": "文件内的分块索引，从 0 开始。"
          },
          {
            "name": "X-Content-SHA256",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "该分块或文件字节的 SHA-256 十六进制摘要。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            },
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "maxLength": 8192,
                    "minLength": 1,
                    "type": "string",
                    "description": "请求目标地址。"
                  },
                  "expected_bytes": {
                    "anyOf": [
                      {
                        "maximum": 68719476736,
                        "type": "integer",
                        "minimum": 0,
                        "exclusiveMinimum": true
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "预期文件大小，单位为字节，用于下载校验。"
                  },
                  "sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[a-fA-F0-9]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "string",
                        "nullable": true,
                        "enum": [
                          null
                        ]
                      }
                    ],
                    "description": "文件或分块的 SHA-256 十六进制摘要。"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/videos/{vid}/complete": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "completeVideo",
        "x-scalar-order": 140,
        "summary": "完成普通视频上传",
        "description": "所有分块就绪后提交视频解码。抽帧异步进行，导入完成后调用创建重建任务。\n\n每段使用不同幂等键并独立查询；全部 status=done 后显式 POST /jobs，将照片与多段视频一起重建。默认每秒 5 帧，未指定 image_size 时保留源分辨率；每个文件最多 64 GiB、10 小时。按 fps 和 image_size 解码的照片与重建中已有的照片合计受单次重建上限：最多 72,000 张、4720 亿像素（2560×1440 按 5 帧/秒为 4 小时），超出时导入在解码前失败，错误信息给出可用的最高帧率或剩余张数。采样上限不超过源帧率，不放大原图。未完成或失败的视频可用 DELETE /videos/{vid} 取消，再继续其他输入。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "202": {
            "description": "已接受请求。异步操作请按资源状态查询进度。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_VideoResource"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "vid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "普通视频片段 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "startGuide360",
        "x-scalar-order": 490,
        "summary": "开始全景拍摄引导",
        "description": "用相机 SDK 返回的双镜头预览标定启动 Insta360 X5/X6 引导。保存返回的 session 以发送数据流。同一账号同时只允许一个引导采集。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "session": {
                      "type": "string",
                      "description": "引导会话 ID，后续发送预览块时使用。"
                    },
                    "lenses": {
                      "type": "array",
                      "description": "两个镜头的出厂标定参数。",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "ready": {
                      "type": "boolean",
                      "description": "引导服务是否已就绪。"
                    },
                    "state": {
                      "type": "object",
                      "additionalProperties": true,
                      "properties": {
                        "session": {
                          "type": "string",
                          "description": "引导会话 ID，后续发送预览块时使用。"
                        },
                        "frames": {
                          "type": "integer",
                          "description": "已处理的帧数。"
                        },
                        "tracked": {
                          "type": "integer",
                          "description": "成功跟踪的帧数。"
                        },
                        "keyframes": {
                          "type": "integer",
                          "description": "引导地图中的关键帧数。"
                        },
                        "located": {
                          "type": "boolean",
                          "description": "当前帧是否已定位。"
                        },
                        "pose": {
                          "type": "object",
                          "description": "当前相机位姿，跟踪丢失时可为空。",
                          "nullable": true,
                          "additionalProperties": true
                        },
                        "event": {
                          "type": "integer",
                          "description": "最新事件序号，可在下次查询时用作 since。"
                        },
                        "events": {
                          "type": "array",
                          "description": "晚于 since 的事件列表。",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          }
                        },
                        "progress": {
                          "type": "number",
                          "description": "覆盖进度；覆盖估计尚未生成时为 null。",
                          "nullable": true
                        }
                      }
                    }
                  },
                  "required": [
                    "session",
                    "lenses",
                    "state"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_Guide360Start"
              },
              "examples": {
                "x5": {
                  "summary": "Insta360 X5 相机 SDK 返回的预览标定",
                  "value": {
                    "camera": "Insta360 X5",
                    "offset_v1": "2_2653.021_2691.320_2691.980_0.029_-0.491_90.077_2656.015_8065.070_2685.250_0.050_-0.392_89.644_10752_5376_1137",
                    "offset_v3": "2_2.000000_4284.280_4285.010_2691.320_2691.980_0.029_-0.491_90.077_0.000000_0.000000_0.000000_0.17950149_2.07849193_-3.26076674_-0.00145375_-0.00086497_10752_5376_113_2.000000_4289.920_4291.370_8065.070_2685.250_0.050_-0.392_89.644_-0.001964_0.000074_-0.032595_0.18243892_2.06628704_-3.29700232_0.00071970_-0.00239454_10752_5376_113_197632",
                    "window_crop": {
                      "src_width": 5376,
                      "src_height": 5376,
                      "dst_width": 5312,
                      "dst_height": 5312
                    }
                  }
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getGuide360",
        "x-scalar-order": 540,
        "summary": "获取全景拍摄引导",
        "description": "获取当前引导会话的状态，包括增量地图信息。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "session": {
                      "type": "string",
                      "description": "引导会话 ID，后续发送预览块时使用。"
                    },
                    "frames": {
                      "type": "integer",
                      "description": "已处理的帧数。"
                    },
                    "tracked": {
                      "type": "integer",
                      "description": "成功跟踪的帧数。"
                    },
                    "keyframes": {
                      "type": "integer",
                      "description": "引导地图中的关键帧数。"
                    },
                    "located": {
                      "type": "boolean",
                      "description": "当前帧是否已定位。"
                    },
                    "pose": {
                      "type": "object",
                      "description": "当前相机位姿，跟踪丢失时可为空。",
                      "nullable": true,
                      "additionalProperties": true
                    },
                    "ready": {
                      "type": "boolean",
                      "description": "引导服务是否已就绪。"
                    },
                    "event": {
                      "type": "integer",
                      "description": "最新事件序号，可在下次查询时用作 since。"
                    },
                    "events": {
                      "type": "array",
                      "description": "晚于 since 的事件列表。",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "progress": {
                      "type": "number",
                      "description": "覆盖进度；覆盖估计尚未生成时为 null。",
                      "nullable": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 2147483648,
              "minimum": 0,
              "default": 0
            },
            "description": "返回此位置之后的引导事件。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/stream": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "streamGuide360",
        "x-scalar-order": 500,
        "summary": "上传引导流分块",
        "description": "发送最长 4 MiB 的预览块。先写入小端 u32 的 JSON 头长度，再写入含 seq、packets 的 JSON 头以及各包字节。seq 从 0 连续递增。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "session": {
                      "type": "string",
                      "description": "引导会话 ID，后续发送预览块时使用。"
                    },
                    "frames": {
                      "type": "integer",
                      "description": "已处理的帧数。"
                    },
                    "tracked": {
                      "type": "integer",
                      "description": "成功跟踪的帧数。"
                    },
                    "keyframes": {
                      "type": "integer",
                      "description": "引导地图中的关键帧数。"
                    },
                    "located": {
                      "type": "boolean",
                      "description": "当前帧是否已定位。"
                    },
                    "pose": {
                      "type": "object",
                      "description": "当前相机位姿，跟踪丢失时可为空。",
                      "nullable": true,
                      "additionalProperties": true
                    },
                    "ready": {
                      "type": "boolean",
                      "description": "引导服务是否已就绪。"
                    },
                    "event": {
                      "type": "integer",
                      "description": "最新事件序号，可在下次查询时用作 since。"
                    },
                    "events": {
                      "type": "array",
                      "description": "晚于 since 的事件列表。",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "progress": {
                      "type": "number",
                      "description": "覆盖进度；覆盖估计尚未生成时为 null。",
                      "nullable": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "session",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "启动引导时取得的会话标识。"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 2147483648,
              "minimum": 0,
              "default": 0
            },
            "description": "返回此位置之后的引导事件。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/minimap": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getGuide360Minimap",
        "x-scalar-order": 550,
        "summary": "下载引导小地图",
        "description": "下载用于绘制俯视小地图的 GM01 小端二进制数据，包含 68 字节头、地面网格和轨迹点。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/coverage": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getGuide360Coverage",
        "x-scalar-order": 560,
        "summary": "下载引导覆盖",
        "description": "下载覆盖情况的 GC01 小端二进制数据，可叠加到对应坐标系的相机画面。含 64 字节头和最多 8,000 个体素，每个体素 12 字节。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/check": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "checkGuide360",
        "x-scalar-order": 530,
        "summary": "检查拍摄覆盖",
        "description": "结束录制前查询覆盖不足的位置。响应按范围从大到小给出中心、半径及建议拍摄方向。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "session": {
                      "type": "string",
                      "description": "引导会话 ID，后续发送预览块时使用。"
                    },
                    "frames": {
                      "type": "integer",
                      "description": "已处理的帧数。"
                    },
                    "tracked": {
                      "type": "integer",
                      "description": "成功跟踪的帧数。"
                    },
                    "keyframes": {
                      "type": "integer",
                      "description": "引导地图中的关键帧数。"
                    },
                    "located": {
                      "type": "boolean",
                      "description": "当前帧是否已定位。"
                    },
                    "pose": {
                      "type": "object",
                      "description": "当前相机位姿，跟踪丢失时可为空。",
                      "nullable": true,
                      "additionalProperties": true
                    },
                    "event": {
                      "type": "integer",
                      "description": "最新事件序号，可在下次查询时用作 since。"
                    },
                    "events": {
                      "type": "array",
                      "description": "晚于 since 的事件列表。",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "progress": {
                      "type": "number",
                      "description": "覆盖进度；覆盖估计尚未生成时为 null。",
                      "nullable": true
                    },
                    "check": {
                      "type": "object",
                      "properties": {
                        "targets": {
                          "type": "array",
                          "description": "尚需补拍的区域。",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 2147483648,
              "minimum": 0,
              "default": 0
            },
            "description": "返回此位置之后的引导事件。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/finish": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "finishGuide360",
        "x-scalar-order": 570,
        "summary": "结束全景拍摄引导",
        "description": "录制结束时关闭引导会话，返回最终状态。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "session": {
                      "type": "string",
                      "description": "引导会话 ID，后续发送预览块时使用。"
                    },
                    "frames": {
                      "type": "integer",
                      "description": "已处理的帧数。"
                    },
                    "tracked": {
                      "type": "integer",
                      "description": "成功跟踪的帧数。"
                    },
                    "keyframes": {
                      "type": "integer",
                      "description": "引导地图中的关键帧数。"
                    },
                    "located": {
                      "type": "boolean",
                      "description": "当前帧是否已定位。"
                    },
                    "pose": {
                      "type": "object",
                      "description": "当前相机位姿，跟踪丢失时可为空。",
                      "nullable": true,
                      "additionalProperties": true
                    },
                    "event": {
                      "type": "integer",
                      "description": "最新事件序号，可在下次查询时用作 since。"
                    },
                    "events": {
                      "type": "array",
                      "description": "晚于 since 的事件列表。",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "progress": {
                      "type": "number",
                      "description": "覆盖进度；覆盖估计尚未生成时为 null。",
                      "nullable": true
                    },
                    "finished": {
                      "type": "boolean",
                      "description": "此次引导采集已结束。"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/{series}/{number}": {
      "put": {
        "tags": [
          "Reality"
        ],
        "operationId": "uploadGuide360Segment",
        "x-scalar-order": 510,
        "summary": "上传全景引导分段",
        "description": "实验接口。按序上传 track、depth 或 mesh 采集片段，编号从 0 开始，每段最多 8 MiB。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "最后一个分段内容一致，返回原状态。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_GuideSeries"
                }
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_GuideSeries"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "series",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "track",
                "depth",
                "mesh"
              ],
              "type": "string"
            },
            "description": "采集序列，取 track、depth 或 mesh。"
          },
          {
            "name": "number",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 4096,
              "exclusiveMaximum": true
            },
            "description": "从 0 开始的分段序号。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/{series}/complete": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "completeGuide360Series",
        "x-scalar-order": 520,
        "summary": "完成全景引导系列",
        "description": "实验接口。收齐分段后合并对应序列并关闭写入，mesh 会进行完整性检查。重复确认返回当前状态。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_GuideSeries"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          },
          {
            "name": "series",
            "in": "path",
            "required": true,
            "schema": {
              "enum": [
                "track",
                "depth",
                "mesh"
              ],
              "type": "string"
            },
            "description": "采集序列，取 track、depth 或 mesh。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_GuideComplete"
              },
              "examples": {
                "default": {
                  "summary": "已保存 12 个分段",
                  "value": {
                    "segments": 12
                  }
                }
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/reconstructions/{pid}/guide360/mesh": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "downloadGuide360Mesh",
        "x-scalar-order": 580,
        "summary": "下载全景引导网格",
        "description": "实验接口。下载已完成的二进制小端 PLY 网格，使用 ARKit 米制、Y 轴向上的坐标系。未完成时返回 404。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "下载地址位于 Location。跳转到其他主机时移除 Authorization。",
            "headers": {
              "Location": {
                "schema": {
                  "type": "string",
                  "format": "uri"
                },
                "description": "文件下载的跳转地址。完整签名 URL 按原值使用，跨域时不携带平台 Key。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "pid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "重建项目 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/feedback": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createFeedback",
        "x-scalar-order": 590,
        "summary": "创建反馈",
        "description": "提交反馈文字及最多 6 张截图，可关联自己的项目和任务。传入 Idempotency-Key 可安全重试。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "幂等重试，返回已有反馈。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Feedback"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Feedback"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "相同账号和资源下的重试标识。同一标识和相同请求可安全重试，内容冲突返回 409。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_FeedbackCreate"
              },
              "examples": {
                "job": {
                  "summary": "反馈某次任务的结果",
                  "value": {
                    "text": "The words on the bookshelf are still blurred, after a second job with 30 passes and 8 million Gaussians.",
                    "reconstruction_id": "1234567890abcdef1234567890abcdef",
                    "job_id": "0123456789abcdef0123456789abcdef"
                  }
                },
                "screenshot": {
                  "summary": "附带截图",
                  "value": {
                    "text": "The words on the bookshelf are still blurred, after a second job with 30 passes and 8 million Gaussians.",
                    "images": [
                      "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
                    ],
                    "reconstruction_id": "1234567890abcdef1234567890abcdef",
                    "job_id": "0123456789abcdef0123456789abcdef"
                  }
                },
                "general": {
                  "summary": "反馈其他问题",
                  "value": {
                    "text": "Could the results include a mesh as well?"
                  }
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "listFeedback",
        "x-scalar-order": 610,
        "summary": "列出反馈",
        "description": "按从新到旧的顺序分页查看自己的反馈及其回复。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_FeedbackList"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 20
            },
            "description": "每页最多返回的条目数。"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^(?:[0-9a-f]{32})?$",
              "default": ""
            },
            "description": "上一页返回的游标。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/feedback/{feedbackid}": {
      "get": {
        "tags": [
          "Reality"
        ],
        "operationId": "getFeedback",
        "x-scalar-order": 600,
        "summary": "获取反馈",
        "description": "查看反馈状态、团队回复和后续消息。其他账号的反馈返回 404。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Feedback"
                }
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "feedbackid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "所属账号的反馈 ID。"
          }
        ]
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/web-scan/v2/feedback/{feedbackid}/messages": {
      "post": {
        "tags": [
          "Reality"
        ],
        "operationId": "createFeedbackMessage",
        "x-scalar-order": 620,
        "summary": "添加反馈消息",
        "description": "在已有反馈下补充文字和最多 6 张截图。每条反馈最多 30 条补充消息，可使用 Idempotency-Key 安全重试。",
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "responses": {
          "200": {
            "description": "幂等重试，返回已有补充消息。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Feedback"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "201": {
            "description": "资源创建成功。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Feedback"
                }
              }
            },
            "headers": {
              "Location": {
                "schema": {
                  "type": "string"
                },
                "description": "资源在 API 网关上的相对路径，以 /web-scan/v2/ 开头。拼接网关域名后 GET 查询。"
              }
            }
          },
          "400": {
            "description": "请求格式无效。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/reality_Unauthorized"
          },
          "403": {
            "description": "调用方无权执行此操作。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "404": {
            "description": "资源不存在或不属于当前账号。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "409": {
            "description": "资源状态或幂等请求冲突。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "413": {
            "description": "请求超过接收上限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "415": {
            "description": "不支持该媒体类型。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "422": {
            "description": "参数、输入内容或状态不符合接口要求。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "429": {
            "description": "请求频率或业务配额超限。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "建议在多少秒后重试或再次查询。"
              }
            }
          },
          "500": {
            "description": "处理请求时发生错误。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          },
          "507": {
            "description": "存储空间不足。",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/reality_Problem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "feedbackid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{32}$"
            },
            "description": "所属账号的反馈 ID。"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            },
            "description": "相同账号和资源下的重试标识。同一标识和相同请求可安全重试，内容冲突返回 409。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/reality_FeedbackMessageCreate"
              },
              "examples": {
                "default": {
                  "summary": "回复并附上截图",
                  "value": {
                    "text": "Here it is, at the left end of the shelf.",
                    "images": [
                      "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "servers": [
        {
          "url": "https://api.aholo.cn",
          "description": "国内站 API 网关"
        }
      ]
    },
    "/spatial-understanding/v1/tasks": {
      "post": {
        "tags": [
          "SpatialUnderstanding"
        ],
        "summary": "创建空间理解任务",
        "description": "异步创建一条空间理解任务：从室内点云中识别墙、门、窗与物体 3D bbox。`inputFileUrl` 须为 Asset 上传得到的 `.ply` 文件 URL。点云坐标系为米、右手系、Z-up；未对齐时请传 `transformationMatrix`（列优先，平移在第 4 列）。受理成功即扣减积分，并返回 `taskId`（与「查询任务详情」路径参数一致）。成功后详情中的 `result.resultSslUrl` 为 DSL 文本，需自行下载解析。",
        "operationId": "createSpatialUnderstandingTask",
        "requestBody": {
          "description": "创建任务请求体。`inputFileUrl` 必填，须为 Asset 上传得到的室内 `.ply` URL；`transformationMatrix` 可选，用于将点云对齐到米制、右手系、Z-up。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spatialunderstanding_CreateSpatialUnderstandingTaskRequest"
              },
              "examples": {
                "createWithoutMatrix": {
                  "summary": "仅传点云文件，不做坐标变换",
                  "description": "createWithoutMatrix",
                  "value": {
                    "inputFileUrl": "https://holo-cos.aholo3d.cn/resource/openapi/xxx.ply"
                  }
                },
                "createWithMatrix": {
                  "summary": "附带 4×4 变换矩阵（列优先，含旋转与平移）",
                  "description": "createWithMatrix",
                  "value": {
                    "inputFileUrl": "https://holo-cos.aholo3d.cn/resource/openapi/xxx.ply",
                    "transformationMatrix": [
                      [
                        0.9337461173020494,
                        0.3579360116324523,
                        0,
                        1.871216953359744
                      ],
                      [
                        -0.3579360116324523,
                        0.9337461173020494,
                        0,
                        -0.2091883674268249
                      ],
                      [
                        0,
                        0,
                        0.9999999999999999,
                        1.2121098756790158
                      ],
                      [
                        0,
                        0,
                        0,
                        1
                      ]
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "受理成功：返回 `taskId`，用于查询任务详情。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTaskAsyncOperation"
                },
                "examples": {
                  "success": {
                    "summary": "创建受理成功",
                    "description": "success",
                    "value": {
                      "taskId": "A1b2C3d4E5"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "参数校验失败、点云文件 URL 无效、变换矩阵格式非法、或积分不足（`details.metaData.bizCode` 为业务码）",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "请求体校验失败（如 inputFileUrl 为空）",
                    "description": "业务码 10001",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  },
                  "invalidInputUrl": {
                    "summary": "inputFileUrl 无效或不是 .ply",
                    "description": "业务码 13001，须改用 Asset 上传接口返回的 `.ply` URL",
                    "value": {
                      "code": 400,
                      "message": "invalid file url, please upload a .ply file via the Asset module APIs",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_13001",
                        "domain": "api.aholo.cn",
                        "message": "invalid file url, please upload a .ply file via the Asset module APIs",
                        "metaData": {
                          "bizCode": "13001"
                        }
                      }
                    }
                  },
                  "invalidTransformationMatrix": {
                    "summary": "变换矩阵格式非法",
                    "description": "业务码 13002，须为 4 行 4 列合法数字",
                    "value": {
                      "code": 400,
                      "message": "invalid transformation matrix, expect a 4x4 numeric array",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_13002",
                        "domain": "api.aholo.cn",
                        "message": "invalid transformation matrix, expect a 4x4 numeric array",
                        "metaData": {
                          "bizCode": "13002"
                        }
                      }
                    }
                  },
                  "insufficientCredits": {
                    "summary": "积分不足以完成任务",
                    "description": "业务码 24002，积分不足",
                    "value": {
                      "code": 400,
                      "message": "insufficient credits",
                      "status": "FAILED_PRECONDITION",
                      "details": {
                        "reason": "BIZ_24002",
                        "domain": "api.aholo.cn",
                        "message": "insufficient credits",
                        "metaData": {
                          "bizCode": "24002"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 10
      }
    },
    "/spatial-understanding/v1/tasks/{taskId}": {
      "get": {
        "tags": [
          "SpatialUnderstanding"
        ],
        "summary": "查询空间理解任务详情",
        "description": "根据任务 id 查询当前账号下的任务详情。`PENDING` / `RUNNING` 表示尚未完成，请继续轮询。`SUCCEEDED` 时响应包含 `result.resultSslUrl`（DSL 文本，含 Wall / Door / Window / Bbox，需自行下载解析）。`FAILED` / `TIMEOUT` 时响应包含 `errorCode`、`errorMessage`。",
        "operationId": "getSpatialUnderstandingTaskDetail",
        "parameters": [
          {
            "name": "taskId",
            "in": "path",
            "description": "任务 id（与创建接口成功响应 `taskId` 一致）",
            "required": true,
            "schema": {
              "minLength": 1,
              "type": "string"
            },
            "example": "A1b2C3d4E5"
          }
        ],
        "responses": {
          "200": {
            "description": "任务详情。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTask"
                },
                "examples": {
                  "pending": {
                    "summary": "排队中，尚未产出结果",
                    "description": "pending",
                    "value": {
                      "taskId": "A1b2C3d4E5",
                      "status": "PENDING",
                      "modelVersion": "spatiallm-pointcloud-1.2-20260910",
                      "createTime": 1699339916000,
                      "updateTime": 1699339916000
                    }
                  },
                  "succeeded": {
                    "summary": "已完成，含结果地址",
                    "description": "succeeded",
                    "value": {
                      "taskId": "A1b2C3d4E5",
                      "status": "SUCCEEDED",
                      "modelVersion": "spatiallm-pointcloud-1.2-20260910",
                      "result": {
                        "resultSslUrl": "https://holo-cos.aholo3d.cn/resource/openapi/xxx-result.txt"
                      },
                      "createTime": 1699339916000,
                      "updateTime": 1699340120000
                    }
                  },
                  "failed": {
                    "summary": "失败，含错误码与详情",
                    "description": "failed",
                    "value": {
                      "taskId": "A1b2C3d4E5",
                      "status": "FAILED",
                      "modelVersion": "spatiallm-pointcloud-1.2-20260910",
                      "errorCode": "MODEL_TASK_FAILED",
                      "errorMessage": "task failed",
                      "createTime": 1699339916000,
                      "updateTime": 1699340120000
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "任务不存在，或无权访问该任务",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_ApiError"
                },
                "examples": {
                  "taskNotFound": {
                    "summary": "任务不存在",
                    "description": "业务码 13003",
                    "value": {
                      "code": 404,
                      "message": "spatial understanding task not found",
                      "status": "NOT_FOUND",
                      "details": {
                        "reason": "BIZ_13003",
                        "domain": "api.aholo.cn",
                        "message": "spatial understanding task not found",
                        "metaData": {
                          "bizCode": "13003"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 20
      }
    },
    "/spatial-understanding/v1/tasks/list": {
      "post": {
        "tags": [
          "SpatialUnderstanding"
        ],
        "summary": "分页查询我的空间理解任务列表",
        "description": "分页查询当前账号下的空间理解任务，支持按状态过滤。`pageNum` 从 1 起（`0` 与 `1` 均视为第一页）；`pageSize` 未传或为 0 时按 20 条计，最大 100。",
        "operationId": "getMySpatialUnderstandingTaskList",
        "requestBody": {
          "description": "分页与筛选条件。",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTaskListQueryRequest"
              },
              "examples": {
                "listTaskRequest": {
                  "description": "示例：第一页、每页 20、按运行中与成功筛选",
                  "value": {
                    "pageNum": 1,
                    "pageSize": 20,
                    "statusList": [
                      "RUNNING",
                      "SUCCEEDED"
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "分页列表，含 `pageNum`、`pageSize` 与当前页任务。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTaskPagedList"
                },
                "examples": {
                  "success": {
                    "summary": "查询成功",
                    "description": "success",
                    "value": {
                      "pageNum": 1,
                      "pageSize": 20,
                      "count": 2,
                      "totalCount": 2,
                      "hasMore": false,
                      "result": [
                        {
                          "taskId": "A1b2C3d4E5",
                          "status": "RUNNING",
                          "modelVersion": "spatiallm-pointcloud-1.2-20260910",
                          "createTime": 1699339916000,
                          "updateTime": 1699339916000
                        },
                        {
                          "taskId": "B2c3D4e5F6",
                          "status": "SUCCEEDED",
                          "modelVersion": "spatiallm-pointcloud-1.2-20260910",
                          "result": {
                            "resultSslUrl": "https://holo-cos.aholo3d.cn/resource/openapi/xxx-result.txt"
                          },
                          "createTime": 1699339800000,
                          "updateTime": 1699340120000
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "分页参数校验失败",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_ApiError"
                },
                "examples": {
                  "paramsInvalid": {
                    "summary": "请求体/分页参数校验失败",
                    "description": "业务码 10001，如 pageSize 超出 [0, 100]",
                    "value": {
                      "code": 400,
                      "message": "Invalid request parameters",
                      "status": "INVALID_ARGUMENT",
                      "details": {
                        "reason": "BIZ_10001",
                        "domain": "api.aholo.cn",
                        "message": "Invalid request parameters",
                        "metaData": {
                          "bizCode": "10001"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "未携带或无效的 Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/spatialunderstanding_ApiError"
                },
                "examples": {
                  "notLoggedIn": {
                    "summary": "未登录或鉴权失败",
                    "description": "业务码 10004",
                    "value": {
                      "code": 401,
                      "message": "Not logged in",
                      "status": "UNAUTHENTICATED",
                      "details": {
                        "reason": "BIZ_10004",
                        "domain": "api.aholo.cn",
                        "message": "Not logged in",
                        "metaData": {
                          "bizCode": "10004"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "AuthorizationHeader": []
          }
        ],
        "x-scalar-order": 30
      }
    }
  },
  "components": {
    "schemas": {
      "asset_UploadTokenOuterOpen": {
        "type": "object",
        "properties": {
          "ousToken": {
            "type": "string",
            "description": "上传 token。后续对 OUS 域名的上传/分片等请求需在 HTTP Header 中携带：`ous-token-v2: <token>`",
            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
          },
          "globalDomain": {
            "type": "string",
            "description": "OUS 全局域名（不含路径）。后续上传、分片等 HTTP 请求发往该主机",
            "example": "https://ous-cos.kujiale.com"
          },
          "blockSize": {
            "type": "integer",
            "description": "分片阈值（字节）。文件大于该值时需按文档进行分片上传",
            "format": "int64",
            "example": 1048576
          }
        },
        "description": "OUS 上传凭证：获取后用于在 `globalDomain`（如 `https://ous-cos.kujiale.com`）上直传，请求头携带 `ous-token-v2`；完整步骤见同一份 OpenAPI 中「Upload」标签下的 `ousCos*` 操作。"
      },
      "asset_ApiError": {
        "required": [
          "code",
          "details",
          "message",
          "status"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "HTTP状态码",
            "format": "int32",
            "example": 403
          },
          "message": {
            "type": "string",
            "description": "面向开发者的错误消息（英文），用户可见的本地化消息请使用localizedMessage字段",
            "example": "Permission denied to access this resource"
          },
          "status": {
            "$ref": "#/components/schemas/asset_Code"
          },
          "details": {
            "$ref": "#/components/schemas/asset_ErrorDetails"
          },
          "localizedMessage": {
            "$ref": "#/components/schemas/asset_LocalizedMessage"
          },
          "help": {
            "$ref": "#/components/schemas/asset_Help"
          }
        },
        "description": "API错误响应对象，包含完整的错误信息、状态码和帮助信息"
      },
      "asset_Code": {
        "type": "string",
        "description": "REST API标准状态码，符合Google API设计规范，用于统一的错误码表示",
        "example": "PERMISSION_DENIED",
        "enum": [
          "OK",
          "CANCELLED",
          "UNKNOWN",
          "INVALID_ARGUMENT",
          "DEADLINE_EXCEEDED",
          "NOT_FOUND",
          "ALREADY_EXISTS",
          "PERMISSION_DENIED",
          "UNAUTHENTICATED",
          "RESOURCE_EXHAUSTED",
          "FAILED_PRECONDITION",
          "ABORTED",
          "OUT_OF_RANGE",
          "UNIMPLEMENTED",
          "INTERNAL",
          "UNAVAILABLE",
          "DATA_LOSS",
          "PARTIAL_ELEMENT_UPDATE_FAILED"
        ]
      },
      "asset_ErrorDetails": {
        "required": [
          "reason"
        ],
        "type": "object",
        "properties": {
          "reason": {
            "maxLength": 63,
            "pattern": "[A-Z][A-Z0-9_]+[A-Z0-9]",
            "type": "string",
            "description": "错误原因标识符，使用大写蛇形命名法（UPPER_SNAKE_CASE），最多63个字符",
            "example": "RESOURCE_NOT_FOUND"
          },
          "message": {
            "type": "string",
            "description": "针对此错误的人类可读说明，提供具体的错误上下文",
            "nullable": true,
            "example": "The requested design with ID 12345 does not exist"
          },
          "domain": {
            "type": "string",
            "description": "错误域，通常是生成错误的服务名称",
            "nullable": true,
            "example": "restapi.qunhe.com"
          },
          "metaData": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "description": "错误的附加元数据，键值对格式，键最多64个字符，符合模式 /[a-zA-Z0-9-_]/",
              "nullable": true,
              "example": "{\"instanceLimitPerRequest\":\"100\",\"currentInstanceCount\":\"150\"}"
            },
            "description": "错误的附加元数据，键值对格式，键最多64个字符，符合模式 /[a-zA-Z0-9-_]/",
            "nullable": true,
            "example": {
              "instanceLimitPerRequest": "100",
              "currentInstanceCount": "150"
            }
          }
        },
        "description": "错误详情对象，提供错误的详细上下文信息，包括原因、域和元数据"
      },
      "asset_Help": {
        "required": [
          "desc",
          "url"
        ],
        "type": "object",
        "properties": {
          "desc": {
            "type": "string",
            "description": "链接内容的描述，说明此帮助文档的用途",
            "example": "如何解决权限拒绝错误"
          },
          "url": {
            "type": "string",
            "description": "帮助文档的URL链接",
            "example": "https://docs.example.com/errors/permission-denied"
          }
        },
        "description": "帮助信息对象，提供解决错误的文档链接和说明",
        "nullable": true
      },
      "asset_LocalizedMessage": {
        "required": [
          "locale",
          "message"
        ],
        "type": "object",
        "properties": {
          "locale": {
            "type": "string",
            "description": "消息的语言环境标识",
            "example": "zh_CN"
          },
          "message": {
            "type": "string",
            "description": "本地化后的错误消息文本，面向最终用户",
            "example": "您没有访问此资源的权限"
          }
        },
        "description": "本地化消息对象，提供特定语言环境的错误消息",
        "nullable": true
      },
      "asset_OusCosSingleUploadForm": {
        "required": [
          "file",
          "md5"
        ],
        "type": "object",
        "properties": {
          "md5": {
            "type": "string",
            "description": "文件内容的 MD5，十六进制小写",
            "example": "d41d8cd98f00b204e9800998ecf8427e"
          },
          "file": {
            "type": "string",
            "description": "待上传的完整文件正文",
            "format": "binary"
          }
        },
        "description": "`multipart/form-data` 表单字段（boundary 由客户端生成）"
      },
      "asset_OusCosBlockUploadInitRequest": {
        "required": [
          "blocks",
          "md5",
          "name",
          "size"
        ],
        "type": "object",
        "properties": {
          "md5": {
            "type": "string",
            "description": "整文件 MD5，十六进制小写",
            "example": "e99a18c428cb38d5f260853678922e03"
          },
          "blocks": {
            "minimum": 1,
            "type": "integer",
            "description": "分片总数，一般取 ceil(fileSize / blockSize)，blockSize 来自 token 接口",
            "format": "int64",
            "example": 11
          },
          "size": {
            "minimum": 1,
            "type": "integer",
            "description": "文件总字节数",
            "format": "int64",
            "example": 10616832
          },
          "name": {
            "type": "string",
            "description": "原始文件名",
            "example": "photo.jpg"
          },
          "metadata": {
            "type": "string",
            "description": "元数据（可选）"
          },
          "customPrefix": {
            "type": "string",
            "description": "自定义存储前缀（可选）"
          },
          "customFilename": {
            "type": "string",
            "description": "自定义文件名（可选）"
          }
        },
        "description": "分片任务初始化参数语义说明（与 `POST …/block/upload/init` 的 **query** 一致；非 JSON body）。"
      },
      "asset_OusCosBlockUploadPartForm": {
        "required": [
          "block",
          "file"
        ],
        "type": "object",
        "properties": {
          "block": {
            "minimum": 1,
            "type": "integer",
            "description": "当前分片序号，从 1 开始，不超过 init 时传入的 blocks",
            "format": "int32",
            "example": 1
          },
          "file": {
            "type": "string",
            "description": "本分片的二进制内容",
            "format": "binary"
          }
        },
        "description": "`multipart/form-data`：字段 `block` + `file`"
      },
      "asset_OusV2UploadTaskStatus": {
        "type": "integer",
        "description": "OUS 轮询 `GET /ous/api/v2/upload/status` 时从 `d.status` 读取（或分片子任务中同类字段）。\n\n**判定建议**：`5` 为上传成功终态，可安全使用 `url`；`6` 与 `8` 为失败/中止终态，应结束轮询；其余为非终态，需按间隔继续轮询。\n\n| 值 | 含义 | 终态 |\n|---|---|---|\n| 0 | 草稿 | 否 |\n| 1 | 基础检测完成 | 否 |\n| 2 | 内容检测完成 | 否 |\n| 3 | 排队上传 | 否 |\n| 4 | 上传中 | 否 |\n| 5 | 上传成功 | **是** |\n| 6 | 上传失败 | **是** |\n| 7 | 审核中 | 否 |\n| 8 | 手动中止 | **是** |",
        "format": "int32",
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6,
          7,
          8
        ]
      },
      "asset_OusV2BusinessErrorCode": {
        "type": "integer",
        "description": "当接口返回非成功或 `d` 中携带子码时，可据此做重试/提示/埋点。具体字段名以各接口响应体为准（如分片态中的 `errorCode`）。\n\n| errorCode | 含义 | 处理建议/提示 |\n|---|---|---|\n| 1 | 配置错误 | 配置不存在或未开启，检查上传配置/业务侧引导 |\n| 2 | 文件大小异常 | 提示检查文件大小与分片/阈值设置 |\n| 3 | 文件格式异常 | 提示更换格式或重试 |\n| 4 | 文件内容异常 | 提示更换文件内容 |\n| 5 | 内容安全检测未通过 | 图片/音频安全校验失败，提示用户更换素材 |\n| 6 | 上传限制 | 同时上传任务数量超限/并发过高，退避后重试 |\n| 7 | 文件上传中 | 请稍后重试或继续轮询 |\n| 8 | 分片操作失败 | 分片初始化/传输失败，可重试分片或重新发起任务 |\n| 9 | 服务器上传限制 | 服务端忙，退避后重试 |\n| 10 | 线程池满 | 退避后重试 |\n| 11 | 元数据超限 | 元信息过大，请精简后重试 |\n| 12 | Token 异常 | Token 已使用或未绑定任务，需重新走获取 token/初始化流程 |\n| 13 | 任务异常 | 任务不存在或已结束，需新建任务重试 |",
        "format": "int32",
        "enum": [
          1,
          2,
          3,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          12,
          13
        ]
      },
      "asset_OusV2BlockInitData": {
        "required": [
          "taskId"
        ],
        "type": "object",
        "properties": {
          "taskId": {
            "type": "integer",
            "description": "任务 id；后续轮询 status 与 token 已绑定。",
            "format": "int64",
            "example": 123456789
          },
          "lackBlocks": {
            "type": "array",
            "description": "缺失分片序号（从 1 起；连续区间写作 `a-b`）；非续传场景为 `null`。",
            "nullable": true,
            "items": {
              "type": "string",
              "example": "1-3"
            }
          },
          "progress": {
            "type": "number",
            "description": "上传进度 [0.0, 1.0]；非续传场景为 `null`。",
            "format": "double",
            "nullable": true,
            "example": 0.6
          },
          "deduplicated": {
            "type": "boolean",
            "description": "是否命中去重：为 `true` 时文件已存在，无需再传分片，直接轮询 `status`。",
            "nullable": true,
            "example": false
          }
        },
        "description": "分片上传初始化结果（V2）。"
      },
      "asset_OusV2BlockInitApiResponse": {
        "required": [
          "c",
          "d"
        ],
        "type": "object",
        "properties": {
          "c": {
            "type": "string",
            "description": "业务状态码，成功为 `0`。",
            "example": "0"
          },
          "m": {
            "type": "string",
            "description": "提示信息；可为空字符串。",
            "example": ""
          },
          "d": {
            "$ref": "#/components/schemas/asset_OusV2BlockInitData"
          }
        },
        "description": "分片初始化接口 200 响应体（`c` 为 `0` 时 `d` 为分片任务信息）。"
      },
      "asset_OusV2SingleUploadData": {
        "required": [
          "taskId"
        ],
        "type": "object",
        "properties": {
          "taskId": {
            "type": "string",
            "description": "上传任务 id；后续轮询 `status` 与 token 已绑定。",
            "example": "task_id"
          }
        },
        "description": "单文件上传成功时返回。"
      },
      "asset_OusV2SingleUploadApiResponse": {
        "required": [
          "c",
          "d"
        ],
        "type": "object",
        "properties": {
          "c": {
            "type": "string",
            "description": "业务状态码，成功为 `0`。",
            "example": "0"
          },
          "m": {
            "type": "string",
            "description": "提示信息；可为空字符串。",
            "example": ""
          },
          "d": {
            "$ref": "#/components/schemas/asset_OusV2SingleUploadData"
          }
        },
        "description": "单文件上传 200 响应体（`c` 为 `0` 时 `d` 含 taskId）。"
      },
      "asset_OusV2BlockPartApiResponse": {
        "required": [
          "c",
          "d"
        ],
        "type": "object",
        "properties": {
          "c": {
            "type": "string",
            "description": "业务状态码，成功为 `0`。",
            "example": "0"
          },
          "m": {
            "type": "string",
            "description": "提示信息；可为空字符串。"
          },
          "d": {
            "description": "成功时 `d` 为 `null`。",
            "nullable": true
          }
        },
        "description": "分片上传 part 成功响应；`c` 为 0 时 `d` 为 null。并发过高等失败见 `OusV2BusinessErrorCode`（如 6）。"
      },
      "asset_OusV2StatusPollDataSingle": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/asset_OusV2UploadTaskStatus"
          },
          "uploadKey": {
            "type": "string",
            "description": "对象键路径。",
            "example": "heihei/2026/02/03/NGA5S6IKBIDN3RSQAAAAAAA8.jpg"
          },
          "url": {
            "type": "string",
            "description": "资源可访问 URL。",
            "format": "uri"
          },
          "md5": {
            "type": "string",
            "description": "文件 MD5，十六进制小写。"
          },
          "obsTaskId": {
            "type": "string",
            "description": "OUS 侧任务/对象标识。",
            "example": "3FO4K029K4A3"
          }
        },
        "description": "**单文件上传**任务轮询 `status` 时 `d` 的常见形态。`status` 含义见 `OusV2UploadTaskStatus`。"
      },
      "asset_OusV2StatusBlockProgress": {
        "type": "object",
        "properties": {
          "obsId": {
            "type": "string",
            "description": "分片子任务 id。"
          },
          "status": {
            "$ref": "#/components/schemas/asset_OusV2UploadTaskStatus"
          },
          "progressPercent": {
            "type": "integer",
            "description": "进度百分比。",
            "format": "int32",
            "example": 100
          },
          "lackBlocks": {
            "type": "array",
            "description": "仍缺的分片（编码规则同 init）。",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "分片上传聚合进度（嵌套在 d.blockUpload 中）。`status` 含义见 `OusV2UploadTaskStatus`。"
      },
      "asset_OusV2StatusPollDataBlock": {
        "type": "object",
        "properties": {
          "obsTaskId": {
            "type": "string",
            "description": "任务 id。"
          },
          "status": {
            "$ref": "#/components/schemas/asset_OusV2UploadTaskStatus"
          },
          "uploadKey": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "md5": {
            "type": "string"
          },
          "errorCode": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/asset_OusV2BusinessErrorCode"
              }
            ]
          },
          "errorMsg": {
            "type": "string",
            "nullable": true
          },
          "blockUpload": {
            "$ref": "#/components/schemas/asset_OusV2StatusBlockProgress"
          },
          "errorInfo": {
            "type": "string",
            "description": "错误详情扩展；可为 null。",
            "nullable": true
          }
        },
        "description": "**分片上传**任务轮询 `status` 时 `d` 的常见形态。`status` / `errorCode` 含义见 `OusV2UploadTaskStatus`、`OusV2BusinessErrorCode`。"
      },
      "asset_OusV2UploadStatusApiResponse": {
        "required": [
          "c",
          "d"
        ],
        "type": "object",
        "properties": {
          "c": {
            "type": "string",
            "description": "业务状态码，成功为 `0`。",
            "example": "0"
          },
          "m": {
            "type": "string",
            "description": "提示信息；可为空字符串。"
          },
          "d": {
            "description": "与单文件/分片任务形态二选一，见 `oneOf`。",
            "oneOf": [
              {
                "$ref": "#/components/schemas/asset_OusV2StatusPollDataSingle"
              },
              {
                "$ref": "#/components/schemas/asset_OusV2StatusPollDataBlock"
              }
            ]
          }
        },
        "description": "查询上传状态（轮询）响应；`d` 为单文件或分片结果结构之一。`d.status` 见 `OusV2UploadTaskStatus`。"
      },
      "world_CreateWorldRequest": {
        "required": [
          "resources",
          "scene",
          "taskQuality"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "世界展示名称",
            "example": "客厅重建"
          },
          "cover": {
            "type": "string",
            "description": "封面图 URL；可选",
            "example": "https://cdn.example.com/cover/custom-cover.jpg"
          },
          "resources": {
            "minItems": 1,
            "type": "array",
            "description": "输入资源列表，至少 1 条。格式见 CreateWorldRequest 说明（image：.jpg / .jpeg / .png / .webp；video：.mp4 / .mov；insv：.insv。）。含图片时须至少 20 条图片类（`type=image` 或省略 type）；纯视频请显式 `type=video`；Insta360 全景视频请显式 `type=insv`。",
            "items": {
              "$ref": "#/components/schemas/world_WorldResourceItem"
            }
          },
          "useMask": {
            "type": "boolean",
            "description": "是否对上传资源进行抠图。`true` 开启；省略或 `false` 不抠图。",
            "example": false
          },
          "taskQuality": {
            "$ref": "#/components/schemas/world_WorldOpenApiTaskQuality"
          },
          "scene": {
            "$ref": "#/components/schemas/world_WorldOpenApiProjectScene"
          }
        },
        "description": "创建 3DGS 世界重建任务的请求体。`scene` 仅支持 model 与 space；`taskQuality` 含义见 `WorldOpenApiTaskQuality`（low 极速预览 / normal 标准 / high 专业）。\n**资源格式**：image：.jpg / .jpeg / .png / .webp；video：.mp4 / .mov；insv：.insv。\n**资源条数**：若 `resources` 中出现图片类资源（`type=image` 或省略 `type`，后者按图片计），则图片类至少 **20 条**；若仅使用视频或 Insta360 全景视频，请为每条资源设置 `type=video` 或 `type=insv`（不触发「至少 20 张图」规则）。"
      },
      "world_WorldOpenApiProjectScene": {
        "type": "string",
        "description": "项目场景类型。model：物体场景；space：空间场景。",
        "example": "space",
        "enum": [
          "model",
          "space"
        ]
      },
      "world_WorldOpenApiResourceType": {
        "type": "string",
        "description": "输入资源类型。image：图片，支持 .jpg / .jpeg / .png / .webp；video：普通视频，支持 .mp4 / .mov；insv：Insta360 全景视频，支持 .insv。",
        "example": "image",
        "enum": [
          "image",
          "video",
          "insv"
        ]
      },
      "world_WorldOpenApiTaskQuality": {
        "type": "string",
        "description": "3DGS 重建任务质量档位。low：极速预览；normal：标准；high：专业。",
        "example": "high",
        "enum": [
          "low",
          "normal",
          "high"
        ]
      },
      "world_WorldResourceItem": {
        "required": [
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "minLength": 1,
            "type": "string",
            "description": "资源地址 URL；扩展名须与 `type` 一致（image：.jpg / .jpeg / .png / .webp；video：.mp4 / .mov；insv：.insv。）。",
            "example": "https://cdn.example.com/input/room-001.jpg"
          },
          "type": {
            "$ref": "#/components/schemas/world_WorldOpenApiResourceType"
          }
        },
        "description": "重建任务单条输入资源。未传 `type` 按图片计；普通视频传 `video`；Insta360 全景视频传 `insv`。image：.jpg / .jpeg / .png / .webp；video：.mp4 / .mov；insv：.insv。"
      },
      "world_WorldAsyncOperation": {
        "required": [
          "worldId"
        ],
        "type": "object",
        "properties": {
          "worldId": {
            "type": "string",
            "description": "世界 id；填入 `GET /world/v1/{worldId}` 的路径参数即可轮询任务状态与产出。",
            "example": "A1b2C3d4E5"
          }
        },
        "description": "异步创建受理结果：封装 `worldId`，供调用方作为资源 id 请求详情直至终态。"
      },
      "world_ApiError": {
        "required": [
          "code",
          "details",
          "message",
          "status"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "HTTP状态码",
            "format": "int32",
            "example": 403
          },
          "message": {
            "type": "string",
            "description": "面向开发者的错误消息（英文），用户可见的本地化消息请使用localizedMessage字段",
            "example": "Permission denied to access this resource"
          },
          "status": {
            "$ref": "#/components/schemas/world_Code"
          },
          "details": {
            "$ref": "#/components/schemas/world_ErrorDetails"
          },
          "localizedMessage": {
            "$ref": "#/components/schemas/world_LocalizedMessage"
          },
          "help": {
            "$ref": "#/components/schemas/world_Help"
          }
        },
        "description": "API错误响应对象，包含完整的错误信息、状态码和帮助信息"
      },
      "world_Code": {
        "type": "string",
        "description": "REST API标准状态码，符合Google API设计规范，用于统一的错误码表示",
        "example": "PERMISSION_DENIED",
        "enum": [
          "OK",
          "CANCELLED",
          "UNKNOWN",
          "INVALID_ARGUMENT",
          "DEADLINE_EXCEEDED",
          "NOT_FOUND",
          "ALREADY_EXISTS",
          "PERMISSION_DENIED",
          "UNAUTHENTICATED",
          "RESOURCE_EXHAUSTED",
          "FAILED_PRECONDITION",
          "ABORTED",
          "OUT_OF_RANGE",
          "UNIMPLEMENTED",
          "INTERNAL",
          "UNAVAILABLE",
          "DATA_LOSS",
          "PARTIAL_ELEMENT_UPDATE_FAILED"
        ]
      },
      "world_ErrorDetails": {
        "required": [
          "reason"
        ],
        "type": "object",
        "properties": {
          "reason": {
            "maxLength": 63,
            "pattern": "[A-Z][A-Z0-9_]+[A-Z0-9]",
            "type": "string",
            "description": "错误原因标识符，使用大写蛇形命名法（UPPER_SNAKE_CASE），最多63个字符",
            "example": "RESOURCE_NOT_FOUND"
          },
          "message": {
            "type": "string",
            "description": "针对此错误的人类可读说明，提供具体的错误上下文",
            "nullable": true,
            "example": "The requested design with ID 12345 does not exist"
          },
          "domain": {
            "type": "string",
            "description": "错误域，通常是生成错误的服务名称",
            "nullable": true,
            "example": "restapi.qunhe.com"
          },
          "metaData": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "description": "错误的附加元数据，键值对格式，键最多64个字符，符合模式 /[a-zA-Z0-9-_]/",
              "nullable": true,
              "example": "{\"instanceLimitPerRequest\":\"100\",\"currentInstanceCount\":\"150\"}"
            },
            "description": "错误的附加元数据，键值对格式，键最多64个字符，符合模式 /[a-zA-Z0-9-_]/",
            "nullable": true,
            "example": {
              "instanceLimitPerRequest": "100",
              "currentInstanceCount": "150"
            }
          }
        },
        "description": "错误详情对象，提供错误的详细上下文信息，包括原因、域和元数据"
      },
      "world_Help": {
        "required": [
          "desc",
          "url"
        ],
        "type": "object",
        "properties": {
          "desc": {
            "type": "string",
            "description": "链接内容的描述，说明此帮助文档的用途",
            "example": "如何解决权限拒绝错误"
          },
          "url": {
            "type": "string",
            "description": "帮助文档的URL链接",
            "example": "https://docs.example.com/errors/permission-denied"
          }
        },
        "description": "帮助信息对象，提供解决错误的文档链接和说明",
        "nullable": true
      },
      "world_LocalizedMessage": {
        "required": [
          "locale",
          "message"
        ],
        "type": "object",
        "properties": {
          "locale": {
            "type": "string",
            "description": "消息的语言环境标识",
            "example": "zh_CN"
          },
          "message": {
            "type": "string",
            "description": "本地化后的错误消息文本，面向最终用户",
            "example": "您没有访问此资源的权限"
          }
        },
        "description": "本地化消息对象，提供特定语言环境的错误消息",
        "nullable": true
      },
      "world_WorldListQueryRequest": {
        "type": "object",
        "properties": {
          "pageNum": {
            "minimum": 0,
            "type": "integer",
            "description": "页码（从 0 起）。",
            "format": "int32",
            "example": 0
          },
          "pageSize": {
            "maximum": 100,
            "minimum": 0,
            "type": "integer",
            "description": "每页条数，最大 100；为 0 或未传时按 20 条计。",
            "format": "int32",
            "example": 20
          },
          "statusList": {
            "type": "array",
            "description": "按重建任务状态过滤；为空表示不按状态过滤。",
            "items": {
              "$ref": "#/components/schemas/world_WorldOpenApiTaskStatus"
            }
          }
        },
        "description": "分页查询「我的世界」列表的请求体：`pageNum` 从 0 起；`pageSize` 为每页条数（1–100，缺省或 0 时按 20 条计）。仅查询当前账号下的 3DGS 世界数据。"
      },
      "world_WorldOpenApiTaskStatus": {
        "type": "string",
        "description": "重建任务状态。**进行中**：`PENDING` 排队中；`PREPROCESSING` 预处理中；`RUNNING` 执行中。**终态**：`SUCCEEDED` 成功；`FAILED` 失败；`CANCELED` 取消；`TIMEOUT` 超时；`REJECTED` 被拒绝。",
        "example": "SUCCEEDED",
        "enum": [
          "PENDING",
          "PREPROCESSING",
          "RUNNING",
          "SUCCEEDED",
          "FAILED",
          "CANCELED",
          "TIMEOUT",
          "REJECTED"
        ]
      },
      "world_SplatFileUrls": {
        "type": "object",
        "properties": {
          "plyPath": {
            "type": "string",
            "description": "PLY 文件 URL（output.plyPath）。",
            "example": "https://cdn.example.com/output/world-001.ply"
          },
          "spzPath": {
            "type": "string",
            "description": "SPZ 文件 URL（output.spzPath）。",
            "example": "https://cdn.example.com/output/world-001.spz"
          },
          "lodMetaPath": {
            "type": "string",
            "description": "LOD 分块元数据文件下载 URL（output.lodMetaPath）。任务成功且已完成 LOD 后处理时存在，否则为 null。",
            "example": "https://cdn.example.com/output/world-001-lod-meta.json"
          }
        },
        "description": "3DGS Splat 相关产物的下载地址：PLY / SPZ 与可选的 LOD 分块元数据（对应任务 output 的同名字段）。"
      },
      "world_WorldAssetBundle": {
        "type": "object",
        "properties": {
          "splats": {
            "$ref": "#/components/schemas/world_WorldSplatBundle"
          },
          "imagery": {
            "$ref": "#/components/schemas/world_WorldImagery"
          },
          "semanticsMetadata": {
            "$ref": "#/components/schemas/world_WorldSemanticsMetadata"
          }
        },
        "description": "世界产物容器。3D 重建任务成功时填充 `splats`（ply/spz/lodMetaPath 在 `splats.urls` 中）；AI 生成任务另在 `imagery.panoUrl` 返回全景图下载地址。"
      },
      "world_WorldDetail": {
        "required": [
          "worldId"
        ],
        "type": "object",
        "properties": {
          "worldId": {
            "type": "string",
            "description": "世界唯一标识；开放「创建世界」接口在 `WorldAsyncOperation.worldId` 字段中返回与本字段相同的值。",
            "example": "A1b2C3d4E5"
          },
          "name": {
            "type": "string",
            "description": "世界名称",
            "example": "客厅重建"
          },
          "cover": {
            "type": "string",
            "description": "封面图 URL。",
            "example": "https://cdn.example.com/cover/world-001.jpg"
          },
          "scene": {
            "$ref": "#/components/schemas/world_WorldOpenApiProjectScene"
          },
          "createTime": {
            "type": "integer",
            "description": "创建时间，Unix 毫秒时间戳。",
            "format": "int64",
            "example": 1699339916000
          },
          "updateTime": {
            "type": "integer",
            "description": "最近修改时间，Unix 毫秒时间戳。",
            "format": "int64",
            "example": 1699340120000
          },
          "status": {
            "$ref": "#/components/schemas/world_WorldOpenApiTaskStatus"
          },
          "progress": {
            "type": "number",
            "description": "重建任务进度 [0.0, 1.0]。",
            "format": "float",
            "example": 0.65
          },
          "assets": {
            "$ref": "#/components/schemas/world_WorldAssetBundle"
          }
        },
        "description": "世界信息。`worldId` 为业务侧世界唯一标识；`scene`/`status` 等为约定字符串；`createTime` / `updateTime` 为 Unix 毫秒时间戳（与 1.6.2-2-1 时间字段约定一致）。详情接口在产出可用时，可能返回 splat 等下载地址；AI 生成世界另在 `assets.imagery.panoUrl` 返回全景图。"
      },
      "world_WorldImagery": {
        "type": "object",
        "properties": {
          "panoUrl": {
            "type": "string",
            "description": "AI 生成全景图下载地址。仅 AI 生成（Spatial Gen）世界在全景图子任务成功后有值。",
            "example": "https://cdn.example.com/output/world-001-pano.jpg"
          }
        },
        "description": "AI 生成世界的图片产物；当前仅包含全景图下载地址。"
      },
      "world_WorldOpenApiUpAxis": {
        "type": "string",
        "description": "世界坐标 up 轴。Y：+Y 朝上（glTF/USD 默认）；Z：+Z 朝上（本服务 3DGS 产出约定）。",
        "example": "Z",
        "enum": [
          "Y",
          "Z"
        ]
      },
      "world_WorldPagedList": {
        "type": "object",
        "properties": {
          "pageNum": {
            "type": "integer",
            "description": "本次请求使用的页码（从 0 起）。",
            "format": "int32",
            "example": 0
          },
          "pageSize": {
            "type": "integer",
            "description": "本次请求使用的每页条数。",
            "format": "int32",
            "example": 20
          },
          "count": {
            "type": "integer",
            "description": "当前页记录条数。",
            "format": "int32",
            "example": 20
          },
          "totalCount": {
            "type": "integer",
            "description": "符合筛选条件的总记录数。",
            "format": "int32",
            "example": 128
          },
          "hasMore": {
            "type": "boolean",
            "description": "是否还有下一页。",
            "example": false
          },
          "result": {
            "type": "array",
            "description": "当前页的世界记录列表（由 ProjectAggregateDTO 映射为 WorldOpen，列表查询默认 withResult=false）。",
            "items": {
              "$ref": "#/components/schemas/world_WorldDetail"
            }
          }
        },
        "description": "世界列表分页结果：含本次请求的 `pageNum` / `pageSize`，以及当前页数据与总计。"
      },
      "world_WorldSemanticsMetadata": {
        "type": "object",
        "properties": {
          "upAxis": {
            "$ref": "#/components/schemas/world_WorldOpenApiUpAxis"
          }
        },
        "description": "语义元数据（相机位姿、比例、偏移、坐标系约定等）。任务成功且返回 splat 产物时，应包含 upAxis 以标明坐标系。"
      },
      "world_WorldSplatBundle": {
        "type": "object",
        "properties": {
          "urls": {
            "$ref": "#/components/schemas/world_SplatFileUrls"
          }
        },
        "description": "3DGS splat 输出文件集合。"
      },
      "world_GenerateWorldRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "项目 / 世界展示名称",
            "example": "客厅生成"
          },
          "cover": {
            "type": "string",
            "description": "封面图 URL；可选。",
            "example": "https://cdn.example.com/cover/gen-cover.jpg"
          },
          "resources": {
            "type": "array",
            "description": "输入资源列表；与 prompt 至少满足其一。仅支持图片，至多 1 条；未传 type 时按图片处理。image：.jpg / .jpeg / .png / .webp。",
            "items": {
              "$ref": "#/components/schemas/world_GenerateWorldResourceItem"
            }
          },
          "prompt": {
            "type": "string",
            "description": "文本提示词；可与 resources 同时提供。",
            "example": "现代简约风格，阳光充足的客厅"
          }
        },
        "description": "创建 3DGS「生成世界」任务的请求体；支持纯文案、单张图片或图文组合。室内场景效果更成熟；非室内为 Beta（详见同路径 POST 说明）。\n至少需提供非空 prompt 或至少一条图片资源（至多 1 张）；image：.jpg / .jpeg / .png / .webp。"
      },
      "world_GenerateWorldResourceItem": {
        "required": [
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "minLength": 1,
            "type": "string",
            "description": "图片资源 URL；扩展名须为 image：.jpg / .jpeg / .png / .webp。",
            "example": "https://cdn.example.com/input/room.jpg"
          },
          "type": {
            "$ref": "#/components/schemas/world_WorldOpenApiGenResourceType"
          }
        },
        "description": "生成任务单条输入资源（图片）。未传 `type` 时按图片处理。image：.jpg / .jpeg / .png / .webp。"
      },
      "world_WorldOpenApiGenResourceType": {
        "type": "string",
        "description": "生成任务输入资源类型，仅支持 image（图片），支持 .jpg / .jpeg / .png / .webp。",
        "example": "image",
        "enum": [
          "image"
        ]
      },
      "lux3d_HumanoidAutoRigRequest": {
        "type": "object",
        "required": [
          "modelUrl"
        ],
        "properties": {
          "modelUrl": {
            "type": "string",
            "format": "uri",
            "description": "GLB 模型的公网 HTTPS URL。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。"
          }
        }
      },
      "lux3d_HumanoidAnimationRetargetRequest": {
        "type": "object",
        "required": [
          "rigModelUrl",
          "animationIds"
        ],
        "properties": {
          "rigModelUrl": {
            "type": "string",
            "format": "uri",
            "description": "已绑骨 GLB 模型的公网 HTTPS URL。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/application/octetstream/1790240555913/rigModel.glb"
          },
          "animationIds": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "enum": [
                "A_TPose",
                "Dance_Loop",
                "Idle_Rail_Call",
                "Idle_TalkingPhone_Loop",
                "Idle_Talking_Loop",
                "Yes",
                "Crouch_Idle_Loop",
                "Idle_FoldArms_Loop",
                "Idle_Lantern_Loop",
                "Idle_Loop",
                "Idle_No_Loop",
                "Idle_Rail_Loop",
                "Idle_Torch_Loop",
                "ClimbUp_1m",
                "Crouch_Fwd_Loop",
                "Jog_Fwd_Loop",
                "Sprint_Loop",
                "Swim_Fwd_Loop",
                "Swim_Idle_Loop",
                "Walk_Formal_Loop",
                "Walk_Loop",
                "Jump_Land",
                "Jump_Loop",
                "Jump_Start",
                "NinjaJump_Idle_Loop",
                "NinjaJump_Land",
                "NinjaJump_Start",
                "Roll",
                "Slide_Exit",
                "Slide_Loop",
                "Slide_Start",
                "Sword_Attack",
                "Sword_Block",
                "Sword_Dash",
                "Sword_Heavy_Combo",
                "Sword_Idle",
                "Sword_Regular_A",
                "Sword_Regular_A_Rec",
                "Sword_Regular_B",
                "Sword_Regular_B_Rec",
                "Sword_Regular_C",
                "Sword_Regular_Combo",
                "Idle_Shield_Break",
                "Idle_Shield_Loop",
                "Shield_Dash",
                "Shield_OneShot",
                "Melee_Hook",
                "Melee_Hook_Rec",
                "Punch_Cross",
                "Punch_Jab",
                "Pistol_Aim_Down",
                "Pistol_Aim_Neutral",
                "Pistol_Aim_Up",
                "Pistol_Idle_Loop",
                "Pistol_Reload",
                "Pistol_Shoot",
                "Spell_Simple_Enter",
                "Spell_Simple_Exit",
                "Spell_Simple_Idle_Loop",
                "Spell_Simple_Shoot",
                "Chest_Open",
                "Consume",
                "Driving_Loop",
                "Farm_Harvest",
                "Farm_PlantSeed",
                "Farm_Watering",
                "Fixing_Kneeling",
                "Interact",
                "OverhandThrow",
                "PickUp_Table",
                "Push_Loop",
                "TreeChopping_Loop",
                "Walk_Carry_Loop",
                "LayToIdle",
                "Sitting_Enter",
                "Sitting_Exit",
                "Sitting_Idle_Loop",
                "Sitting_Talking_Loop",
                "Death01",
                "Hit_Chest",
                "Hit_Head",
                "Hit_Knockback",
                "Zombie_Idle_Loop",
                "Zombie_Scratch",
                "Zombie_Walk_Fwd_Loop"
              ]
            },
            "description": "动作 ID 列表，从以下 85 个可选值中选择 1–10 个，不可重复，区分大小写。"
          },
          "animationOutputMode": {
            "type": "string",
            "enum": [
              "separate",
              "combined"
            ],
            "default": "separate",
            "description": "separate 为每个动作生成一个完整文件；combined 将所选动作合并到一个文件，每个动作保留为独立动画片段。"
          },
          "outFormat": {
            "type": "string",
            "enum": [
              "glb",
              "fbx"
            ],
            "default": "glb",
            "description": "输出文件格式。"
          },
          "animateInPlace": {
            "type": "boolean",
            "default": false,
            "description": "是否生成原地动画。"
          }
        }
      },
      "lux3d_MultimodalToImageRequest": {
        "type": "object",
        "properties": {
          "img": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "单张参考图片 URL，可单独使用或与 prompt 组合。img 和 prompt 至少提供一个，传入的值不能为空白。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg"
          },
          "prompt": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "图片生成提示词，可单独使用或与 img 组合。img 和 prompt 至少提供一个，传入的值不能为空白。",
            "example": "把椅子改成浅色原木材质，保持造型和视角"
          }
        },
        "description": "多模态单图生成请求体，img 和 prompt 至少提供一个，支持纯图片、纯文字或图文组合输入。"
      },
      "lux3d_ImageToFourViewRequest": {
        "type": "object",
        "properties": {
          "img": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "单张图片 URL。img 和 prompt 至少提供一个，传入的值不能为空白。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg"
          },
          "prompt": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "文字提示词，可单独用于纯文字生成四视图，也可与 img 组合使用。img 和 prompt 至少提供一个，传入的值不能为空白。",
            "example": "一把现代简约浅色原木餐椅，纯白背景"
          }
        },
        "description": "多模态四视图请求体，img 和 prompt 至少提供一个，支持纯图片、纯文字或图文组合输入。"
      },
      "lux3d_ImgTo3dRequest": {
        "type": "object",
        "properties": {
          "img": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "单张图片 URL，G1 和 G1-Turbo 均支持。img 与 imgs 必须且只能提供一个，图片 URL 不能为空白。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg"
          },
          "imgs": {
            "type": "array",
            "minItems": 1,
            "maxItems": 32,
            "items": {
              "type": "string",
              "minLength": 1,
              "pattern": ".*\\S.*"
            },
            "description": "G1 / G1-Turbo 的 1-32 张图片 URL。保留输入顺序，第一张图作为主要参考；与 img 互斥。使用 imgs 时必须显式传入 version=G1 或 version=G1-Turbo。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": [
              "https://qhstaticssl.kujiale.com/image/png/1784775590866/multiview_input_1.png",
              "https://qhstaticssl.kujiale.com/image/png/1784775591151/multiview_input_2.png"
            ]
          },
          "version": {
            "type": "string",
            "description": "生成版本，支持 G1 和 G1-Turbo。省略时使用默认版本；建议显式传入。",
            "enum": [
              "G1",
              "G1-Turbo"
            ],
            "example": "G1"
          },
          "faceCount": {
            "type": "integer",
            "description": "目标 Mesh 面数，取值范围为 10000-300000，默认 300000；PLY 输出不受此参数影响。",
            "minimum": 10000,
            "maximum": 300000,
            "example": 300000
          },
          "outputFormat": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "zip",
                "glb",
                "ply"
              ]
            },
            "description": "请求的输出格式。G1 固定返回 ZIP 和 GLB，请求包含 ply 时额外返回 PLY；G1-Turbo 返回指定格式，省略或传空数组时返回 ZIP。",
            "example": [
              "zip",
              "glb"
            ]
          },
          "enablePbr": {
            "type": "boolean",
            "description": "仅对 G1-Turbo 包含 Mesh 的请求生效：true 或省略时生成 PBR Mesh，false 生成白模；不决定输出格式。G1 及仅请求 PLY 时忽略。",
            "default": true
          },
          "aiPredictSize": {
            "type": "boolean",
            "description": "省略或 true 会启用 AI 尺寸预测与缩放，false 关闭。"
          }
        },
        "description": "图生 3D 请求体，支持 G1 和 G1-Turbo，可使用 img 单图或 imgs 多图；img 与 imgs 必须且只能提供一个。使用 imgs 时必须显式传入 version=G1 或 version=G1-Turbo。"
      },
      "lux3d_TextTo3dRequest": {
        "required": [
          "prompt"
        ],
        "type": "object",
        "properties": {
          "prompt": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "文本提示词",
            "example": "生成一个高质量的3D木椅模型"
          },
          "style": {
            "type": "string",
            "description": "生成风格，默认 photorealistic。",
            "enum": [
              "photorealistic",
              "cartoon",
              "anime",
              "hand_painted",
              "cyberpunk",
              "fantasy",
              "glass"
            ],
            "default": "photorealistic",
            "example": "photorealistic"
          },
          "img": {
            "type": "string",
            "description": "可选的参考图片 URL。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/image/jpeg/1784775590613/image_to_3d_model.jpg"
          },
          "version": {
            "type": "string",
            "description": "生成版本，支持 G1 和 G1-Turbo。省略时使用默认版本；建议显式传入。",
            "enum": [
              "G1",
              "G1-Turbo"
            ],
            "example": "G1"
          },
          "faceCount": {
            "type": "integer",
            "description": "目标 Mesh 面数，取值范围为 10000-300000，默认 300000；PLY 输出不受此参数影响。",
            "minimum": 10000,
            "maximum": 300000,
            "example": 300000
          },
          "outputFormat": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "zip",
                "glb",
                "ply"
              ]
            },
            "description": "请求的输出格式。G1 固定返回 ZIP 和 GLB，请求包含 ply 时额外返回 PLY；G1-Turbo 返回指定格式，省略或传空数组时返回 ZIP。",
            "example": [
              "zip",
              "glb"
            ]
          },
          "enablePbr": {
            "type": "boolean",
            "description": "仅对 G1-Turbo 包含 Mesh 的请求生效：true 或省略时生成 PBR Mesh，false 生成白模；不决定输出格式。G1 及仅请求 PLY 时忽略。",
            "default": true
          },
          "aiPredictSize": {
            "type": "boolean",
            "description": "省略或 true 会启用 AI 尺寸预测与缩放，false 关闭。"
          }
        },
        "description": "文生 3D 请求体，支持 G1 和 G1-Turbo，可选提供一张 img 参考图。"
      },
      "lux3d_MaterialTransferRequest": {
        "required": [
          "img",
          "meshUrl",
          "version"
        ],
        "type": "object",
        "properties": {
          "img": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "材质参考图片 URL。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/image/png/1784776951878/material_transfer_input.png"
          },
          "meshUrl": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "模型 GLB 文件 URL。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://qhstaticssl.kujiale.com/application/octetstream/1784776896628/material_transfer_model.glb"
          },
          "version": {
            "type": "string",
            "description": "必填，当前固定传 v3.0-standard。",
            "enum": [
              "v3.0-standard"
            ],
            "example": "v3.0-standard"
          },
          "outputFormat": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "zip",
                "glb",
                "usdz",
                "obj_zip",
                "fbx_zip"
              ]
            },
            "description": "请求的输出格式：zip、glb、usdz、obj_zip 或 fbx_zip。",
            "example": [
              "zip",
              "glb"
            ]
          },
          "aiPredictSize": {
            "type": "boolean",
            "description": "是否预测模型尺寸；为 true 时忽略 customSize。"
          },
          "customSize": {
            "type": "number",
            "format": "float",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "aiPredictSize 为 false 或未传时使用的目标高度（mm）；省略时保持原始尺寸。"
          }
        },
        "description": "材质重绘请求体，version 当前固定为 v3.0-standard。"
      },
      "lux3d_PartSplitRequest": {
        "required": [
          "glbUrl"
        ],
        "type": "object",
        "properties": {
          "glbUrl": {
            "minLength": 1,
            "pattern": ".*\\S.*",
            "type": "string",
            "description": "待拆分的 GLB 模型公网 URL，必须可由服务端访问。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段；也可使用仍在有效期内的 Lux3D GLB 任务产物 URL。",
            "example": "https://qhstaticssl.kujiale.com/model/gltfbinary/1790144390549/14B82261CD6DF53FA6B406240E20CB2C.glb"
          }
        },
        "description": "部件拆分任务请求体。"
      },
      "lux3d_MultiFormatExportRequest": {
        "required": [
          "modelUrl"
        ],
        "type": "object",
        "properties": {
          "modelUrl": {
            "minLength": 1,
            "type": "string",
            "description": "模型公网 URL，支持 .zip 或 .glb。ZIP 输入必须来自 Lux3D 生成任务；GLB 输入时 outputFormat 不能为空。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段；其中 ZIP 仍必须是 Lux3D 生成任务产物。",
            "example": "https://qhstaticssl.kujiale.com/application/octetstream/1784776896628/model.glb"
          },
          "outputFormat": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "usdz",
                "obj_zip",
                "fbx_zip",
                "stl",
                "3mf"
              ]
            },
            "description": "可选导出格式，支持单项或组合：usdz、obj_zip、fbx_zip、stl、3mf。outputFormat 不接受 glb。\n- usdz：Apple 生态常用的 AR 模型格式，适用于 iOS、iPadOS 和 Quick Look 等 AR 预览场景。\n- obj_zip：包含 OBJ、MTL 和贴图文件的压缩包，兼容常见 3D 软件和 DCC 工具。\n- fbx_zip：包含 FBX 模型及贴图资源的压缩包，适用于 Maya、3ds Max、Blender 等主流 DCC 工作流。\n- stl：面向 3D 打印和几何交换的网格格式，不包含材质和贴图信息。\n- 3mf：面向 3D 打印的 3D Manufacturing Format，适合需要制造/打印格式交付的场景。\nZIP 输入时可以省略或传空数组；GLB 输入时至少需要一个值。\n",
            "example": [
              "usdz",
              "obj_zip",
              "stl",
              "3mf"
            ]
          }
        },
        "description": "多格式导出任务请求体。"
      },
      "lux3d_ArticulationAnimationRequest": {
        "type": "object",
        "required": [
          "glbUrl",
          "prompt"
        ],
        "additionalProperties": false,
        "properties": {
          "glbUrl": {
            "type": "string",
            "format": "uri",
            "minLength": 1,
            "description": "输入 GLB 模型的公网 HTTP(S) URL，必须可由服务端访问。如需上传本地文件，请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。",
            "example": "https://assets.aholo3d.cn/examples/cubely/joint-motion/target-model.glb"
          },
          "prompt": {
            "type": "string",
            "minLength": 1,
            "pattern": ".*\\S.*",
            "description": "描述需要运动的部件及期望的关节运动方式，不能仅包含空白字符。",
            "example": "保持底座固定，为盖子添加旋转关节，让盖子缓慢打开和闭合。"
          }
        },
        "description": "模型关节化与动画请求。glbUrl 和 prompt 均必填，不接受其他字段。"
      },
      "lux3d_TaskCreateResponse": {
        "type": "object",
        "properties": {
          "f": {
            "type": "object",
            "description": "失败信息；成功时为 null。",
            "nullable": true,
            "additionalProperties": true
          },
          "d": {
            "type": "integer",
            "description": "返回 taskid",
            "format": "int64",
            "example": 1256173,
            "nullable": true
          },
          "m": {
            "type": "string",
            "description": "提示信息；成功时为空字符串 \"\"。",
            "nullable": true
          },
          "c": {
            "type": "string",
            "description": "状态码；成功时为 \"0\"，普通参数错误时为 \"-1\"，部分业务错误使用专用错误码。",
            "nullable": true
          }
        },
        "description": "任务创建响应体。"
      },
      "lux3d_TaskOutput": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "description": "结果文件 URL、JSON 字符串或未请求格式的标记 NOT_REQUESTED。具体格式见“查询生成任务”接口说明。",
            "nullable": true,
            "example": "https://cos.example.com/lux3d/xxx/result.zip"
          }
        },
        "description": "任务输出项。"
      },
      "lux3d_TaskQueryData": {
        "type": "object",
        "properties": {
          "taskId": {
            "type": "integer",
            "description": "任务ID",
            "format": "int64",
            "example": 1389513
          },
          "outputs": {
            "type": "array",
            "description": "任务结果列表，具体格式和顺序见“查询生成任务”接口说明。运行中的任务可能返回部分结果。",
            "items": {
              "$ref": "#/components/schemas/lux3d_TaskOutput"
            }
          },
          "status": {
            "type": "integer",
            "description": "任务状态：0-初始化，1-运行中，3-成功，4-失败，6-已取消。",
            "format": "int32",
            "enum": [
              0,
              1,
              3,
              4,
              6
            ],
            "example": 3
          }
        },
        "description": "任务查询数据。"
      },
      "lux3d_TaskQueryResponse": {
        "type": "object",
        "properties": {
          "f": {
            "type": "object",
            "description": "失败信息；成功时为 null。",
            "nullable": true,
            "additionalProperties": true
          },
          "d": {
            "$ref": "#/components/schemas/lux3d_TaskQueryData"
          },
          "m": {
            "type": "string",
            "description": "提示信息；成功时为空字符串 \"\"。",
            "nullable": true
          },
          "c": {
            "type": "string",
            "description": "状态码；成功时为 \"0\"，普通参数错误时为 \"-1\"。",
            "nullable": true
          }
        },
        "description": "任务查询响应体。"
      },
      "lux3d_TaskListItem": {
        "type": "object",
        "properties": {
          "taskId": {
            "type": "integer",
            "format": "int64",
            "description": "任务 ID"
          },
          "status": {
            "type": "integer",
            "description": "任务状态：0-初始化，1-运行中，3-成功，4-失败，6-已取消。",
            "enum": [
              0,
              1,
              3,
              4,
              6
            ]
          },
          "created": {
            "type": "integer",
            "format": "int64",
            "description": "任务创建时间，Unix 毫秒时间戳"
          },
          "lastModified": {
            "type": "integer",
            "format": "int64",
            "description": "任务最后修改时间，Unix 毫秒时间戳"
          }
        }
      },
      "lux3d_TaskListData": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/lux3d_TaskListItem"
            }
          },
          "total": {
            "type": "integer",
            "description": "符合条件的任务总数"
          },
          "page": {
            "type": "integer",
            "description": "当前页码"
          },
          "pageSize": {
            "type": "integer",
            "description": "每页数量"
          }
        }
      },
      "lux3d_TaskListResponse": {
        "type": "object",
        "properties": {
          "f": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true,
            "description": "失败信息；成功时为 null。"
          },
          "d": {
            "$ref": "#/components/schemas/lux3d_TaskListData"
          },
          "m": {
            "type": "string",
            "nullable": true,
            "description": "提示信息。成功时为空字符串 \"\"。"
          },
          "c": {
            "type": "string",
            "nullable": true,
            "description": "状态码。成功时为 \"0\"，失败时为错误码字符串。"
          }
        },
        "description": "生成记录分页响应体。\n列表接口与创建、查询接口的成功响应一致：f 为 null、c 为 \"0\"、m 为 \"\"（空字符串）。请按 c === \"0\" 判断成功。\n"
      },
      "rendercloud_OfflineRenderSubmitRequest": {
        "type": "object",
        "description": "离线渲染提交请求体。提交时不传 `operationId`。",
        "additionalProperties": false,
        "required": [
          "requestId",
          "usdContent"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "description": "调用方生成的请求追踪标识。服务端不基于该字段做任务幂等。",
            "minLength": 1
          },
          "usdContent": {
            "type": "string",
            "description": "Base64 编码后的 OpenUSD 文本或二进制内容。",
            "minLength": 1
          }
        }
      },
      "rendercloud_OperationPollRequest": {
        "type": "object",
        "description": "长耗时操作轮询请求体。提交成功后，使用返回的 `operationId` 轮询。",
        "additionalProperties": false,
        "required": [
          "operationId"
        ],
        "properties": {
          "operationId": {
            "type": "string",
            "description": "提交响应返回的操作 ID。",
            "minLength": 1
          }
        }
      },
      "rendercloud_OfflineRenderResponse": {
        "type": "object",
        "description": "离线渲染完成结果。仅在 `Operation.done=true` 且任务成功时返回。",
        "additionalProperties": false,
        "properties": {
          "taskId": {
            "type": "string",
            "description": "离线渲染任务 ID。"
          },
          "resultUrl": {
            "type": "string",
            "format": "uri",
            "description": "渲染结果图片地址。"
          }
        }
      },
      "rendercloud_RealtimeSessionSubmitRequest": {
        "type": "object",
        "description": "实时渲染流创建请求体。创建时不传 `operationId`。",
        "additionalProperties": false,
        "required": [
          "requestId",
          "usdContent"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "description": "调用方生成的幂等键。",
            "minLength": 1
          },
          "usdContent": {
            "type": "string",
            "description": "Base64 编码后的 OpenUSD 文本或二进制内容。",
            "minLength": 1
          },
          "settings": {
            "type": "object",
            "description": "可选的实时渲染会话配置。未传时使用服务端默认配置。",
            "additionalProperties": false,
            "properties": {
              "autoEnhanceAI": {
                "type": "boolean",
                "default": false,
                "description": "是否启用 AI 增强。启用后会增加单帧处理延迟。"
              }
            }
          }
        }
      },
      "rendercloud_RealtimeSessionQueryResponse": {
        "type": "object",
        "description": "实时渲染流查询结果。`status=ACTIVE` 时包含 WebSocket 连接参数。",
        "additionalProperties": false,
        "properties": {
          "sessionId": {
            "type": "string",
            "description": "实时渲染流会话 ID。"
          },
          "status": {
            "$ref": "#/components/schemas/rendercloud_RenderCloudSessionStatus"
          },
          "currentQueuePosition": {
            "type": "integer",
            "format": "int32",
            "description": "当前排队位置。为 0 时表示会话已就绪。"
          },
          "host": {
            "type": "string",
            "description": "实时渲染流连接域名。"
          },
          "nodeId": {
            "type": "string",
            "description": "WebSocket 连接 URL 中 `nid` 查询参数的值。"
          },
          "streamId": {
            "type": "string",
            "description": "WebSocket 握手消息中 `slaveInit.masterStreamingId` 的值。"
          },
          "token": {
            "type": "string",
            "description": "建立实时渲染流连接所需的鉴权 token。"
          }
        }
      },
      "rendercloud_RealtimeSessionUpdateRequest": {
        "type": "object",
        "description": "实时渲染流增量更新请求体。",
        "additionalProperties": false,
        "required": [
          "requestId",
          "usdContent"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "description": "调用方生成的幂等键。",
            "minLength": 1
          },
          "usdContent": {
            "type": "string",
            "description": "Base64 编码后的增量 OpenUSD 内容。",
            "minLength": 1
          }
        }
      },
      "rendercloud_RealtimeSessionUpdateResponse": {
        "type": "object",
        "description": "实时渲染流增量更新响应体。",
        "additionalProperties": false,
        "properties": {
          "sessionId": {
            "type": "string",
            "description": "实时渲染流会话 ID。"
          },
          "status": {
            "$ref": "#/components/schemas/rendercloud_RenderCloudSessionStatus"
          }
        }
      },
      "rendercloud_RealtimeSessionCloseResponse": {
        "type": "object",
        "description": "实时渲染流关闭响应体。",
        "additionalProperties": false,
        "properties": {
          "sessionId": {
            "type": "string",
            "description": "实时渲染流会话 ID。"
          },
          "closed": {
            "type": "boolean",
            "description": "是否在服务端找到并关闭了会话。"
          }
        }
      },
      "rendercloud_OfflineRenderProcessingOperation": {
        "type": "object",
        "description": "离线渲染处理中状态。",
        "additionalProperties": false,
        "required": [
          "operationId",
          "metaData",
          "done",
          "result",
          "error"
        ],
        "properties": {
          "operationId": {
            "$ref": "#/components/schemas/rendercloud_OperationId"
          },
          "metaData": {
            "$ref": "#/components/schemas/rendercloud_OperationMetaData"
          },
          "done": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "result": {
            "type": "object",
            "nullable": true,
            "description": "处理中时为 null。"
          },
          "error": {
            "type": "object",
            "nullable": true,
            "description": "处理中时为 null。"
          }
        }
      },
      "rendercloud_OfflineRenderSuccessOperation": {
        "type": "object",
        "description": "离线渲染成功状态。",
        "additionalProperties": false,
        "required": [
          "operationId",
          "metaData",
          "done",
          "result",
          "error"
        ],
        "properties": {
          "operationId": {
            "$ref": "#/components/schemas/rendercloud_OperationId"
          },
          "metaData": {
            "$ref": "#/components/schemas/rendercloud_OperationMetaData"
          },
          "done": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "result": {
            "$ref": "#/components/schemas/rendercloud_OfflineRenderResponse"
          },
          "error": {
            "type": "object",
            "nullable": true,
            "description": "成功时为 null。"
          }
        }
      },
      "rendercloud_RealtimeSessionProcessingOperation": {
        "type": "object",
        "description": "实时渲染流创建处理中状态。",
        "additionalProperties": false,
        "required": [
          "operationId",
          "metaData",
          "done",
          "result",
          "error"
        ],
        "properties": {
          "operationId": {
            "$ref": "#/components/schemas/rendercloud_OperationId"
          },
          "metaData": {
            "$ref": "#/components/schemas/rendercloud_OperationMetaData"
          },
          "done": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "result": {
            "type": "object",
            "nullable": true,
            "description": "处理中时为 null。"
          },
          "error": {
            "type": "object",
            "nullable": true,
            "description": "处理中时为 null。"
          }
        }
      },
      "rendercloud_RealtimeSessionSuccessOperation": {
        "type": "object",
        "description": "实时渲染流创建成功状态。",
        "additionalProperties": false,
        "required": [
          "operationId",
          "metaData",
          "done",
          "result",
          "error"
        ],
        "properties": {
          "operationId": {
            "$ref": "#/components/schemas/rendercloud_OperationId"
          },
          "metaData": {
            "$ref": "#/components/schemas/rendercloud_OperationMetaData"
          },
          "done": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "result": {
            "$ref": "#/components/schemas/rendercloud_RealtimeSessionQueryResponse"
          },
          "error": {
            "type": "object",
            "nullable": true,
            "description": "成功时为 null。"
          }
        }
      },
      "rendercloud_OperationError": {
        "type": "object",
        "description": "长耗时操作失败状态。",
        "additionalProperties": false,
        "required": [
          "operationId",
          "metaData",
          "done",
          "result",
          "error"
        ],
        "properties": {
          "operationId": {
            "$ref": "#/components/schemas/rendercloud_OperationId"
          },
          "metaData": {
            "$ref": "#/components/schemas/rendercloud_OperationMetaData"
          },
          "done": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "result": {
            "type": "object",
            "nullable": true,
            "description": "失败时为 null。"
          },
          "error": {
            "$ref": "#/components/schemas/rendercloud_ApiError"
          }
        }
      },
      "rendercloud_OperationId": {
        "type": "string",
        "description": "长耗时操作 ID。"
      },
      "rendercloud_OperationMetaData": {
        "type": "object",
        "nullable": true,
        "description": "长耗时操作扩展元数据。当前接口通常返回 null。",
        "additionalProperties": true
      },
      "rendercloud_Int2": {
        "type": "object",
        "description": "二维整数向量。用于表示出图分辨率，`x` 为宽，`y` 为高。",
        "additionalProperties": false,
        "required": [
          "x",
          "y"
        ],
        "properties": {
          "x": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "description": "图片宽度，单位为像素。"
          },
          "y": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "description": "图片高度，单位为像素。"
          }
        }
      },
      "rendercloud_RenderCloudSessionStatus": {
        "type": "string",
        "description": "实时渲染流会话状态。\n\n- `INITIALIZING`：会话已创建，后台正在建立 streaming 连接。\n- `ACTIVE`：streaming 连接已建立，可正常渲染。\n- `FAILED`：初始化或操作失败。\n- `CLOSED`：会话已关闭。\n",
        "enum": [
          "RENDER_CLOUD_SESSION_STATUS_UNSPECIFIED",
          "INITIALIZING",
          "ACTIVE",
          "FAILED",
          "CLOSED"
        ]
      },
      "rendercloud_ApiError": {
        "type": "object",
        "description": "OpenAPI 网关标准错误响应。异步操作失败时位于 `Operation.error` 字段内。",
        "additionalProperties": true,
        "required": [
          "code",
          "message",
          "status"
        ],
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "description": "HTTP 语义错误码。",
            "example": 500
          },
          "message": {
            "type": "string",
            "description": "可读错误信息。可能包含网关透传的错误详情。",
            "example": "code: INTERNAL, details: ErrorDetails(reason=INTERNAL_ERROR, message=null, domain=render, metaData=null)"
          },
          "status": {
            "type": "string",
            "description": "标准错误状态。",
            "enum": [
              "INVALID_ARGUMENT",
              "NOT_FOUND",
              "RESOURCE_EXHAUSTED",
              "INTERNAL"
            ],
            "example": "INTERNAL"
          },
          "details": {
            "$ref": "#/components/schemas/rendercloud_ErrorDetails"
          }
        }
      },
      "rendercloud_ErrorDetails": {
        "type": "object",
        "description": "网关透传的扩展错误详情。",
        "additionalProperties": true,
        "properties": {
          "reason": {
            "type": "string",
            "description": "错误原因。",
            "example": "INTERNAL_ERROR"
          },
          "domain": {
            "type": "string",
            "description": "错误归属域名。示例使用通用值，避免暴露内部服务域名。",
            "example": "render"
          }
        }
      },
      "rendercloud_MeshUploadProcessRequest": {
        "type": "object",
        "description": "Mesh 上传解析任务请求体。",
        "additionalProperties": false,
        "properties": {
          "originMeshUrl": {
            "type": "string",
            "format": "uri",
            "description": "原始 Mesh 文件的 URL 地址。当文件地址是云端 URL 时，该 URL 必须能够被公开访问到。如果文件仅保存在本地，推荐先通过 [资产上传](https://labs.aholo.cn/api-docs/api-reference#tag/asset) 上传接口上传文件并取得 URL，再将该 URL 填入此字段。",
            "example": "https://example.com/mesh/original.glb"
          },
          "fastUpload": {
            "type": "boolean",
            "description": "是否启用快速上传，可选，默认 false。当 fastUpload 为 true 且文件为 GLB 格式时，使用快速上传流程；未传或为 false 时使用普通上传流程。",
            "default": false,
            "example": false
          }
        }
      },
      "rendercloud_TaskCreateResponse": {
        "type": "object",
        "description": "任务创建响应体，遵循标准 Result 格式。",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "description": "是否成功。",
            "example": true
          },
          "data": {
            "type": "integer",
            "format": "int64",
            "description": "创建的任务 ID。",
            "example": 1305220918472257500
          },
          "errorMsg": {
            "type": "string",
            "nullable": true,
            "description": "错误信息，成功时为 null。",
            "example": null
          }
        }
      },
      "rendercloud_TaskQueryResponse": {
        "type": "object",
        "description": "任务查询响应体，遵循标准 Result 格式。",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "description": "是否成功。",
            "example": true
          },
          "data": {
            "$ref": "#/components/schemas/rendercloud_AiGenerateBusInstanceOpenDto"
          },
          "errorMsg": {
            "type": "string",
            "nullable": true,
            "description": "错误信息，成功时为 null。",
            "example": null
          }
        }
      },
      "rendercloud_CommonErrorResponse": {
        "type": "object",
        "description": "通用错误响应体。",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "description": "是否成功。",
            "example": false
          },
          "data": {
            "type": "object",
            "nullable": true,
            "description": "数据，错误时为 null。",
            "example": null
          },
          "errorMsg": {
            "type": "string",
            "description": "错误信息。",
            "example": "参数无效"
          }
        }
      },
      "rendercloud_AiGenerateBusInstanceOpenDto": {
        "type": "object",
        "description": "RenderCloud 任务详情。",
        "additionalProperties": false,
        "properties": {
          "taskId": {
            "type": "integer",
            "format": "int64",
            "description": "任务 ID。",
            "example": 1272794
          },
          "userId": {
            "type": "integer",
            "format": "int64",
            "description": "用户 ID。",
            "example": 12345
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "description": "任务状态：\n- `0`: INIT - 初始化\n- `1`: RUNNING - 运行中\n- `3`: SUCCESS - 成功\n- `4`: FAIL - 失败\n",
            "example": 3
          },
          "outputs": {
            "type": "array",
            "nullable": true,
            "description": "任务输出素材列表，处理中时为 null。",
            "items": {
              "$ref": "#/components/schemas/rendercloud_AiGraphicAssetDto"
            },
            "example": [
              {
                "content": "YYZN2MZVAIQLEPTULM888888",
                "sourceReferId": "607583273"
              }
            ]
          }
        }
      },
      "rendercloud_AiGraphicAssetDto": {
        "type": "object",
        "description": "AI 素材对象。",
        "additionalProperties": false,
        "properties": {
          "sourceReferId": {
            "type": "string",
            "description": "源素材引用 ID（如 商品Id）。",
            "example": "607583273"
          },
          "content": {
            "type": "string",
            "description": "素材内容：\n- 对于 Mesh 上传任务输入：原始 Mesh URL\n- 对于 Mesh 上传任务输出：解析后的 meshId\n",
            "example": "YYZN2MZVAIQLEPTULM888888"
          }
        }
      },
      "reality_Artifact": {
        "properties": {
          "name": {
            "type": "string",
            "description": "名称。"
          },
          "format": {
            "type": "string",
            "enum": [
              "ply",
              "spz",
              "json",
              "zip"
            ],
            "description": "文件格式。"
          },
          "media_type": {
            "type": "string",
            "default": "application/octet-stream",
            "description": "文件的 MIME 类型。"
          },
          "href": {
            "type": "string",
            "description": "文件在 API 网关上的相对路径。拼接网关域名后 GET 下载。若重定向到其他域名的签名地址，后续请求不携带平台 Key。"
          },
          "public_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "开启公开访问时可分享的下载地址。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "name",
          "format",
          "href"
        ]
      },
      "reality_Camera": {
        "properties": {
          "model": {
            "type": "string",
            "enum": [
              "PINHOLE",
              "SIMPLE_PINHOLE",
              "OPENCV",
              "OPENCV_FISHEYE",
              "MEI"
            ],
            "description": "相机投影模型。"
          },
          "width": {
            "type": "integer",
            "maximum": 50000,
            "minimum": 240,
            "description": "图像宽度，单位为像素。"
          },
          "height": {
            "type": "integer",
            "maximum": 50000,
            "minimum": 240,
            "description": "图像高度，单位为像素。"
          },
          "params": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array",
                "maxItems": 17,
                "minItems": 3
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "按模型顺序填写内参。SIMPLE_PINHOLE 为 [f,cx,cy]，PINHOLE 为 [fx,fy,cx,cy]，OPENCV 为 [fx,fy,cx,cy,k1,k2,p1,p2]，OPENCV_FISHEYE 为 [fx,fy,cx,cy,k1,k2,k3,k4]。MEI 还需要 xi。"
          },
          "xi": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "MEI 统一投影模型的球面偏移参数。"
          },
          "rolling_shutter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_RollingShutter"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "逐行曝光相机的读出时间与方向。全局快门相机可省略。"
          },
          "blur": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_CameraBlur"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机的模糊模型。需要以米为单位的位姿和各图像的位姿输入。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "model",
          "width",
          "height"
        ]
      },
      "reality_CameraBlur": {
        "properties": {
          "k": {
            "type": "number",
            "minimum": 0,
            "description": "离焦系数，单位为像素·米。"
          },
          "zf": {
            "type": "number",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "对焦距离，单位为米。"
          },
          "c": {
            "type": "number",
            "minimum": 0,
            "description": "离轴 60° 时的镜头模糊方差，单位为平方像素。"
          },
          "b": {
            "type": "number",
            "minimum": 0,
            "description": "角速度导致的运动模糊系数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "k",
          "zf",
          "c",
          "b"
        ]
      },
      "reality_Feedback": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "text": {
            "type": "string",
            "description": "反馈或补充消息的正文。"
          },
          "images": {
            "type": "integer",
            "description": "用户提交的截图。"
          },
          "reconstruction_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "所属重建项目的 ID。"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "关联重建任务的 ID。"
          },
          "status": {
            "type": "string",
            "enum": [
              "new",
              "triaged",
              "planned",
              "declined",
              "fixed",
              "done"
            ],
            "description": "资源当前状态。"
          },
          "status_label": {
            "type": "string",
            "description": "可供展示的反馈状态文字。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          },
          "messages": {
            "items": {
              "$ref": "#/components/schemas/reality_FeedbackMessage"
            },
            "type": "array",
            "description": "按时间排序的反馈消息。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "text",
          "images",
          "reconstruction_id",
          "job_id",
          "status",
          "status_label",
          "created_at",
          "messages"
        ]
      },
      "reality_FeedbackList": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_Feedback"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_FeedbackMessage": {
        "properties": {
          "author": {
            "type": "string",
            "enum": [
              "user",
              "team"
            ],
            "description": "消息作者类别。"
          },
          "text": {
            "type": "string",
            "description": "反馈或补充消息的正文。"
          },
          "images": {
            "type": "integer",
            "description": "本条消息所附截图。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "author",
          "text",
          "images",
          "created_at"
        ]
      },
      "reality_Guide360Start": {
        "properties": {
          "camera": {
            "type": "string",
            "maxLength": 64,
            "default": "",
            "description": "相机型号，例如 Insta360 X5。"
          },
          "firmware": {
            "type": "string",
            "maxLength": 64,
            "default": "",
            "description": "相机 SDK 报告的固件版本。"
          },
          "sdk": {
            "type": "string",
            "maxLength": 64,
            "default": "",
            "description": "应用使用的相机 SDK 名称和版本。"
          },
          "offset_v1": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机 SDK 返回的双镜头成像圆参数。"
          },
          "offset_v3": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机 SDK 返回的双镜头 MEI 标定，与 offset_v6 至少提供一种。"
          },
          "offset_v6": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "使用扩展畸变参数的双镜头 MEI 标定。"
          },
          "window_crop": {
            "allOf": [
              {
                "$ref": "#/components/schemas/reality_WindowCrop"
              }
            ],
            "description": "相机 SDK 返回的每个镜头的裁切窗口。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "window_crop"
        ]
      },
      "reality_GuideComplete": {
        "properties": {
          "segments": {
            "type": "integer",
            "maximum": 4096,
            "minimum": 1,
            "description": "分段数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "segments"
        ]
      },
      "reality_GuideData": {
        "properties": {
          "track": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_GuideSeries"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "采集轨迹和 IMU 记录序列。"
          },
          "depth": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_GuideSeries"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "设备采集的深度序列。"
          },
          "mesh": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_GuideSeries"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "采集的空间网格序列。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_GuideSeries": {
        "properties": {
          "segments": {
            "type": "integer",
            "description": "分段数。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          },
          "complete": {
            "type": "boolean",
            "description": "是否已收齐数据并完成确认。"
          },
          "vertices": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "网格顶点数。"
          },
          "faces": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "网格三角面数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "segments",
          "bytes",
          "complete"
        ]
      },
      "reality_HesaiCompletion": {
        "properties": {
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "请求目标地址。"
          },
          "headers": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "default": {},
            "description": "发送签名请求时应携带的请求头。 此字段可能省略。"
          },
          "body": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "完成对象存储分块上传时应原样提交的正文。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_HesaiCreate": {
        "properties": {
          "session": {
            "type": "string",
            "maxLength": 1048576,
            "minLength": 2,
            "description": "扫描仪工程中 Project Data/session_info.json 的原始文本。"
          },
          "files": {
            "items": {
              "$ref": "#/components/schemas/reality_HesaiFileEntry"
            },
            "type": "array",
            "maxItems": 1000,
            "minItems": 3,
            "description": "工程文件及其状态。"
          },
          "output_formats": {
            "items": {
              "type": "string",
              "enum": [
                "ply",
                "spz"
              ]
            },
            "type": "array",
            "maxItems": 2,
            "minItems": 1,
            "default": [
              "ply",
              "spz"
            ],
            "description": "需要导出的高斯模型格式，可选 ply 和 spz。"
          },
          "axes": {
            "type": "string",
            "enum": [
              "opencv",
              "manycore"
            ],
            "default": "opencv",
            "description": "导出模型的坐标轴约定。"
          },
          "public_access": {
            "type": "boolean",
            "default": false,
            "description": "是否开启任务成果及留存输入的公开链接。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "session",
          "files"
        ]
      },
      "reality_HesaiFile": {
        "properties": {
          "file": {
            "type": "integer",
            "description": "禾赛工程文件列表中从 0 开始的索引。"
          },
          "path": {
            "type": "string",
            "description": "文件相对路径。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          },
          "received": {
            "type": "boolean",
            "description": "已经接收的分块信息。"
          },
          "crc64": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "文件完整接收后记录的 CRC64。"
          },
          "href": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "资源在 API 网关上的相对路径。拼接网关域名后 GET。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "file",
          "path",
          "bytes",
          "received"
        ]
      },
      "reality_HesaiFileEntry": {
        "properties": {
          "path": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "pattern": "^(Project Data|Raw Data)/[^\\x00-\\x1f\\\\]{1,240}$",
            "description": "文件相对路径。"
          },
          "size": {
            "type": "integer",
            "maximum": 68719476736,
            "minimum": 0,
            "description": "原始文件或分块的字节数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "path",
          "size"
        ]
      },
      "reality_HesaiFileUpload": {
        "properties": {
          "file": {
            "type": "integer",
            "description": "禾赛工程文件列表中从 0 开始的索引。"
          },
          "path": {
            "type": "string",
            "description": "文件相对路径。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          },
          "part_bytes": {
            "type": "integer",
            "description": "每个完整分块的字节数。"
          },
          "part_count": {
            "type": "integer",
            "description": "文件的总分块数。"
          },
          "received": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "description": "已经接收的分块信息。 此字段可能省略。"
          },
          "complete": {
            "type": "boolean",
            "description": "是否已收齐数据并完成确认。"
          },
          "remote": {
            "type": "boolean",
            "description": "是否通过签名请求向对象存储上传分块。"
          },
          "start": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_SignedRequest"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "启动对象存储分块上传所需的签名请求。"
          },
          "upload_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "对象存储返回的分块上传 ID。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "file",
          "path",
          "bytes",
          "part_bytes",
          "part_count",
          "complete",
          "remote",
          "start",
          "upload_id"
        ]
      },
      "reality_HesaiImport": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "reconstruction_id": {
            "type": "string",
            "description": "所属重建项目的 ID。"
          },
          "status": {
            "type": "string",
            "enum": [
              "uploading",
              "paused",
              "queued",
              "importing",
              "imported",
              "failed"
            ],
            "description": "资源当前状态。"
          },
          "phase": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "当前导入阶段。"
          },
          "done": {
            "type": "integer",
            "description": "当前阶段已处理的数量。"
          },
          "total": {
            "type": "integer",
            "description": "当前阶段要处理的总量。"
          },
          "source": {
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                },
                {
                  "type": "number"
                }
              ]
            },
            "type": "object",
            "description": "输入来源信息。 此字段可能省略。"
          },
          "file_count": {
            "type": "integer",
            "description": "工程文件总数。"
          },
          "received_files": {
            "type": "integer",
            "description": "已完整接收的文件数。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          },
          "received_bytes": {
            "type": "integer",
            "description": "已接收的字节数。"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "关联重建任务的 ID。"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "操作失败时的错误信息。"
          },
          "skipped_photos": {
            "type": "integer",
            "default": 0,
            "description": "因解码失败或超过照片尺寸限制而跳过的照片数。其余照片继续导入和重建。"
          },
          "files": {
            "items": {
              "$ref": "#/components/schemas/reality_HesaiFile"
            },
            "type": "array",
            "description": "工程文件及其状态。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "reconstruction_id",
          "status",
          "phase",
          "done",
          "total",
          "file_count",
          "received_files",
          "bytes",
          "received_bytes",
          "job_id",
          "error",
          "files"
        ]
      },
      "reality_HesaiPart": {
        "properties": {
          "part": {
            "type": "integer",
            "description": "从 0 开始的分块索引。"
          },
          "sha256": {
            "type": "string",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "received": {
            "type": "integer",
            "description": "已经接收的分块信息。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "part",
          "sha256",
          "received"
        ]
      },
      "reality_HesaiPartUrls": {
        "properties": {
          "remote": {
            "type": "boolean",
            "description": "是否通过签名请求向对象存储上传分块。"
          },
          "urls": {
            "additionalProperties": {
              "$ref": "#/components/schemas/reality_SignedRequest"
            },
            "type": "object",
            "description": "分块索引与签名 PUT 请求的对应关系。 此字段可能省略。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "remote"
        ]
      },
      "reality_HesaiParts": {
        "properties": {
          "parts": {
            "items": {
              "type": "integer",
              "minimum": 0,
              "maximum": 8192,
              "exclusiveMaximum": true
            },
            "type": "array",
            "maxItems": 64,
            "minItems": 1,
            "description": "分块索引或对应回执列表。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "parts"
        ]
      },
      "reality_HesaiReceipt": {
        "properties": {
          "part": {
            "type": "integer",
            "minimum": 0,
            "maximum": 8192,
            "exclusiveMaximum": true,
            "description": "从 0 开始的分块索引。"
          },
          "sha256": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}$",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "etag": {
            "type": "string",
            "pattern": "^\"?[0-9a-fA-F]{32}\"?$",
            "description": "上传该块后对象存储返回的 ETag。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "part",
          "sha256",
          "etag"
        ]
      },
      "reality_HesaiReceipts": {
        "properties": {
          "parts": {
            "items": {
              "$ref": "#/components/schemas/reality_HesaiReceipt"
            },
            "type": "array",
            "maxItems": 64,
            "minItems": 1,
            "description": "分块索引或对应回执列表。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "parts"
        ]
      },
      "reality_HesaiReceived": {
        "properties": {
          "received": {
            "type": "integer",
            "description": "已经接收的分块信息。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "received"
        ]
      },
      "reality_HesaiUploadId": {
        "properties": {
          "upload_id": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._~-]+$",
            "description": "对象存储返回的分块上传 ID。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "upload_id"
        ]
      },
      "reality_ImageMetadata": {
        "properties": {
          "frame_id": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9_.-]+$"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "同一曝光时刻共享的帧标识。"
          },
          "timestamp_seconds": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 1000000000000,
                "minimum": 0
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "统一单调时间轴上的采集时刻，单位为秒。"
          },
          "camera_to_world": {
            "anyOf": [
              {
                "items": {
                  "items": {
                    "type": "number"
                  },
                  "type": "array",
                  "maxItems": 4,
                  "minItems": 4
                },
                "type": "array",
                "maxItems": 4,
                "minItems": 4
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "4×4 相机到世界的变换，使用 OpenCV 相机轴。"
          },
          "device_to_world": {
            "anyOf": [
              {
                "items": {
                  "items": {
                    "type": "number"
                  },
                  "type": "array",
                  "maxItems": 4,
                  "minItems": 4
                },
                "type": "array",
                "maxItems": 4,
                "minItems": 4
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "4×4 设备到世界的变换。与直接给定相机位姿互斥。"
          },
          "angular_velocity": {
            "anyOf": [
              {
                "items": {
                  "type": "number",
                  "maximum": 200,
                  "minimum": -200
                },
                "type": "array",
                "maxItems": 3,
                "minItems": 3
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "设备坐标系下读出期间的角速度，单位为 rad/s。"
          },
          "velocity": {
            "anyOf": [
              {
                "items": {
                  "type": "number",
                  "maximum": 1000000000,
                  "minimum": -1000000000
                },
                "type": "array",
                "maxItems": 3,
                "minItems": 3
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "设备原点在世界坐标系下的速度，单位为位姿单位每秒。"
          },
          "object": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_ObjectRecord"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "物体模式下采集端记录的跟踪框、轮廓与点选状态。"
          },
          "object_pose": {
            "anyOf": [
              {
                "items": {
                  "items": {
                    "type": "number"
                  },
                  "type": "array",
                  "maxItems": 4,
                  "minItems": 4
                },
                "type": "array",
                "maxItems": 4,
                "minItems": 4
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "采集端估计的相机到物体的位姿。"
          },
          "object_epoch": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 2147483647,
                "minimum": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "当前物体选择内的跟踪段编号。"
          },
          "object_map": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 2147483647
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "object_pose 所属的物体坐标系。0 表示开始选择物体时的坐标系，正整数标识跟踪丢失后新建的坐标系。省略时各跟踪段独立处理。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_ImageResource": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "sequence": {
            "type": "integer",
            "description": "项目中的采集顺序。"
          },
          "status": {
            "type": "string",
            "enum": [
              "processing",
              "ready",
              "failed"
            ],
            "description": "资源当前状态。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          },
          "camera_id": {
            "type": "string",
            "description": "相机在项目内的标识。"
          },
          "metadata": {
            "allOf": [
              {
                "$ref": "#/components/schemas/reality_ImageMetadata"
              }
            ],
            "description": "该图像的位姿、采集或跟踪元数据。"
          },
          "has_mask": {
            "type": "boolean",
            "description": "是否提供了输入遮罩。"
          },
          "mask_type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "binary",
                  "alpha"
                ]
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "binary 表示二值遮罩，alpha 表示 8 位前景覆盖度。"
          },
          "content_href": {
            "type": "string",
            "description": "原图在 API 网关上的相对路径。拼接网关域名后 GET 下载。"
          },
          "mask_href": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "输入遮罩在 API 网关上的相对路径。非空时拼接网关域名后 GET 下载。"
          },
          "held": {
            "type": "boolean",
            "description": "为 true 时，服务已保留暂时无法解码的 HEIC 或 HEIF 原图。需要立即使用时，将照片导出为 JPEG，并用新图片 ID 和新序号上传。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "sequence",
          "status",
          "created_at",
          "camera_id",
          "metadata",
          "has_mask",
          "content_href",
          "held"
        ]
      },
      "reality_Images": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_ImageResource"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_ImuDescription": {
        "properties": {
          "samples": {
            "type": "integer",
            "description": "IMU 样本数。"
          },
          "timestamp_unit": {
            "type": "string",
            "enum": [
              "seconds"
            ],
            "description": "时间戳单位。"
          },
          "angular_velocity_unit": {
            "type": "string",
            "enum": [
              "rad/s"
            ],
            "description": "角速度单位。"
          },
          "axes": {
            "type": "string",
            "description": "导出模型的坐标轴约定。"
          },
          "first_timestamp_seconds": {
            "type": "number",
            "description": "首个样本的时间戳，单位为秒。"
          },
          "last_timestamp_seconds": {
            "type": "number",
            "description": "最后一个样本的时间戳，单位为秒。"
          },
          "time_offset_s": {
            "type": "number",
            "description": "图像时间与 IMU 采样时间之间的偏移秒数。"
          },
          "max_gap_s": {
            "type": "number",
            "description": "允许插值的最大采样间隔，单位为秒。"
          },
          "R_rig_imu": {
            "items": {
              "items": {
                "type": "number"
              },
              "type": "array"
            },
            "type": "array",
            "description": "从 IMU 传感器轴旋转到设备轴的 3×3 矩阵。"
          },
          "breaks": {
            "type": "integer",
            "description": "记录中标记的时间不连续次数。"
          },
          "sha256": {
            "type": "string",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "rotation_sigma_scale": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "IMU 旋转观测不确定性的比例系数。"
          },
          "segment_count": {
            "type": "integer",
            "default": 1,
            "description": "已登记的 IMU 分段总数。"
          },
          "bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "字节数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "samples",
          "timestamp_unit",
          "angular_velocity_unit",
          "axes",
          "first_timestamp_seconds",
          "last_timestamp_seconds",
          "time_offset_s",
          "max_gap_s",
          "R_rig_imu",
          "breaks",
          "sha256"
        ]
      },
      "reality_ImuSegment": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "samples": {
            "type": "integer",
            "description": "IMU 样本数。"
          },
          "first_timestamp_seconds": {
            "type": "number",
            "description": "首个样本的时间戳，单位为秒。"
          },
          "last_timestamp_seconds": {
            "type": "number",
            "description": "最后一个样本的时间戳，单位为秒。"
          },
          "breaks": {
            "type": "integer",
            "description": "记录中标记的时间不连续次数。"
          },
          "sha256": {
            "type": "string",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "samples",
          "first_timestamp_seconds",
          "last_timestamp_seconds",
          "breaks",
          "sha256",
          "bytes"
        ]
      },
      "reality_ImuSegments": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_ImuSegment"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_InputCamera": {
        "properties": {
          "model": {
            "type": "string",
            "enum": [
              "PINHOLE",
              "SIMPLE_PINHOLE",
              "OPENCV",
              "OPENCV_FISHEYE",
              "MEI"
            ],
            "description": "相机投影模型。"
          },
          "width": {
            "type": "integer",
            "maximum": 50000,
            "minimum": 240,
            "description": "图像宽度，单位为像素。"
          },
          "height": {
            "type": "integer",
            "maximum": 50000,
            "minimum": 240,
            "description": "图像高度，单位为像素。"
          },
          "params": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array",
                "maxItems": 17,
                "minItems": 3
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "按模型顺序填写内参。SIMPLE_PINHOLE 为 [f,cx,cy]，PINHOLE 为 [fx,fy,cx,cy]，OPENCV 为 [fx,fy,cx,cy,k1,k2,p1,p2]，OPENCV_FISHEYE 为 [fx,fy,cx,cy,k1,k2,k3,k4]。MEI 还需要 xi。"
          },
          "xi": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "MEI 统一投影模型的球面偏移参数。"
          },
          "rolling_shutter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_RollingShutter"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "逐行曝光相机的读出时间与方向。全局快门相机可省略。"
          },
          "blur": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_CameraBlur"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机的模糊模型。需要以米为单位的位姿和各图像的位姿输入。"
          },
          "id": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9_.-]+$",
            "description": "资源标识。"
          },
          "camera_to_device": {
            "anyOf": [
              {
                "items": {
                  "items": {
                    "type": "number"
                  },
                  "type": "array",
                  "maxItems": 4,
                  "minItems": 4
                },
                "type": "array",
                "maxItems": 4,
                "minItems": 4
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "4×4 相机到设备的固定变换。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "model",
          "width",
          "height",
          "id"
        ]
      },
      "reality_InputFile": {
        "properties": {
          "href": {
            "type": "string",
            "description": "资源在 API 网关上的相对路径。拼接网关域名后 GET。"
          },
          "media_type": {
            "type": "string",
            "description": "文件的 MIME 类型。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          },
          "sha256": {
            "type": "string",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "public_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "开启公开访问时可分享的下载地址。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "href",
          "media_type",
          "bytes",
          "sha256"
        ]
      },
      "reality_InputMask": {
        "properties": {
          "href": {
            "type": "string",
            "description": "资源在 API 网关上的相对路径。拼接网关域名后 GET。"
          },
          "media_type": {
            "type": "string",
            "description": "文件的 MIME 类型。"
          },
          "bytes": {
            "type": "integer",
            "description": "字节数。"
          },
          "sha256": {
            "type": "string",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "public_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "开启公开访问时可分享的下载地址。"
          },
          "role": {
            "type": "string",
            "enum": [
              "original",
              "person",
              "validity",
              "foreground"
            ],
            "description": "遮罩用途。"
          },
          "encoding": {
            "type": "string",
            "enum": [
              "binary",
              "alpha"
            ],
            "description": "数据文件的编码约定。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "href",
          "media_type",
          "bytes",
          "sha256",
          "role",
          "encoding"
        ]
      },
      "reality_InsvComplete": {
        "properties": {
          "output_formats": {
            "items": {
              "type": "string",
              "enum": [
                "ply",
                "spz"
              ]
            },
            "type": "array",
            "maxItems": 2,
            "minItems": 1,
            "default": [
              "ply",
              "spz"
            ],
            "description": "需要导出的高斯模型格式，可选 ply 和 spz。"
          },
          "video": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_VideoSettings"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "此任务使用的全景视频抽帧参数。"
          },
          "axes": {
            "type": "string",
            "enum": [
              "opencv",
              "manycore"
            ],
            "default": "opencv",
            "description": "导出模型的坐标轴约定。"
          },
          "public_access": {
            "type": "boolean",
            "default": false,
            "description": "是否开启任务成果及留存输入的公开链接。"
          },
          "max_gaussians": {
            "type": "integer",
            "maximum": 15000000,
            "minimum": 100000,
            "default": 4000000,
            "description": "单模型的高斯数量上限。"
          },
          "steps": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 1440000,
                "minimum": 1000
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "训练步数，与 epochs 不能同时指定。"
          },
          "epochs": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 1440000,
                "minimum": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "完整遍历输入图像的训练轮数。"
          },
          "block_training": {
            "type": "boolean",
            "default": false,
            "description": "是否分块训练场景并输出模型 ZIP。"
          },
          "block_max_gaussians": {
            "type": "integer",
            "maximum": 15000000,
            "minimum": 100000,
            "default": 4000000,
            "description": "分块训练时每块的高斯数量上限。"
          },
          "quality": {
            "type": "string",
            "enum": [
              "fast",
              "high"
            ],
            "default": "fast",
            "description": "全景视频的训练质量档位。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_InsvCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "pattern": "^[^\\x00-\\x1f/\\\\]+\\.([iI][nN][sS]|[oO][sS])[vV]$",
            "description": "名称。"
          },
          "size": {
            "type": "integer",
            "maximum": 68719476736,
            "minimum": 78,
            "description": "原始文件或分块的字节数。"
          },
          "fingerprint": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[0-9a-f]{64}$"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "文件首 MiB、末 MiB 及十进制字节数拼接后的 SHA-256 小写十六进制值。"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_RemoteInput"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "从公网 URL 下载完整的 INSV 或 OSV 文件。"
          },
          "fps": {
            "type": "number",
            "maximum": 60,
            "minimum": 0.5,
            "default": 5,
            "description": "每秒采样的帧数，受源帧率限制。"
          },
          "image_size": {
            "anyOf": [
              {
                "type": "integer",
                "multipleOf": 2,
                "maximum": 8192,
                "minimum": 480
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "解码或抽帧后的目标图像边长，单位为像素。"
          },
          "bootstrap_parts": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "maxItems": 256,
            "description": "建议先上传的分块索引。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "name",
          "size"
        ]
      },
      "reality_InsvImport": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "reconstruction_id": {
            "type": "string",
            "description": "所属重建项目的 ID。"
          },
          "name": {
            "type": "string",
            "description": "名称。"
          },
          "size": {
            "type": "integer",
            "description": "原始文件或分块的字节数。"
          },
          "fingerprint": {
            "type": "string",
            "description": "文件首 MiB、末 MiB 及十进制字节数拼接后的 SHA-256 小写十六进制值。"
          },
          "fps": {
            "type": "number",
            "description": "每秒采样的帧数，受源帧率限制。"
          },
          "image_size": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "解码或抽帧后的目标图像边长，单位为像素。"
          },
          "status": {
            "type": "string",
            "enum": [
              "uploading",
              "paused",
              "queued",
              "importing",
              "imported",
              "failed",
              "cancelled"
            ],
            "description": "资源当前状态。"
          },
          "phase": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "当前导入阶段。"
          },
          "done": {
            "type": "integer",
            "description": "当前阶段已处理的数量。"
          },
          "total": {
            "type": "integer",
            "description": "当前阶段要处理的总量。"
          },
          "part_size": {
            "type": "integer",
            "description": "完整分块的字节数。"
          },
          "part_count": {
            "type": "integer",
            "description": "文件的总分块数。"
          },
          "received": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "description": "已经接收的分块信息。 此字段可能省略。"
          },
          "received_count": {
            "type": "integer",
            "description": "已接收的分块数。"
          },
          "held": {
            "type": "boolean",
            "description": "文件暂时无法导入时保留已有分块，收齐后可重新确认导入。"
          },
          "image_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "已生成的图像数。"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "关联重建任务的 ID。"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "操作失败时的错误信息。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "reconstruction_id",
          "name",
          "size",
          "fingerprint",
          "fps",
          "image_size",
          "status",
          "phase",
          "done",
          "total",
          "part_size",
          "part_count",
          "received_count",
          "held",
          "image_count",
          "job_id",
          "error",
          "created_at"
        ]
      },
      "reality_InsvPart": {
        "properties": {
          "part": {
            "type": "integer",
            "description": "从 0 开始的分块索引。"
          },
          "size": {
            "type": "integer",
            "description": "原始文件或分块的字节数。"
          },
          "sha256": {
            "type": "string",
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "received_count": {
            "type": "integer",
            "description": "已接收的分块数。"
          },
          "part_count": {
            "type": "integer",
            "description": "文件的总分块数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "part",
          "size",
          "sha256",
          "received_count",
          "part_count"
        ]
      },
      "reality_Job": {
        "properties": {
          "id": {
            "type": "string",
            "description": "用于查询此任务和下载其成果的标识。"
          },
          "reconstruction_id": {
            "type": "string",
            "description": "所属重建项目的 ID。"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "succeeded",
              "failed"
            ],
            "description": "资源当前状态。"
          },
          "stage": {
            "type": "string",
            "enum": [
              "queued",
              "structure_from_motion",
              "training",
              "exporting",
              "completed"
            ],
            "description": "当前处理阶段。"
          },
          "progress": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_JobProgress"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "活动任务的进度估算。 此字段可能省略。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "结束时间。"
          },
          "input_image_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "本次任务的输入图片数。"
          },
          "registered_image_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "成功完成相机位姿配准的图片数。"
          },
          "quality_warning": {
            "type": "boolean",
            "description": "任务成功后，若成功配准的图像少于一半或首视角渲染质量较差，此字段会更新为 true。公网调用方应允许字段缺省。"
          },
          "artifacts": {
            "items": {
              "$ref": "#/components/schemas/reality_Artifact"
            },
            "type": "array",
            "description": "当前任务可下载的成果清单。"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "操作失败时的错误信息。"
          },
          "error_code": {
            "type": "string",
            "enum": [
              "object_target_excluded"
            ],
            "description": "仅在失败且有对应错误码时返回。object_target_excluded 表示训练遮罩排除了选中的物体；具体原因见 error。"
          },
          "mode": {
            "type": "string",
            "enum": [
              "scene",
              "object"
            ],
            "description": "重建模式。"
          },
          "skip_pose_refinement": {
            "type": "boolean",
            "description": "是否直接使用提供的标定位姿。开启时每张图片及相机必须具备所需位姿和内参。"
          },
          "axes": {
            "type": "string",
            "enum": [
              "opencv",
              "manycore"
            ],
            "description": "导出模型的坐标轴约定。"
          },
          "public_access": {
            "type": "boolean",
            "description": "是否开启任务成果及留存输入的公开链接。"
          },
          "public_images_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "公开访问开启时列出此任务输入图像的地址。"
          },
          "max_gaussians": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "单模型的高斯数量上限。"
          },
          "steps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "训练步数，与 epochs 不能同时指定。"
          },
          "epochs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "完整遍历输入图像的训练轮数。"
          },
          "remove_people": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "是否移除采集画面中的人物。"
          },
          "block_training": {
            "type": "boolean",
            "description": "是否分块训练场景并输出模型 ZIP。"
          },
          "block_max_gaussians": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "分块训练时每块的高斯数量上限。"
          },
          "quality": {
            "type": "string",
            "enum": [
              "fast",
              "high"
            ],
            "description": "全景视频的训练质量档位。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "reconstruction_id",
          "status",
          "stage",
          "created_at",
          "completed_at",
          "input_image_count",
          "registered_image_count",
          "artifacts",
          "error",
          "mode",
          "skip_pose_refinement",
          "axes",
          "public_access",
          "public_images_url",
          "max_gaussians",
          "steps",
          "epochs",
          "remove_people",
          "block_training",
          "block_max_gaussians",
          "quality"
        ]
      },
      "reality_JobCreate": {
        "properties": {
          "output_formats": {
            "items": {
              "type": "string",
              "enum": [
                "ply",
                "spz"
              ]
            },
            "type": "array",
            "maxItems": 2,
            "minItems": 1,
            "default": [
              "ply",
              "spz"
            ],
            "description": "需要导出的高斯模型格式，可选 ply 和 spz。"
          },
          "mode": {
            "type": "string",
            "enum": [
              "scene",
              "object"
            ],
            "default": "scene",
            "description": "重建模式。"
          },
          "object_selection": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_ObjectSelection"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "物体模式下用于指定跟踪目标的图片和归一化矩形框。"
          },
          "skip_pose_refinement": {
            "type": "boolean",
            "default": false,
            "description": "是否直接使用提供的标定位姿。开启时每张图片及相机必须具备所需位姿和内参。"
          },
          "video": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_VideoSettings"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "此任务使用的全景视频抽帧参数。"
          },
          "axes": {
            "type": "string",
            "enum": [
              "opencv",
              "manycore"
            ],
            "default": "opencv",
            "description": "导出模型的坐标轴约定。"
          },
          "public_access": {
            "type": "boolean",
            "default": false,
            "description": "是否开启任务成果及留存输入的公开链接。"
          },
          "max_gaussians": {
            "type": "integer",
            "maximum": 15000000,
            "minimum": 100000,
            "default": 4000000,
            "description": "单模型的高斯数量上限。"
          },
          "steps": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 1440000,
                "minimum": 1000
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "训练步数，与 epochs 不能同时指定。"
          },
          "epochs": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 1440000,
                "minimum": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "完整遍历输入图像的训练轮数。"
          },
          "remove_people": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "是否移除采集画面中的人物。"
          },
          "block_training": {
            "type": "boolean",
            "default": false,
            "description": "是否分块训练场景并输出模型 ZIP。"
          },
          "block_max_gaussians": {
            "type": "integer",
            "maximum": 15000000,
            "minimum": 100000,
            "default": 4000000,
            "description": "分块训练时每块的高斯数量上限。"
          },
          "quality": {
            "type": "string",
            "enum": [
              "fast",
              "high"
            ],
            "default": "fast",
            "description": "全景视频的训练质量档位。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_JobImage": {
        "properties": {
          "image_id": {
            "type": "string",
            "description": "输入图像的标识。"
          },
          "sequence": {
            "type": "integer",
            "description": "项目中的采集顺序。"
          },
          "width": {
            "type": "integer",
            "description": "图像宽度，单位为像素。"
          },
          "height": {
            "type": "integer",
            "description": "图像高度，单位为像素。"
          },
          "image": {
            "allOf": [
              {
                "$ref": "#/components/schemas/reality_InputFile"
              }
            ],
            "description": "留存输入图像的文件信息。"
          },
          "masks": {
            "items": {
              "$ref": "#/components/schemas/reality_InputMask"
            },
            "type": "array",
            "description": "与图像关联的遮罩列表。"
          },
          "source": {
            "additionalProperties": true,
            "type": "object",
            "description": "输入来源信息。 此字段可能省略。"
          },
          "camera_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机在项目内的标识。"
          },
          "camera_to_result": {
            "anyOf": [
              {
                "items": {
                  "items": {
                    "type": "number"
                  },
                  "type": "array"
                },
                "type": "array"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "将相机坐标转换到本任务成果坐标系的 4×4 矩阵。"
          },
          "used_for_training": {
            "type": "boolean",
            "default": false,
            "description": "是否使用该图像训练本次模型。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "image_id",
          "sequence",
          "width",
          "height",
          "image",
          "masks"
        ]
      },
      "reality_JobImages": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_JobImage"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_JobProgress": {
        "properties": {
          "remaining_seconds": {
            "type": "number",
            "description": "预计剩余秒数。"
          },
          "queue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_JobQueue"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "任务的排队情况。"
          },
          "stages": {
            "items": {
              "$ref": "#/components/schemas/reality_JobStage"
            },
            "type": "array",
            "description": "按执行顺序排列的任务阶段。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "remaining_seconds",
          "queue",
          "stages"
        ]
      },
      "reality_JobPublicAccess": {
        "properties": {
          "public_access": {
            "type": "boolean",
            "description": "是否开启任务成果及留存输入的公开链接。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "public_access"
        ]
      },
      "reality_JobQueue": {
        "properties": {
          "ahead": {
            "type": "integer",
            "description": "排在本任务前的重建任务数。"
          },
          "wait_seconds": {
            "type": "number",
            "description": "预计排队等待秒数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "ahead",
          "wait_seconds"
        ]
      },
      "reality_JobStage": {
        "properties": {
          "stage": {
            "type": "string",
            "enum": [
              "preparing_images",
              "masking_images",
              "structure_from_motion",
              "training",
              "exporting"
            ],
            "description": "当前处理阶段。"
          },
          "state": {
            "type": "string",
            "enum": [
              "done",
              "running",
              "pending"
            ],
            "description": "阶段状态。"
          },
          "elapsed_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "阶段已经耗费的秒数。"
          },
          "expected_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "预计该阶段的总秒数。"
          },
          "remaining_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "预计剩余秒数。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "stage",
          "state",
          "elapsed_seconds",
          "expected_seconds",
          "remaining_seconds"
        ]
      },
      "reality_Jobs": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_Job"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_ObjectRecord": {
        "properties": {
          "box": {
            "anyOf": [
              {
                "items": {
                  "type": "number",
                  "maximum": 1,
                  "minimum": 0
                },
                "type": "array",
                "maxItems": 4,
                "minItems": 4
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "目标框 [左,上,右,下]，各值为 0–1 的归一化坐标。"
          },
          "outline": {
            "anyOf": [
              {
                "items": {
                  "items": {
                    "items": {
                      "type": "number",
                      "maximum": 1,
                      "minimum": 0
                    },
                    "type": "array",
                    "maxItems": 2,
                    "minItems": 2
                  },
                  "type": "array",
                  "maxItems": 512,
                  "minItems": 3
                },
                "type": "array",
                "maxItems": 32,
                "minItems": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "目标轮廓多边形，每个点为归一化的 [x,y]。"
          },
          "seen": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "此帧中跟踪器是否锁定目标。"
          },
          "tap": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "是否为用户选择物体后的第一帧。"
          },
          "kept": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "本次点选是否保留了此前所选目标。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_ObjectSelection": {
        "properties": {
          "image_id": {
            "type": "string",
            "pattern": "^[0-9a-f]{32}$",
            "description": "输入图像的标识。"
          },
          "bounding_box": {
            "items": {
              "type": "number"
            },
            "type": "array",
            "maxItems": 4,
            "minItems": 4,
            "description": "用于选择目标的归一化矩形 [左,上,右,下]。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "image_id",
          "bounding_box"
        ]
      },
      "reality_Problem": {
        "properties": {
          "type": {
            "type": "string",
            "default": "about:blank",
            "description": "问题类型标识。"
          },
          "title": {
            "type": "string",
            "description": "错误标题。"
          },
          "status": {
            "type": "integer",
            "description": "HTTP 状态码。"
          },
          "detail": {
            "type": "string",
            "description": "具体错误原因。"
          },
          "instance": {
            "type": "string",
            "description": "发生错误的资源地址。"
          },
          "errors": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "字段验证错误的详情。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "title",
          "status",
          "detail",
          "instance"
        ]
      },
      "reality_Reconstruction": {
        "properties": {
          "id": {
            "type": "string",
            "description": "创建项目后用于访问项目的标识。"
          },
          "name": {
            "type": "string",
            "description": "名称。"
          },
          "pose_units": {
            "type": "string",
            "enum": [
              "metres",
              "relative"
            ],
            "description": "输入位姿的长度单位，metres 为米，relative 为相对尺度。"
          },
          "camera": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_Camera"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机配置。"
          },
          "cameras": {
            "items": {
              "$ref": "#/components/schemas/reality_InputCamera"
            },
            "type": "array",
            "description": "相机定义列表。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          },
          "status": {
            "type": "string",
            "enum": [
              "collecting",
              "processing",
              "succeeded",
              "failed"
            ],
            "description": "资源当前状态。"
          },
          "active_job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "项目当前活动任务的 ID。"
          },
          "latest_result_job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "最近一次产生成果的任务 ID。"
          },
          "imu": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_ImuDescription"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "项目已关联的 IMU 数据摘要。"
          },
          "gravity_aligned": {
            "type": "boolean",
            "default": false,
            "description": "输入位姿的世界坐标是否与重力对齐（+Y 朝下）。"
          },
          "remove_people": {
            "type": "boolean",
            "description": "是否移除采集画面中的人物。"
          },
          "guide360": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_GuideData"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "全景引导采集的数据序列。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "name",
          "pose_units",
          "camera",
          "cameras",
          "created_at",
          "status",
          "active_job_id",
          "latest_result_job_id",
          "remove_people"
        ]
      },
      "reality_ReconstructionCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1,
            "default": "Untitled reconstruction",
            "description": "名称。"
          },
          "pose_units": {
            "type": "string",
            "enum": [
              "metres",
              "relative"
            ],
            "default": "metres",
            "description": "输入位姿的长度单位，metres 为米，relative 为相对尺度。"
          },
          "camera": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_Camera"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机配置。"
          },
          "cameras": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/reality_InputCamera"
                },
                "type": "array",
                "maxItems": 32,
                "minItems": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机定义列表。"
          },
          "gravity_aligned": {
            "type": "boolean",
            "default": false,
            "description": "输入位姿的世界坐标与重力对齐且 +Y 朝下时设为 true，服务将据此校正成果的水平朝向。"
          },
          "remove_people": {
            "type": "boolean",
            "default": true,
            "description": "是否移除采集画面中的人物。"
          }
        },
        "additionalProperties": false,
        "type": "object"
      },
      "reality_Reconstructions": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_Reconstruction"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_RemoteInput": {
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 8192,
            "minLength": 1,
            "description": "可公开下载的 HTTP(S) 文件地址，不含用户名、密码或片段。最多跟随三次重定向，各跳均需指向公网。"
          },
          "expected_bytes": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 68719476736,
                "minimum": 0,
                "exclusiveMinimum": true
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "预期文件大小，单位为字节，用于下载校验。"
          },
          "sha256": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[a-fA-F0-9]{64}$"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url"
        ]
      },
      "reality_RollingShutter": {
        "properties": {
          "readout_seconds": {
            "type": "number",
            "minimum": 0,
            "exclusiveMinimum": true,
            "maximum": 1,
            "exclusiveMaximum": true,
            "description": "图像首行至末行的读出时间，单位为秒。"
          },
          "direction": {
            "type": "string",
            "enum": [
              "top_to_bottom",
              "bottom_to_top",
              "left_to_right",
              "right_to_left"
            ],
            "description": "传感器逐行读出的方向。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "readout_seconds",
          "direction"
        ]
      },
      "reality_SignedRequest": {
        "properties": {
          "url": {
            "type": "string",
            "description": "请求目标地址。"
          },
          "headers": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "description": "发送签名请求时应携带的请求头。 此字段可能省略。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url"
        ]
      },
      "reality_Upload": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "reconstruction_id": {
            "type": "string",
            "description": "所属重建项目的 ID。"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "downloading",
              "succeeded",
              "failed"
            ],
            "description": "资源当前状态。"
          },
          "href": {
            "type": "string",
            "description": "资源在 API 网关上的相对路径。拼接网关域名后 GET。"
          },
          "result": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "异步上传完成后返回的原操作结果。 此字段可能省略。"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "操作失败时的错误信息。"
          },
          "error_status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "上传失败时对应的 HTTP 状态码。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "reconstruction_id",
          "status",
          "href"
        ]
      },
      "reality_VideoCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "pattern": "^[^\\x00-\\x1f/\\\\]+\\.(?i:mp4|mov|m4v|mkv|webm|avi)$",
            "description": "名称。"
          },
          "size": {
            "type": "integer",
            "maximum": 68719476736,
            "minimum": 1,
            "description": "原始文件或分块的字节数。"
          },
          "sha256": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[0-9a-f]{64}$"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "fps": {
            "type": "number",
            "maximum": 60,
            "minimum": 0.5,
            "default": 5,
            "description": "每秒采样的帧数，受源帧率限制。"
          },
          "image_size": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 8192,
                "minimum": 480
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "解码或抽帧后的目标图像边长，单位为像素。"
          },
          "camera_id": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64,
                "minLength": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机在项目内的标识。"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/reality_RemoteInput"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "从公网 URL 下载完整的普通视频。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "name",
          "size"
        ]
      },
      "reality_VideoList": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/reality_VideoResource"
            },
            "type": "array",
            "description": "本页返回的资源。"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "下一页的游标，null 表示已到末页。"
          }
        },
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ]
      },
      "reality_VideoResource": {
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "status": {
            "type": "string",
            "description": "资源当前状态。"
          },
          "name": {
            "type": "string",
            "description": "名称。"
          },
          "size": {
            "type": "integer",
            "description": "原始文件或分块的字节数。"
          },
          "sha256": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "文件或分块的 SHA-256 十六进制摘要。"
          },
          "fps": {
            "type": "number",
            "description": "每秒采样的帧数，受源帧率限制。"
          },
          "image_size": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "解码或抽帧后的目标图像边长，单位为像素。"
          },
          "camera_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "相机在项目内的标识。"
          },
          "part_bytes": {
            "type": "integer",
            "description": "每个完整分块的字节数。"
          },
          "part_count": {
            "type": "integer",
            "description": "文件的总分块数。"
          },
          "received": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "description": "已经接收的分块信息。 此字段可能省略。"
          },
          "received_count": {
            "type": "integer",
            "description": "已接收的分块数。"
          },
          "done": {
            "type": "integer",
            "description": "当前阶段已处理的数量。"
          },
          "total": {
            "type": "integer",
            "description": "当前阶段要处理的总量。"
          },
          "summary": {
            "additionalProperties": true,
            "type": "object",
            "description": "普通视频导入结果摘要。 此字段可能省略。"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "操作失败时的错误信息。"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间。"
          }
        },
        "type": "object",
        "required": [
          "id",
          "status",
          "name",
          "size",
          "sha256",
          "fps",
          "image_size",
          "camera_id",
          "part_bytes",
          "part_count",
          "received_count",
          "done",
          "total",
          "error",
          "created_at"
        ]
      },
      "reality_VideoSettings": {
        "properties": {
          "fps": {
            "type": "number",
            "maximum": 60,
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "每秒采样的帧数，受源帧率限制。"
          },
          "image_size": {
            "type": "integer",
            "multipleOf": 2,
            "maximum": 8192,
            "minimum": 480,
            "description": "解码或抽帧后的目标图像边长，单位为像素。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "fps",
          "image_size"
        ]
      },
      "reality_WindowCrop": {
        "properties": {
          "src_width": {
            "type": "integer",
            "maximum": 65536,
            "minimum": 1,
            "description": "原图宽度，单位为像素。"
          },
          "src_height": {
            "type": "integer",
            "maximum": 65536,
            "minimum": 1,
            "description": "原图高度，单位为像素。"
          },
          "dst_width": {
            "type": "integer",
            "maximum": 65536,
            "minimum": 1,
            "description": "裁切后图像宽度，单位为像素。"
          },
          "dst_height": {
            "type": "integer",
            "maximum": 65536,
            "minimum": 1,
            "description": "裁切后图像高度，单位为像素。"
          },
          "crop_offset_x": {
            "type": "integer",
            "maximum": 0,
            "minimum": 0,
            "default": 0,
            "description": "裁切窗口的水平偏移，单位为像素。"
          },
          "crop_offset_y": {
            "type": "integer",
            "maximum": 0,
            "minimum": 0,
            "default": 0,
            "description": "裁切窗口的垂直偏移，单位为像素。"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "src_width",
          "src_height",
          "dst_width",
          "dst_height"
        ]
      },
      "reality_ResultCamera": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "资源标识。"
          },
          "model": {
            "enum": [
              "pinhole",
              "opencv",
              "opencv_fisheye",
              "kb4_inverse_brown",
              "fisheye",
              "mei",
              "equirectangular"
            ],
            "type": "string",
            "description": "相机投影模型。"
          },
          "width": {
            "type": "integer",
            "description": "图像宽度，单位为像素。"
          },
          "height": {
            "type": "integer",
            "description": "图像高度，单位为像素。"
          },
          "K": {
            "items": {
              "items": {
                "type": "number"
              },
              "type": "array"
            },
            "type": "array",
            "description": "最终 3×3 相机内参矩阵，以像素为单位。"
          },
          "D": {
            "items": {
              "type": "number"
            },
            "type": "array",
            "description": "投影模型的畸变系数，排列取决于 model。"
          },
          "xi": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "default": null,
            "description": "MEI 统一投影模型的球面偏移参数。"
          },
          "theta_max_degrees": {
            "type": "number",
            "description": "有效标定射线与正前方的最大夹角，单位为度。"
          },
          "pixel_center": {
            "default": "half_pixel",
            "type": "string",
            "enum": [
              "half_pixel"
            ],
            "description": "像素中心采样约定，half_pixel 对应 [列+0.5,行+0.5]。"
          }
        },
        "required": [
          "id",
          "model",
          "width",
          "height",
          "K",
          "D",
          "theta_max_degrees"
        ],
        "type": "object"
      },
      "reality_ResultImage": {
        "additionalProperties": false,
        "properties": {
          "image_id": {
            "type": "string",
            "description": "输入图像的标识。"
          },
          "camera_id": {
            "type": "string",
            "description": "相机在项目内的标识。"
          },
          "width": {
            "type": "integer",
            "description": "图像宽度，单位为像素。"
          },
          "height": {
            "type": "integer",
            "description": "图像高度，单位为像素。"
          },
          "camera_to_result": {
            "items": {
              "items": {
                "type": "number"
              },
              "type": "array"
            },
            "type": "array",
            "description": "将相机坐标转换到本任务成果坐标系的 4×4 矩阵。"
          },
          "used_for_training": {
            "type": "boolean",
            "description": "是否使用该图像训练本次模型。"
          },
          "masks": {
            "items": {
              "$ref": "#/components/schemas/reality_ResultMask"
            },
            "type": "array",
            "description": "与图像关联的遮罩列表。"
          }
        },
        "required": [
          "image_id",
          "camera_id",
          "width",
          "height",
          "camera_to_result",
          "used_for_training",
          "masks"
        ],
        "type": "object"
      },
      "reality_ResultMask": {
        "additionalProperties": false,
        "properties": {
          "path": {
            "type": "string",
            "description": "文件相对路径。"
          },
          "role": {
            "enum": [
              "validity",
              "foreground"
            ],
            "type": "string",
            "description": "遮罩用途。"
          },
          "encoding": {
            "enum": [
              "binary",
              "alpha"
            ],
            "type": "string",
            "description": "数据文件的编码约定。"
          }
        },
        "required": [
          "path",
          "role",
          "encoding"
        ],
        "type": "object"
      },
      "reality_ResultCameras": {
        "additionalProperties": false,
        "properties": {
          "version": {
            "default": 1,
            "type": "integer",
            "enum": [
              1
            ],
            "description": "成果清单格式版本。"
          },
          "coordinate_system": {
            "default": "result",
            "type": "string",
            "enum": [
              "result"
            ],
            "description": "成果使用的坐标系。"
          },
          "camera_axes": {
            "default": "right_down_forward",
            "type": "string",
            "enum": [
              "right_down_forward"
            ],
            "description": "相机坐标轴约定。"
          },
          "result_axes": {
            "default": "right_down_forward",
            "enum": [
              "right_down_forward",
              "right_forward_up"
            ],
            "type": "string",
            "description": "成果坐标轴约定。"
          },
          "output_units": {
            "enum": [
              "meters",
              "input_sfm"
            ],
            "type": "string",
            "description": "导出模型所用的单位。"
          },
          "masks_artifact": {
            "default": "masks.zip",
            "type": "string",
            "enum": [
              "masks.zip"
            ],
            "description": "包含遮罩的成果文件名。"
          },
          "cameras": {
            "items": {
              "$ref": "#/components/schemas/reality_ResultCamera"
            },
            "type": "array",
            "description": "相机定义列表。"
          },
          "images": {
            "items": {
              "$ref": "#/components/schemas/reality_ResultImage"
            },
            "type": "array",
            "description": "图片列表。"
          }
        },
        "required": [
          "output_units",
          "cameras",
          "images"
        ],
        "type": "object"
      },
      "reality_FeedbackCreate": {
        "additionalProperties": false,
        "properties": {
          "text": {
            "maxLength": 5000,
            "minLength": 1,
            "type": "string",
            "description": "反馈或补充消息的正文。"
          },
          "images": {
            "default": [],
            "items": {
              "maxLength": 8000000,
              "pattern": "^data:image/(?:png|jpeg|webp);base64,",
              "type": "string"
            },
            "maxItems": 6,
            "type": "array",
            "description": "截图的 data URL 列表，最多 6 张。"
          },
          "reconstruction_id": {
            "anyOf": [
              {
                "pattern": "^[0-9a-f]{32}$",
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "default": null,
            "description": "所属重建项目的 ID。"
          },
          "job_id": {
            "anyOf": [
              {
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "default": null,
            "description": "关联重建任务的 ID。"
          }
        },
        "required": [
          "text"
        ],
        "type": "object"
      },
      "reality_FeedbackMessageCreate": {
        "additionalProperties": false,
        "properties": {
          "text": {
            "maxLength": 5000,
            "minLength": 1,
            "type": "string",
            "description": "反馈或补充消息的正文。"
          },
          "images": {
            "default": [],
            "items": {
              "maxLength": 8000000,
              "pattern": "^data:image/(?:png|jpeg|webp);base64,",
              "type": "string"
            },
            "maxItems": 6,
            "type": "array",
            "description": "补充消息所附截图的 data URL 列表，最多 6 张。"
          }
        },
        "required": [
          "text"
        ],
        "type": "object"
      },
      "reality_ResultCoordinates": {
        "type": "object",
        "required": [
          "mode",
          "has_metric_scale",
          "meters_per_unit",
          "training_units",
          "output_units",
          "input_to_output_scale",
          "output_origin",
          "normalization",
          "world_from_result",
          "pose_refinement_skipped"
        ],
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "metric",
              "relative"
            ],
            "description": "重建模式。"
          },
          "has_metric_scale": {
            "type": "boolean",
            "description": "是否具有已知的物理尺度。"
          },
          "meters_per_unit": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "每个输入尺度单位对应的米数。未知时为 null。"
          },
          "training_units": {
            "type": "string",
            "description": "训练所用尺度。"
          },
          "output_units": {
            "type": "string",
            "description": "导出模型所用的单位。"
          },
          "input_to_output_scale": {
            "type": "number",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "输入坐标到输出坐标的统一缩放比例。"
          },
          "output_origin": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "type": "number"
            },
            "description": "导出时扣除的原点偏移。"
          },
          "normalization": {
            "type": "object",
            "description": "训练所用归一化信息。"
          },
          "world_from_result": {
            "type": "array",
            "minItems": 4,
            "maxItems": 4,
            "items": {
              "type": "array",
              "minItems": 4,
              "maxItems": 4,
              "items": {
                "type": "number"
              }
            },
            "description": "成果坐标到世界坐标的 4×4 齐次变换，按行给出。"
          },
          "axes": {
            "type": "string",
            "enum": [
              "opencv",
              "manycore"
            ],
            "description": "导出模型的坐标轴约定。"
          },
          "model_axes": {
            "type": "object",
            "properties": {
              "point_cloud.ply": {
                "type": "string"
              },
              "scene.spz": {
                "type": "string"
              }
            },
            "description": "各导出文件的坐标轴约定。"
          },
          "world_up": {
            "anyOf": [
              {
                "type": "array",
                "minItems": 3,
                "maxItems": 3,
                "items": {
                  "type": "number"
                }
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "成果坐标系中的上方单位向量。"
          },
          "world_up_source": {
            "type": "string",
            "enum": [
              "photos",
              "imu",
              "gnss",
              "photos_low_confidence",
              "input_poses"
            ],
            "description": "上方方向的确定方式。"
          },
          "pose_refinement_skipped": {
            "type": "boolean",
            "description": "任务是否保留给定相机位姿。"
          }
        }
      },
      "spatialunderstanding_CreateSpatialUnderstandingTaskRequest": {
        "required": [
          "inputFileUrl"
        ],
        "type": "object",
        "properties": {
          "inputFileUrl": {
            "minLength": 1,
            "type": "string",
            "description": "点云文件 URL，仅支持 `.ply`，面向室内场景。点云应使用米为单位的右手坐标系，并完成空间对齐（[ScanNet Alignment](https://github.com/ScanNet/ScanNet/tree/master/Alignment)）：使 Z 轴朝上、地面与 X-Y 平面平行，同时尽量使主要墙体在水平面上的走向与 X 轴或 Y 轴平行。若输入点云未满足上述要求，请传入 `transformationMatrix`。本地文件请先调用 [Asset 文件上传接口](https://labs.aholo.cn/api-docs/api-reference#tag/asset)，再将返回的 URL 填入此字段。不支持外部 URL。",
            "example": "https://holo-cos.aholo3d.cn/resource/openapi/xxx.ply"
          },
          "transformationMatrix": {
            "type": "array",
            "description": "可选。用于将输入点云转换至上述对齐坐标系的 4×4 齐次变换矩阵（4 行 4 列数字），使 Z 轴朝上、地面与 X-Y 平面平行，并尽量使主要墙体在水平面上的走向与 X 轴或 Y 轴平行。不传表示输入点云已完成对齐，不做变换。约定：列向量乘法 `p' = T p`；平移在第 4 列；右手系；Z-up（[ScanNet Alignment](https://github.com/ScanNet/ScanNet/tree/master/Alignment)）；单位米。\n\n分块示意：左上 `R` 为 3×3 旋转，右侧 `t` 为平移，底行固定为 `[0, 0, 0, 1]`。\n\n```\nT = [ R(3×3)  t(3×1) ]\n    [ 0(1×3)  1      ]\n```\n\n对应请求体下标：\n\n```\n[\n  [ r00, r01, r02, tx ],\n  [ r10, r11, r12, ty ],\n  [ r20, r21, r22, tz ],\n  [   0,   0,   0,  1 ]\n]\n```",
            "example": [
              [
                0.9337461173020494,
                0.3579360116324523,
                0,
                1.871216953359744
              ],
              [
                -0.3579360116324523,
                0.9337461173020494,
                0,
                -0.2091883674268249
              ],
              [
                0,
                0,
                0.9999999999999999,
                1.2121098756790158
              ],
              [
                0,
                0,
                0,
                1
              ]
            ],
            "items": {
              "type": "array",
              "description": "可选。用于将输入点云转换至上述对齐坐标系的 4×4 齐次变换矩阵（4 行 4 列数字），使 Z 轴朝上、地面与 X-Y 平面平行，并尽量使主要墙体在水平面上的走向与 X 轴或 Y 轴平行。不传表示输入点云已完成对齐，不做变换。约定：列向量乘法 `p' = T p`；平移在第 4 列；右手系；Z-up（[ScanNet Alignment](https://github.com/ScanNet/ScanNet/tree/master/Alignment)）；单位米。\n\n分块示意：左上 `R` 为 3×3 旋转，右侧 `t` 为平移，底行固定为 `[0, 0, 0, 1]`。\n\n```\nT = [ R(3×3)  t(3×1) ]\n    [ 0(1×3)  1      ]\n```\n\n对应请求体下标：\n\n```\n[\n  [ r00, r01, r02, tx ],\n  [ r10, r11, r12, ty ],\n  [ r20, r21, r22, tz ],\n  [   0,   0,   0,  1 ]\n]\n```",
              "example": [
                [
                  0.9337461173020494,
                  0.3579360116324523,
                  0,
                  1.871216953359744
                ],
                [
                  -0.3579360116324523,
                  0.9337461173020494,
                  0,
                  -0.2091883674268249
                ],
                [
                  0,
                  0,
                  0.9999999999999999,
                  1.2121098756790158
                ],
                [
                  0,
                  0,
                  0,
                  1
                ]
              ],
              "items": {
                "type": "number",
                "description": "可选。用于将输入点云转换至上述对齐坐标系的 4×4 齐次变换矩阵（4 行 4 列数字），使 Z 轴朝上、地面与 X-Y 平面平行，并尽量使主要墙体在水平面上的走向与 X 轴或 Y 轴平行。不传表示输入点云已完成对齐，不做变换。约定：列向量乘法 `p' = T p`；平移在第 4 列；右手系；Z-up（[ScanNet Alignment](https://github.com/ScanNet/ScanNet/tree/master/Alignment)）；单位米。\n\n分块示意：左上 `R` 为 3×3 旋转，右侧 `t` 为平移，底行固定为 `[0, 0, 0, 1]`。\n\n```\nT = [ R(3×3)  t(3×1) ]\n    [ 0(1×3)  1      ]\n```\n\n对应请求体下标：\n\n```\n[\n  [ r00, r01, r02, tx ],\n  [ r10, r11, r12, ty ],\n  [ r20, r21, r22, tz ],\n  [   0,   0,   0,  1 ]\n]\n```",
                "format": "double"
              }
            }
          }
        },
        "description": "创建空间理解任务请求体。面向室内点云；坐标系为米、右手系、Z-up。"
      },
      "spatialunderstanding_SpatialUnderstandingTaskAsyncOperation": {
        "required": [
          "taskId"
        ],
        "type": "object",
        "properties": {
          "taskId": {
            "type": "string",
            "description": "任务 id。填入 `GET /spatial-understanding/v1/tasks/{taskId}` 即可轮询状态与结果。",
            "example": "A1b2C3d4E5"
          }
        },
        "description": "创建任务受理结果，含 `taskId`。用该 id 查询详情直至任务完成。"
      },
      "spatialunderstanding_ApiError": {
        "required": [
          "code",
          "details",
          "message",
          "status"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "HTTP状态码",
            "format": "int32",
            "example": 403
          },
          "message": {
            "type": "string",
            "description": "面向开发者的错误消息（英文），用户可见的本地化消息请使用localizedMessage字段",
            "example": "Permission denied to access this resource"
          },
          "status": {
            "$ref": "#/components/schemas/spatialunderstanding_Code"
          },
          "details": {
            "$ref": "#/components/schemas/spatialunderstanding_ErrorDetails"
          },
          "localizedMessage": {
            "$ref": "#/components/schemas/spatialunderstanding_LocalizedMessage"
          },
          "help": {
            "$ref": "#/components/schemas/spatialunderstanding_Help"
          }
        },
        "description": "API错误响应对象，包含完整的错误信息、状态码和帮助信息"
      },
      "spatialunderstanding_Code": {
        "type": "string",
        "description": "REST API标准状态码，符合Google API设计规范，用于统一的错误码表示",
        "example": "PERMISSION_DENIED",
        "enum": [
          "OK",
          "CANCELLED",
          "UNKNOWN",
          "INVALID_ARGUMENT",
          "DEADLINE_EXCEEDED",
          "NOT_FOUND",
          "ALREADY_EXISTS",
          "PERMISSION_DENIED",
          "UNAUTHENTICATED",
          "RESOURCE_EXHAUSTED",
          "FAILED_PRECONDITION",
          "ABORTED",
          "OUT_OF_RANGE",
          "UNIMPLEMENTED",
          "INTERNAL",
          "UNAVAILABLE",
          "DATA_LOSS",
          "PARTIAL_ELEMENT_UPDATE_FAILED"
        ]
      },
      "spatialunderstanding_ErrorDetails": {
        "required": [
          "reason"
        ],
        "type": "object",
        "properties": {
          "reason": {
            "maxLength": 63,
            "pattern": "[A-Z][A-Z0-9_]+[A-Z0-9]",
            "type": "string",
            "description": "错误原因标识符，使用大写蛇形命名法（UPPER_SNAKE_CASE），最多63个字符",
            "example": "RESOURCE_NOT_FOUND"
          },
          "message": {
            "type": "string",
            "description": "针对此错误的人类可读说明，提供具体的错误上下文",
            "nullable": true,
            "example": "The requested design with ID 12345 does not exist"
          },
          "domain": {
            "type": "string",
            "description": "错误域，通常是生成错误的服务名称",
            "nullable": true,
            "example": "restapi.qunhe.com"
          },
          "metaData": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "description": "错误的附加元数据，键值对格式，键最多64个字符，符合模式 /[a-zA-Z0-9-_]/",
              "nullable": true,
              "example": "{\"instanceLimitPerRequest\":\"100\",\"currentInstanceCount\":\"150\"}"
            },
            "description": "错误的附加元数据，键值对格式，键最多64个字符，符合模式 /[a-zA-Z0-9-_]/",
            "nullable": true,
            "example": {
              "instanceLimitPerRequest": "100",
              "currentInstanceCount": "150"
            }
          }
        },
        "description": "错误详情对象，提供错误的详细上下文信息，包括原因、域和元数据"
      },
      "spatialunderstanding_Help": {
        "required": [
          "desc",
          "url"
        ],
        "type": "object",
        "properties": {
          "desc": {
            "type": "string",
            "description": "链接内容的描述，说明此帮助文档的用途",
            "example": "如何解决权限拒绝错误"
          },
          "url": {
            "type": "string",
            "description": "帮助文档的URL链接",
            "example": "https://docs.example.com/errors/permission-denied"
          }
        },
        "description": "帮助信息对象，提供解决错误的文档链接和说明",
        "nullable": true
      },
      "spatialunderstanding_LocalizedMessage": {
        "required": [
          "locale",
          "message"
        ],
        "type": "object",
        "properties": {
          "locale": {
            "type": "string",
            "description": "消息的语言环境标识",
            "example": "zh_CN"
          },
          "message": {
            "type": "string",
            "description": "本地化后的错误消息文本，面向最终用户",
            "example": "您没有访问此资源的权限"
          }
        },
        "description": "本地化消息对象，提供特定语言环境的错误消息",
        "nullable": true
      },
      "spatialunderstanding_SpatialUnderstandingTaskListQueryRequest": {
        "type": "object",
        "properties": {
          "pageNum": {
            "minimum": 0,
            "type": "integer",
            "description": "页码，从 1 起；`0` 与 `1` 均视为第一页。",
            "format": "int32",
            "example": 1
          },
          "pageSize": {
            "maximum": 100,
            "minimum": 0,
            "type": "integer",
            "description": "每页条数，最大 100；为 0 或未传时按 20 条计。",
            "format": "int32",
            "example": 20
          },
          "statusList": {
            "type": "array",
            "description": "按任务状态过滤（大写字符串）；为空表示不按状态过滤。",
            "items": {
              "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTaskStatus"
            }
          }
        },
        "description": "分页查询空间理解任务列表的请求体：`pageNum` 从 1 起（`0` 与 `1` 均视为第一页）；`pageSize` 为每页条数（1-100，缺省或 0 时按 20 条计）。仅查询当前账号下的任务数据。"
      },
      "spatialunderstanding_SpatialUnderstandingTaskStatus": {
        "type": "string",
        "description": "空间理解任务状态。**进行中**：`PENDING` 排队中；`RUNNING` 执行中。**终态**：`SUCCEEDED` 成功；`FAILED` 失败；`TIMEOUT` 超时。",
        "example": "SUCCEEDED",
        "enum": [
          "PENDING",
          "RUNNING",
          "SUCCEEDED",
          "FAILED",
          "TIMEOUT"
        ]
      },
      "spatialunderstanding_SpatialUnderstandingTask": {
        "type": "object",
        "properties": {
          "taskId": {
            "type": "string",
            "description": "任务 id，与创建接口返回值一致。",
            "example": "A1b2C3d4E5"
          },
          "status": {
            "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTaskStatus"
          },
          "modelVersion": {
            "type": "string",
            "description": "本次任务实际使用的模型版本。创建时不可指定，由服务端使用当前默认版本。",
            "example": "spatiallm-pointcloud-1.2-20260910"
          },
          "result": {
            "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTaskResult"
          },
          "errorCode": {
            "type": "string",
            "description": "失败分类码；仅 `FAILED` 或 `TIMEOUT` 时返回。`MODEL_SUBMIT_FAILED`：任务提交失败；`MODEL_TASK_FAILED`：任务执行失败；`RESULT_TRANSFER_FAILED`：结果写入失败；`TIMEOUT`：超时。",
            "example": "MODEL_TASK_FAILED"
          },
          "errorMessage": {
            "type": "string",
            "description": "失败详情；仅 `FAILED` 或 `TIMEOUT` 时返回。",
            "example": "task failed"
          },
          "createTime": {
            "type": "integer",
            "description": "创建时间，Unix 毫秒。",
            "format": "int64"
          },
          "updateTime": {
            "type": "integer",
            "description": "最后更新时间，Unix 毫秒。",
            "format": "int64"
          }
        },
        "description": "空间理解任务详情。成功时含 `result`，失败或超时时含 `errorCode`、`errorMessage`。"
      },
      "spatialunderstanding_SpatialUnderstandingTaskPagedList": {
        "type": "object",
        "properties": {
          "pageNum": {
            "type": "integer",
            "description": "本次请求使用的页码（从 1 起；请求传 `0` 时原样回写 `0`）。",
            "format": "int32",
            "example": 1
          },
          "pageSize": {
            "type": "integer",
            "description": "本次请求使用的每页条数。",
            "format": "int32",
            "example": 20
          },
          "count": {
            "type": "integer",
            "description": "当前页记录条数。",
            "format": "int32",
            "example": 20
          },
          "totalCount": {
            "type": "integer",
            "description": "符合筛选条件的总记录数。",
            "format": "int32",
            "example": 128
          },
          "hasMore": {
            "type": "boolean",
            "description": "是否还有下一页。",
            "example": false
          },
          "result": {
            "type": "array",
            "description": "当前页的任务记录列表。",
            "items": {
              "$ref": "#/components/schemas/spatialunderstanding_SpatialUnderstandingTask"
            }
          }
        },
        "description": "空间理解任务列表分页结果：含本次请求的 `pageNum` / `pageSize`，以及当前页数据与总计。"
      },
      "spatialunderstanding_SpatialUnderstandingTaskResult": {
        "type": "object",
        "properties": {
          "resultSslUrl": {
            "type": "string",
            "description": "空间理解结果文件的访问地址。UTF-8 纯文本，一行一个实体；服务端不提供解析后的 JSON，请自行下载并解析。\n\n坐标系：单位米，右手系，Z-up（[ScanNet Alignment](https://github.com/ScanNet/ScanNet/tree/master/Alignment)）。\n\n行格式：`{id}={Type}(arg1,arg2,...)`。未知 `Type` 请跳过该行，不要整文件失败。\n\n| Type | 行格式 |\n| --- | --- |\n| Wall | `wall_{n}=Wall(ax,ay,az,bx,by,bz,height,thickness)` |\n| Door | `door_{n}=Door(wall_id,position_x,position_y,position_z,width,height)` |\n| Window | `window_{n}=Window(wall_id,position_x,position_y,position_z,width,height)` |\n| Bbox | `bbox_{n}=Bbox(class,position_x,position_y,position_z,angle_z,scale_x,scale_y,scale_z)` |\n\n| 类型 | 字段 | 数据类型 | 说明 |\n| --- | --- | --- | --- |\n| Wall | `ax, ay, az` | number | 墙体底部基准线起点 A 的三维坐标。 |\n| Wall | `bx, by, bz` | number | 墙体底部基准线终点 B 的三维坐标。 |\n| Wall | `height` | number | 墙体高度。 |\n| Wall | `thickness` | number | 墙体厚度；当前输出为 `0.0`，因为识别的是房间内轮廓的边。 |\n| Door | `wall_id` | string | 门所属墙体的标识符，例如 `wall_0`，应引用当前文件中已有的墙体。 |\n| Door | `position_x, position_y, position_z` | number | 门洞中心点的三维坐标。 |\n| Door | `width` | number | 门洞沿所属墙体方向的宽度。 |\n| Door | `height` | number | 门洞的垂直高度。 |\n| Window | `wall_id` | string | 窗所属墙体的标识符，例如 `wall_4`，应引用当前文件中已有的墙体。 |\n| Window | `position_x, position_y, position_z` | number | 窗洞中心点的三维坐标。 |\n| Window | `width` | number | 窗洞沿所属墙体方向的宽度。 |\n| Window | `height` | number | 窗洞的垂直高度。 |\n| Bbox | `class` | string | 物体类别，例如 `chair`、`sofa`、`carpet`、`coffee_table`。 |\n| Bbox | `position_x, position_y, position_z` | number | 三维包围盒中心点坐标。 |\n| Bbox | `angle_z` | number | 包围盒绕 Z 轴的旋转角，即水平方向朝向。 |\n| Bbox | `scale_x` | number | 包围盒局部 X 轴方向的完整尺寸，非半尺寸。 |\n| Bbox | `scale_y` | number | 包围盒局部 Y 轴方向的完整尺寸，非半尺寸。 |\n| Bbox | `scale_z` | number | 包围盒局部 Z 轴方向的完整尺寸，即高度。 |\n\n解析建议：按行读取。`class` 可能含空格（如 `dining chair`），不要按第一个逗号切分；应从右侧取 7 个数字，左侧整段作为 `class`。`class` 一般无引号。数字为浮点。\n\n格式示意：\n\n```\nwall_0=Wall(1.6857,-4.4625,0.0,4.6798,-4.4474,0.0,2.73,0.0)\ndoor_0=Door(wall_0,3.1734,-4.4550,1.05,1.3852,2.1)\nwindow_0=Window(wall_4,5.6622,-1.0338,1.65,0.6883,1.5)\nbbox_0=Bbox(carpet,-3.009,4.371,-1.401,-1.5708,5.718,6.734,0.109)\n```\n\n**常见 class**\n\n| class | 中文 |\n| --- | --- |\n| curtain | 窗帘 |\n| painting | 装饰画 |\n| nightstand | 床头柜 |\n| chandelier | 吊灯 |\n| wardrobe | 衣柜 |\n| bed | 床 |\n| carpet | 地毯 |\n| sofa | 沙发 |\n| dining chair | 餐椅 |\n| bathroom cabinet | 浴室柜 |\n| television | 电视 |\n| toilet | 坐便器 |\n| dining table combination | 餐桌组合 |\n| chair | 椅子 |\n| shower | 花洒 |\n| plants | 绿植 |\n| tv cabinet | 电视柜 |\n| coffee table | 茶几/茶座 |\n| illumination | 照明 |\n| shoe cabinet | 鞋柜 |\n| refrigerator | 冰箱 |\n| shower room | 淋浴房 |\n| wall decoration | 墙饰/挂件 |\n| cupboard | 橱柜 |\n| side table | 边几 |\n| stool | 凳子 |\n| wine cabinet | 酒柜 |\n| bookcase | 书柜 |\n| combination sofa | 组合沙发 |\n| air conditioner | 空调 |\n| washing cabinet | 洗衣机柜 |\n| pillow | 抱枕/靠垫 |\n| stove | 灶台 |\n| dressing table | 梳妆台 |\n| desk | 书桌 |\n| cushion | 坐垫 |\n| floor-standing lamp | 落地灯 |\n| dining table | 餐桌 |\n| washing machine | 洗衣机 |\n| hand sink | 洗手台 |\n| clothes rack | 晾衣架 |\n| mirror | 镜子 |\n| sideboard | 餐边柜 |\n| computer | 电脑 |\n| potted bonsai | 盆栽盆景 |\n| range hood | 抽油烟机 |\n| entrance cabinet | 玄关柜 |\n| cupboard | 斗柜 |\n| gas stove | 燃气灶 |\n| multifunctional combination bed | 多功能组合床 |\n| leisure table and chair combination | 休闲桌椅组合 |\n| bar chair | 吧台椅 |\n| screen | 屏风 |\n| sink | 水槽 |\n| bar | 吧台 |\n| tub | 浴缸 |\n| decorative cabinet | 装饰柜 |\n| wall cabinet | 壁柜 |\n| integrated stove | 集成灶 |\n| micro-wave oven | 微波炉 |",
            "example": "https://holo-cos.aholo3d.cn/resource/openapi/xxx-result.txt"
          }
        },
        "description": "空间理解任务产物。仅任务成功时返回。`resultSslUrl` 指向 UTF-8 文本（DSL），含 Wall / Door / Window / Bbox，需自行下载解析。"
      }
    },
    "parameters": {
      "rendercloud_SessionId": {
        "name": "sessionId",
        "in": "path",
        "required": true,
        "description": "实时渲染流会话 ID。",
        "schema": {
          "type": "string"
        }
      }
    },
    "responses": {
      "rendercloud_BadRequest": {
        "description": "请求参数无效。",
        "content": {
          "application/+json": {
            "schema": {
              "$ref": "#/components/schemas/rendercloud_ApiError"
            },
            "examples": {
              "invalidArgument": {
                "summary": "参数无效",
                "description": "请求体缺少必要字段或字段值不合法。",
                "value": {
                  "code": 400,
                  "message": "requestId 不能为空",
                  "status": "INVALID_ARGUMENT",
                  "details": {
                    "reason": "INVALID_ARGUMENT",
                    "domain": "render"
                  }
                }
              },
              "usdContentEmpty": {
                "summary": "OpenUSD 内容为空",
                "description": "提交渲染或创建实时流时，`usdContent` 为空。",
                "value": {
                  "code": 400,
                  "message": "OpenUSD 内容不能为空",
                  "status": "INVALID_ARGUMENT",
                  "details": {
                    "reason": "USD_CONTENT_EMPTY",
                    "domain": "render"
                  }
                }
              },
              "openUsdParseError": {
                "summary": "OpenUSD 解析失败",
                "description": "`usdContent` 不是合法 Base64，或解码后的 OpenUSD 内容无法解析。",
                "value": {
                  "code": 400,
                  "message": "OpenUSD 内容解析失败",
                  "status": "INVALID_ARGUMENT",
                  "details": {
                    "reason": "OPENUSD_PARSE_ERROR",
                    "domain": "render"
                  }
                }
              }
            }
          }
        }
      },
      "rendercloud_NotFound": {
        "description": "资源不存在。",
        "content": {
          "application/+json": {
            "schema": {
              "$ref": "#/components/schemas/rendercloud_ApiError"
            },
            "examples": {
              "taskNotFound": {
                "summary": "任务不存在",
                "description": "轮询离线渲染任务时，`operationId` 对应任务不存在。",
                "value": {
                  "code": 404,
                  "message": "任务不存在",
                  "status": "NOT_FOUND",
                  "details": {
                    "reason": "TASK_NOT_FOUND",
                    "domain": "render"
                  }
                }
              },
              "sessionNotFound": {
                "summary": "会话不存在",
                "description": "实时渲染会话不存在、已关闭或已被清理。",
                "value": {
                  "code": 404,
                  "message": "会话不存在",
                  "status": "NOT_FOUND",
                  "details": {
                    "reason": "SESSION_NOT_FOUND",
                    "domain": "render"
                  }
                }
              }
            }
          }
        }
      },
      "rendercloud_Conflict": {
        "description": "重复请求。",
        "content": {
          "application/+json": {
            "schema": {
              "$ref": "#/components/schemas/rendercloud_OperationError"
            },
            "examples": {
              "duplicateRequest": {
                "summary": "requestId 重复",
                "description": "同一用户在 1 分钟内重复提交相同 `requestId`。",
                "value": {
                  "operationId": null,
                  "metaData": null,
                  "done": true,
                  "result": null,
                  "error": {
                    "code": 409,
                    "message": "requestId has already been submitted within 60 seconds",
                    "status": "ALREADY_EXISTS",
                    "details": {
                      "reason": "OFFLINE_RENDER_DUPLICATE_REQUEST",
                      "domain": "render"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "rendercloud_TooManyRequests": {
        "description": "请求被限流。",
        "content": {
          "application/+json": {
            "schema": {
              "$ref": "#/components/schemas/rendercloud_ApiError"
            },
            "examples": {
              "rateLimited": {
                "summary": "请求频率超限",
                "description": "用户维度请求频率超过当前接口限制。",
                "value": {
                  "code": 429,
                  "message": "请求频率超限",
                  "status": "RESOURCE_EXHAUSTED",
                  "details": {
                    "reason": "RATE_LIMITED",
                    "domain": "render"
                  }
                }
              }
            }
          }
        }
      },
      "rendercloud_InternalServerError": {
        "description": "渲染服务内部错误。",
        "content": {
          "application/+json": {
            "schema": {
              "$ref": "#/components/schemas/rendercloud_ApiError"
            },
            "examples": {
              "renderInternalError": {
                "summary": "渲染失败",
                "description": "任务创建、OpenUSD 转换、渲染下发或实时会话更新失败。",
                "value": {
                  "code": 500,
                  "message": "渲染失败",
                  "status": "INTERNAL",
                  "details": {
                    "reason": "INTERNAL_ERROR",
                    "domain": "render"
                  }
                }
              }
            }
          }
        }
      },
      "reality_Unauthorized": {
        "description": "平台 Key 缺失或无效时，网关返回 application/json，错误消息在 m 中。业务服务无法识别调用账号时返回 application/problem+json。",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "required": [
                "c",
                "m"
              ],
              "properties": {
                "c": {
                  "type": "string",
                  "description": "网关错误码。"
                },
                "m": {
                  "type": "string",
                  "description": "网关错误消息。"
                },
                "d": {
                  "description": "错误响应中的数据字段，可为 null。"
                },
                "f": {
                  "description": "错误响应中的附加字段，可为 null。"
                }
              }
            },
            "examples": {
              "missingKey": {
                "summary": "未提供平台 Key",
                "value": {
                  "c": "-1",
                  "m": "appKey missing",
                  "d": null,
                  "f": null
                }
              },
              "invalidKey": {
                "summary": "平台 Key 无效",
                "value": {
                  "c": "-1",
                  "m": "invalid appKey",
                  "d": null,
                  "f": null
                }
              }
            }
          },
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/reality_Problem"
            }
          }
        }
      }
    },
    "requestBodies": {},
    "securitySchemes": {
      "AuthorizationHeader": {
        "type": "apiKey",
        "description": "开放平台访问凭证。API key 鉴权,在 Header 中增加 Authorization，值为平台申请的 API key，无需 Bearer 前缀。",
        "name": "Authorization",
        "in": "header"
      },
      "OusTokenV2": {
        "type": "apiKey",
        "description": "由「获取 OUS 上传凭证」返回的 `ousToken`；仅用于请求 `globalDomain` 上的 OUS 接口（与开放平台 `Authorization` 无关）。",
        "name": "ous-token-v2",
        "in": "header"
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "资产",
      "tags": [
        "Asset"
      ]
    },
    {
      "name": "世界",
      "tags": [
        "World",
        "SpatialUnderstanding"
      ]
    },
    {
      "name": "Lux3D",
      "tags": [
        "Lux3D"
      ]
    },
    {
      "name": "渲染云",
      "tags": [
        "RenderCloudOpenUSDGuide",
        "RenderCloud"
      ]
    },
    {
      "name": "Reality",
      "tags": [
        "RealityGuide",
        "Reality"
      ]
    }
  ]
}