用途:从多张参考图生成 3D 世界(World Labs Marble),支持方向控制或自动布局。
主要能力:方向控制模式下可为每张图指定方位角(0 前、90 右、180 后、270 左,支持 0-360 任意值),最多 4 张,建议不重叠,模型会创意填充视角间隙;自动布局模式最多 8 张,模型自动定位,适合重建已有空间,要求所有图宽高比、分辨率一致,同一空间、视觉重叠、光照与色温一致。
使用方式:通过 API 调用,请求体 type 为 multi-image,multi_image_prompt 数组内每项含 content(source 为 media_asset 时填 media_asset_id;为 uri 时填公开 URL),方向控制时附加 azimuth 字段,自动布局时省略 azimuth。可选 text_prompt 文本描述。模型可选 Marble 0.1-plus(1,600 积分)或 Marble 0.1-mini(250 积分)。上传流程为 POST /media-assets:prepare_upload 获取 media_asset_id 与 upload_url,再 PUT 上传文件,最后 POST /worlds:generate,请求头使用 WLT-Api-Key。
适用场景:室内四角(azimuth 45/135/225/315)、街景双向(0/180)、创意视角连接、空间重建等。自动布局主要为界面功能,API 中通过省略 azimuth 实现。
限制与排错:方向控制建议风格、光照一致;自动布局必须规格一致且重叠,否则失败。接缝问题多因光照不一致,浮空物体因深度冲突,几何扭曲因参考图差异过大,均需改用更一致的参考图。相关技能包括 world-labs-api、world-labs-image-prompt、world-labs-pano-video。具体价格、平台支持情况暂未提供。