asset prepare derived

{
  "input": {
    "body": {
      "asset": "Z2xURgIAAACQCAAAlAQAAEpTT057ImFzc2V0Ijp7ImdlbmVyYXRvciI6ImdsVEYtVHJhbnNmb3JtIHY0LjUuMCIsInZlcnNpb24iOiIyLjAifSwiYWNjZXNzb3JzIjpbeyJ0eXBlIjoiVkVDMyIsImNvbXBvbmVudFR5cGUiOjUxMjYsImNvdW50IjoyNCwibWF4IjpbMC41LDAuNSwwLjVdLCJtaW4iOlstMC41LC0wLjUsLTAuNV0sImJ1ZmZlclZpZXciOjEsImJ5dGVPZmZzZXQiOjB9LHsidHlwZSI6IlZFQzMiLCJjb21wb25lbnRUeXBlIjo1MTI2LCJjb3VudCI6MjQsImJ1ZmZlclZpZXciOjEsImJ5dGVPZmZzZXQiOjEyfSx7InR5cGUiOiJWRUMyIiwiY29tcG9uZW50VHlwZSI6NTEyNiwiY291bnQiOjI0LCJidWZmZXJWaWV3IjoxLCJieXRlT2Zmc2V0IjoyNH0seyJ0eXBlIjoiU0NBTEFSIiwiY29tcG9uZW50VHlwZSI6NTEyMywiY291bnQiOjM2LCJidWZmZXJWaWV3IjoyLCJieXRlT2Zmc2V0IjowfV0sImJ1ZmZlclZpZXdzIjpbeyJidWZmZXIiOjAsImJ5dGVPZmZzZXQiOjg0MCwiYnl0ZUxlbmd0aCI6MTUyfSx7ImJ1ZmZlciI6MCwiYnl0ZU9mZnNldCI6MCwiYnl0ZUxlbmd0aCI6NzY4LCJieXRlU3RyaWRlIjozMiwidGFyZ2V0IjozNDk2Mn0seyJidWZmZXIiOjAsImJ5dGVPZmZzZXQiOjc2OCwiYnl0ZUxlbmd0aCI6NzIsInRhcmdldCI6MzQ5NjN9XSwic2FtcGxlcnMiOlt7IndyYXBTIjoxMDQ5Nywid3JhcFQiOjEwNDk3fV0sInRleHR1cmVzIjpbeyJzb3VyY2UiOjAsInNhbXBsZXIiOjB9XSwiaW1hZ2VzIjpbeyJuYW1lIjoiY2hlY2tlciIsIm1pbWVUeXBlIjoiaW1hZ2UvcG5nIiwiYnVmZmVyVmlldyI6MH1dLCJidWZmZXJzIjpbeyJieXRlTGVuZ3RoIjo5OTJ9XSwibWF0ZXJpYWxzIjpbeyJuYW1lIjoiY3ViZS1tYXRlcmlhbCIsInBick1ldGFsbGljUm91Z2huZXNzIjp7InJvdWdobmVzc0ZhY3RvciI6MC44LCJtZXRhbGxpY0ZhY3RvciI6MCwiYmFzZUNvbG9yVGV4dHVyZSI6eyJpbmRleCI6MH19fV0sIm1lc2hlcyI6W3sibmFtZSI6ImN1YmUiLCJwcmltaXRpdmVzIjpbeyJhdHRyaWJ1dGVzIjp7IlBPU0lUSU9OIjowLCJOT1JNQUwiOjEsIlRFWENPT1JEXzAiOjJ9LCJtb2RlIjo0LCJtYXRlcmlhbCI6MCwiaW5kaWNlcyI6M31dfV0sIm5vZGVzIjpbeyJuYW1lIjoiY3ViZSIsIm1lc2giOjB9XSwic2NlbmVzIjpbeyJuYW1lIjoic2NlbmUiLCJub2RlcyI6WzBdfV0sInNjZW5lIjowfSAgIOADAABCSU4AAAAAPwAAAL8AAAC/AACAPwAAAAAAAAAAAAAAAAAAAAAAAAA/AAAAPwAAAL8AAIA/AAAAAAAAAAAAAIA/AAAAAAAAAD8AAAA/AAAAPwAAgD8AAAAAAAAAAAAAgD8AAIA/AAAAPwAAAL8AAAA/AACAPwAAAAAAAAAAAAAAAAAAgD8AAAC/AAAAvwAAAL8AAIC/AAAAAAAAAAAAAAAAAAAAAAAAAL8AAAA/AAAAvwAAgL8AAAAAAAAAAAAAgD8AAAAAAAAAvwAAAD8AAAA/AACAvwAAAAAAAAAAAACAPwAAgD8AAAC/AAAAvwAAAD8AAIC/AAAAAAAAAAAAAAAAAACAPwAAAL8AAAA/AAAAvwAAAAAAAIA/AAAAAAAAAAAAAAAAAAAAvwAAAD8AAAA/AAAAAAAAgD8AAAAAAACAPwAAAAAAAAA/AAAAPwAAAD8AAAAAAACAPwAAAAAAAIA/AACAPwAAAD8AAAA/AAAAvwAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAvwAAAL8AAAC/AAAAAAAAgL8AAAAAAAAAAAAAAAAAAAC/AAAAvwAAAD8AAAAAAACAvwAAAAAAAIA/AAAAAAAAAD8AAAC/AAAAPwAAAAAAAIC/AAAAAAAAgD8AAIA/AAAAPwAAAL8AAAC/AAAAAAAAgL8AAAAAAAAAAAAAgD8AAAC/AAAAvwAAAD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAAD8AAAC/AAAAPwAAAAAAAAAAAACAPwAAgD8AAAAAAAAAPwAAAD8AAAA/AAAAAAAAAAAAAIA/AACAPwAAgD8AAAC/AAAAPwAAAD8AAAAAAAAAAAAAgD8AAAAAAACAPwAAAL8AAAC/AAAAvwAAAAAAAAAAAACAvwAAAAAAAAAAAAAAPwAAAL8AAAC/AAAAAAAAAAAAAIC/AACAPwAAAAAAAAA/AAAAPwAAAL8AAAAAAAAAAAAAgL8AAIA/AACAPwAAAL8AAAA/AAAAvwAAAAAAAAAAAACAvwAAAAAAAIA/AAABAAIAAAACAAMABAAFAAYABAAGAAcACAAJAAoACAAKAAsADAANAA4ADAAOAA8AEAARABIAEAASABMAFAAVABYAFAAWABcAiVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAABlBMVEXWxKhcbHrpdFJRAAAACXBIWXMAAAPoAAAD6AG1e1JrAAAAOElEQVR42u3UoQ0AAAgDMPj/aQyCIHEknZupmFhEJzvXDvgNGA8wYwt/YDyALQD+AOAPAP4AsIACFA8IAXCt1BQAAAAASUVORK5CYII=",
      "expect": {
        "size": {
          "axis": "y",
          "metres": 1.5,
          "tolerance": 0.05
        }
      },
      "target": {
        "size": {
          "axis": "y",
          "metres": 1.5
        },
        "engine": "godot4",
        "origin": "floor",
        "platform": "desktop",
        "collision": "convex"
      }
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "lods": [
        {
          "name": "asset.glb",
          "bytes": 2192,
          "error": 0,
          "ratio": 1,
          "vertices": 24,
          "triangles": 12
        },
        {
          "name": "asset-lod1.glb",
          "bytes": 2192,
          "error": 0,
          "ratio": 0.5,
          "vertices": 24,
          "triangles": 12
        },
        {
          "name": "asset-lod2.glb",
          "bytes": 2192,
          "error": 0,
          "ratio": 0.25,
          "vertices": 24,
          "triangles": 12
        }
      ],
      "tools": {
        "engine": "4.7.2.stable.official.ed1daf0bf",
        "transform": "@gltf-transform/core@4.5.0 meshoptimizer@0.24.0 sharp@0.34.5 resvg@2.6.2",
        "validator": "gltf-validator@2.0.0-dev.3.10"
      },
      "checks": [
        {
          "code": "structure_valid",
          "detail": "The glTF binary passed header, JSON, and gltf-validator structural checks.",
          "status": "passed"
        },
        {
          "code": "no_external_uris",
          "detail": "No buffer or image referenced an external (non-data:) URI.",
          "status": "passed"
        },
        {
          "code": "within_limits",
          "detail": "Triangle, material, texture, texture-pixel, and node counts are within configured limits.",
          "status": "passed"
        },
        {
          "code": "bounds_expected",
          "detail": "Expected extent along 'y' of 1.5 m; output measures 1.5000 m.",
          "status": "passed"
        },
        {
          "code": "rigged_expected",
          "detail": "No expect.rigged was declared.",
          "status": "not_checked"
        },
        {
          "code": "animations_expected",
          "detail": "No expect.minAnimations was declared.",
          "status": "not_checked"
        },
        {
          "code": "engine_loaded",
          "detail": "The output asset loaded and instantiated in Godot 4 headless.",
          "status": "passed"
        },
        {
          "code": "textures_within_budget",
          "detail": "Largest output texture edge is 64px against a 2048px budget.",
          "status": "passed"
        },
        {
          "code": "power_of_two_textures",
          "detail": "All output textures have power-of-two dimensions.",
          "status": "passed"
        },
        {
          "code": "lods_generated",
          "detail": "LOD1/LOD2 are identical to LOD0; the geometry is already below the simplifier's useful reduction threshold.",
          "status": "passed"
        },
        {
          "code": "collision_generated",
          "detail": "Convex hull has 8 vertices.",
          "status": "passed"
        }
      ],
      "output": {
        "bones": 0,
        "bytes": 2192,
        "nodes": 1,
        "skins": 0,
        "bounds": {
          "max": [
            0.75,
            1.5,
            0.75
          ],
          "min": [
            -0.75,
            0,
            -0.75
          ],
          "size": [
            1.5,
            1.5,
            1.5
          ]
        },
        "meshes": 1,
        "textures": 1,
        "vertices": 24,
        "materials": 1,
        "triangles": 12,
        "animations": 0,
        "primitives": 1,
        "maxTextureEdge": 64
      },
      "source": {
        "bones": 0,
        "bytes": 2192,
        "nodes": 1,
        "skins": 0,
        "bounds": {
          "max": [
            0.5,
            0.5,
            0.5
          ],
          "min": [
            -0.5,
            -0.5,
            -0.5
          ],
          "size": [
            1,
            1,
            1
          ]
        },
        "meshes": 1,
        "textures": 1,
        "vertices": 24,
        "materials": 1,
        "triangles": 12,
        "animations": 0,
        "primitives": 1,
        "maxTextureEdge": 64,
        "validatorErrors": 0,
        "validatorWarnings": 0
      },
      "status": "passed",
      "target": {
        "size": {
          "axis": "y",
          "metres": 1.5
        },
        "engine": "godot4",
        "origin": "floor",
        "platform": "desktop",
        "sourceUp": "y",
        "collision": "convex",
        "maxTextureSize": 2048
      },
      "repairs": [],
      "warnings": [
        "LOD simplifier could not reduce a mesh primitive below its LOD0 triangle count (12 triangles); the geometry is likely already below the simplifier's useful reduction threshold.",
        "LOD simplifier could not reduce a mesh primitive below its LOD0 triangle count (12 triangles); the geometry is likely already below the simplifier's useful reduction threshold."
      ],
      "artifacts": [
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/asset.glb",
          "name": "asset.glb",
          "sha256": "2a0a6c99a17389b01c396387e77314d0e310b051a9d678615cf93466265a67f3",
          "mediaType": "model/gltf-binary",
          "sizeBytes": 2192
        },
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/asset-lod1.glb",
          "name": "asset-lod1.glb",
          "sha256": "2a0a6c99a17389b01c396387e77314d0e310b051a9d678615cf93466265a67f3",
          "mediaType": "model/gltf-binary",
          "sizeBytes": 2192
        },
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/asset-lod2.glb",
          "name": "asset-lod2.glb",
          "sha256": "2a0a6c99a17389b01c396387e77314d0e310b051a9d678615cf93466265a67f3",
          "mediaType": "model/gltf-binary",
          "sizeBytes": 2192
        },
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/collision.json",
          "name": "collision.json",
          "sha256": "fdd3b75d3487097c27178cdca98bcac4eb4f11a543a4bcdd6ffc5be5344501a7",
          "mediaType": "application/json",
          "sizeBytes": 734
        },
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/godot-scene.tscn",
          "name": "godot-scene.tscn",
          "sha256": "c1fb2c48896dad0573523724f75dccae20ee908ce9b4b781da13fa5d6008da49",
          "mediaType": "text/plain; charset=utf-8",
          "sizeBytes": 718
        },
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/preview.png",
          "name": "preview.png",
          "sha256": "47b2fd78499eaa90802e7b6cb6975eb768d9265aa4e09f2f44b8e2b0dd265cb8",
          "mediaType": "image/png",
          "sizeBytes": 58228
        },
        {
          "href": "https://asset.api.williamrobinson.dev/v1/asset/artifacts/0123456789abcdef0123456789abcdef0123456789abcdef/report.json",
          "name": "report.json",
          "sha256": "a0cbca1d625aa46f23af80b57a8b98db3e1f77d424cce01643d0b8aec80ad853",
          "mediaType": "application/json",
          "sizeBytes": 5351
        }
      ],
      "collision": {
        "kind": "convex",
        "trimeshTriangles": 0,
        "convexHullVertices": 8
      },
      "expiresAt": "2026-01-04T03:04:05.000Z",
      "truncated": false,
      "validator": [],
      "engineLoad": {
        "nodes": 2,
        "engine": "4.7.2.stable.official.ed1daf0bf",
        "errors": [],
        "loaded": true,
        "materials": 1,
        "skeletons": 0,
        "animations": [],
        "meshInstances": 1
      },
      "limitations": [
        "No Unity or Unreal import is executed; for those engines the asset is normalised to standard glTF conventions their importers expect, not verified by running an actual Unity/Unreal import.",
        "Draco, EXT_meshopt_compression, and KTX2 (KHR_texture_basisu) inputs are rejected in v1; only embedded, uncompressed glTF geometry and PNG/JPEG textures are accepted.",
        "Normal-map and other non-colour texture colour space is not verified; textures are resized without reinterpreting their intended colour space.",
        "LOD error is the meshoptimizer geometric error bound actually reached (as a fraction of mesh radius), not a measure of visual/perceptual difference, and is not a proof the LODs are optimal.",
        "Godot's collision generation operates on the LOD0 mesh merged into one shape; per-part or compound collision shapes are not produced."
      ],
      "normalization": {
        "scale": 1.5,
        "translation": [
          0,
          0.75,
          0
        ],
        "rotationXDegrees": 0
      }
    }
  }
}