splat_generate
Generate Gaussian-splat worlds from local videos or image sets, then track background jobs and retrieve completed asset paths.
Instructions
Generate or inspect a Gaussian-splat world from local media.
Operations: from_video - start a job from a video file (video_path required) from_images - start a job from a set of images (image_paths required) status - check a job's status (job_id required) list - list all known jobs get_asset - return asset paths for a completed job (job_id required)
from_video/from_images return IMMEDIATELY with status="running" - the real ns-process-data -> ns-train -> ns-export pipeline runs as a background task (real training takes real minutes, not seconds). Poll with operation="status" until status is "done" or "failed".
Return Format
Always a dict with a success bool and a human-readable message.
Success paths also carry the documented payload keys (job_id, status,
jobs, asset_paths). Error paths carry success: False plus an error
key with the machine-readable reason; the error key is kept for backward
compatibility with existing clients.
Examples
splat_generate(operation="from_video", video_path="D:/cap/walk.mp4")
-> {"success": True, "job_id": "...", "status": "queued", "message": ...}
splat_generate(operation="status", job_id="<id>")
-> {"success": True, "job_id": "<id>", "status": "running", "message": ...}
splat_generate(operation="list") -> {"success": True, "jobs": [...], ...}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"operation": "<operation>"
},
"name": "splat_generate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No | ||
| operation | Yes | ||
| video_path | No | ||
| image_paths | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||