用途:在 Scenario 平台上通过 MCP 生成可探索的 3D Gaussian splat 环境,属于体素化场景而非多边形网格,可实时漫游渲染,无 UV 或拓扑可编辑(Marble splat 可导出三角网格或碰撞网格)。模型来自三家:World Labs Marble(三档画质)、混元 HY World 管线、面向单个物体的 TripoSplat。先用 search 发现模型,把 model_schema_get 当作契约;作者时 HY World 成员带有地域限制标记,命中结果因团队和区域而异。
输入与选型:文本创意用 Marble 任意档;单张图片(平面或 360,360 需 isPano: true)用 Marble;2 至 8 张同一场景照片用 Marble;漫游视频用 Marble 或 HY Multi-view to Splat;大量重叠照片用 HY Multi-view to Splat(作者时支持 2 至 64 张);地点单图先 HY Image to Skybox 再 Skybox to Splat;物体单图用 TripoSplat,自动去背景。图像与视频并存时互斥;isPano 仅在恰好传一张图时适用。TripoSplat 面向单个干净物体,其余面向场景,错配是主要失败模式。
用法要点:Marble 三档(1.0 Draft、1.1、1.1 Plus)输入相同,相同输入与种子在各档复现同一世界;先在 Draft 迭代(作者时约一分钟返回),再用相同参数在 1.1 或 1.1 Plus 复跑;各档成本差逾十倍,提交前先 dry_run。splatResolution 选存储密度(100k、500k、full);disableRecaption: true 阻止 Marble 改写提示词。HY World 管线耗时长:Image to Skybox 是图像模型,把单张地点照片扩展成 2:1 等距柱状全景;其资产 id 作为 panorama 传给 Skybox to Splat,三个轨迹开关(applyNavTraj、applyUpRoute、applyReconIteration,默认 true)决定成本与时间,maxSteps 仅微调清晰度;splat 阶段作者时中位耗时近一小时,需反复用 pending_job_ids 调用 jobs_wait,超时不等于失败,不应重发 model_run。Multi-view to Splat 则快速且便宜,适合相机穿过静态场景且有视差的素材。
限制:splat 不提供 UV 或可编辑拓扑,多边形资产需用 scenario-3d 的网格生成器;天空盒专用工作用 scenario-skyboxes;连接与核心流程见 scenario 技能。缺失同级技能时请用户安装(npx skills add scenario-labs/skills --skill <name>),无人值守时依据工具 schema 继续并标注缺口。常见错误:图像与视频同传、360 单图漏 isPano: true、草稿与升级档之间更改或省略种子、给 TripoSplat 传场景或给世界模型传孤立物体、把 Skybox to Splat 的 jobs_wait 超时当作失败、指望靠 maxSteps 提升画质或降本。