Raw schema
{
"type": "object",
"properties": {
"file_url": {
"type": "string",
"description": "Public HTTPS URL to download the source BIM/CAD file. Must be reachable without auth from Cloudflare Workers egress. Supports rvt, ifc, nwd, dwg, dgn, 3dm, stp, obj, and other APS-supported formats. Signed URLs (S3/GCS) work if the signature is embedded in the query string.",
"examples": [
"https://example-cdn.com/projects/office-tower.rvt",
"https://storage.googleapis.com/bim-uploads/site-model.ifc?X-Goog-Signature=..."
]
},
"file_name": {
"type": "string",
"description": "Filename with extension used as the OSS object key. Non-alphanumeric characters are sanitized to underscores. Extension drives APS translator selection (.rvt → Revit, .ifc → IFC, etc.). For downstream Twinmotion/UE import, keep the base name meaningful (e.g. 'TowerA_L01-L20.rvt' → later exported as TowerA_L01-L20.fbx / .glb / .usd).",
"examples": [
"Building.rvt",
"SitePlan.ifc",
"Factory_v3.nwd",
"Terrain.dwg"
]
},
"include_materials": {
"type": "boolean",
"description": "If true (default), the translation preserves material/texture data so the derivative is visually meaningful in Twinmotion/UE. Set false only for geometry-only pipelines (faster, smaller derivatives).",
"examples": [
true,
false
]
},
"lighting_preset": {
"type": "string",
"enum": [
"default",
"natural",
"studio",
"evening"
],
"description": "Lighting preset label stored alongside the import — purely metadata for downstream tm_render_image / UE scene setup; does not affect the APS translation itself. 'natural' = daylight sun+sky, 'studio' = neutral 3-point, 'evening' = warm low sun.",
"examples": [
"natural",
"studio"
]
}
},
"required": [
"file_url",
"file_name"
]
}