posedImages2Splats
Submit the posedImages2Splats task
/api/v2/tasks:posedImages2SplatsAuthentication WLT-Api-Key
Reconstruct refined Gaussian splats from ordered posed RGBD frames. A run usually takes 10 to 20 minutes, so persist the operation ID and poll or use a webhook. 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 POST /api/v2/tasks:posedImages2Splats.
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.
promptstring | nullOptional scene description. Enhancement combines it with the input images; when omitted, enhancement captions the images.
1 <= lengthenhancePromptbooleanEnhance the prompt using the context images before generation. Set false with a prepared prompt to skip enhancement and reduce latency.
trueregionOfInterestOrientedBoundingBox | array<OrientedBoundingBox> | nullOriented box to focus the reconstruction on, or a list of them for separate areas. Each box should enclose both the geometry of interest and the space it can be viewed from. The rest of the scene is still reconstructed from the frames. Omitted, the task covers the whole capture.
posedFramesarray<PosedRGBDAsset>requiredOrdered posed RGBD frames (2 to 512): each image an account asset, inline bytes, or a public URL, with its camera and its depth buffer (a linear-depth EXR under depth.depthAsset, as images2PosedRGBD returns). Every camera grid must be 1280x720, 720x1280, 960x720, or 528x704 (width x height), and all frames must use the same grid. RGB images are resampled to the camera grid.
Responses
201
Successful Response
application/json
Long-running operation whose successful terminal response has type PosedImages2SplatsResponse. 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.
responsePosedImages2SplatsResponse | nullPosedImages2SplatsResponse 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