splats2Mesh
Submit the splats2Mesh task
/api/v2/tasks:splats2MeshAuthentication WLT-Api-Key
Submit the task once, persist its operation ID, and use the long-running operation lifecycle to retrieve the terminal result. Read the guide.
Query parameters
waitbooleanBlock for the operation to finish before returning, up to the server wait cap. Returns the Operation either way — done with a response if it finished in time, otherwise still running.
falseHeaders
Idempotency-Keystring | nullOptional idempotency key.
length <= 128Request body
application/jsonRequired
Body of a splats2Mesh request.
webhookUrlstring | nullWhere Marble POSTs one signed task.succeeded or task.failed event when this operation finishes; retried for 24 hours. Verify the signature with the public keys at /.well-known/webhooks/jwks.json. Cannot be combined with ?wait=true. https on port 443 only, no IP literals. Developer API only.
length <= 2048purgeContentOnOperationCompletionboolean | nullPurge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
camerasarray<PinholeCamera> | CamerasManualAnchors | CamerasAutoAnchors | CamerasExteriorSphere | nullCameras the splats are rendered from. The surface is reconstructed from those renders, so geometry no camera sees is not meshed. Name a strategy -- auto_anchors (the default) finds viewpoints in the scene's free space, manual_anchors takes them from the request, exterior_sphere rings the scene from outside for an object or turntable capture -- or pass a list of cameras to render as given, at most 512, sharing one width and height between 64 and 1024 that becomes the render resolution.
advancedOptionsSplats2MeshAdvancedOptions | nullFiner control over how the splats are rendered and how the surface is extracted. Omit for the defaults.
orientedBoundingBoxSplats2MeshOrientedBoundingBox | nullRegion to extract, as an oriented box in Three.js coordinates. Omit to mesh the whole scene.
targetFacesinteger | nullDecimate the extracted mesh to at most this many faces. A target above the extracted count does nothing. Omit to keep every face.
1 <= valuetextureModestringMesh appearance: 'image_texture' projects rendered views onto a UV atlas, 'vertex_color' bakes per-vertex colors, and 'none' leaves the mesh untextured.
"image_texture""image_texture", "vertex_color", "none"textureSizeintegerHeight and width of the texture atlas, in pixels, for image_texture mode. One rendered view plus its border has to fit, so this must be at least 2% above the render size in play: the larger render bank under the anchor strategies, renderHw under exterior_sphere, or the supplied cameras' own size.
1 <= value <= 81924096splatAssetobjectrequiredThe Gaussian splat scene (.spz) to mesh. Inline base64 must carry a data: prefix to declare its media type: asset creation otherwise infers the type from the bytes, and the sniffer knows image formats only.
Responses
201
Successful Response
application/json
Long-running operation whose successful terminal response has type Splats2MeshResponse. This is the common Operation envelope with a task-specific response type, not a separate operation resource.
idstringrequiredShort operation id used in /operations/{operation} paths.
ownerIdstringrequiredAccount that owns the operation.
metadataobject | nullTask information and optional progress details. Use metadata.task to interpret a generic operation response, and use done to determine completion.
donebooleanrequiredWhether the operation is terminal. When true, a non-null error indicates failure; otherwise the operation succeeded.
errorOperationError | nullFailure details when done is true and the task failed; null while running and after success.
expiresAtSecsinteger | nullTask execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
createdAtSecsinteger | nullUnix seconds when the operation was accepted.
responseSplats2MeshResponse | nullSplats2MeshResponse result when done is true and the task succeeded; null while running and after failure.
namestringrequiredFull resource name for the operation.
For project operations:
accounts/{account}/projects/{project}/operations/{operation}.
Operation paths accept the short id.
422
Validation Error
application/json
detailarray<ValidationError>Request example
Completed operation