一、上传要求与规范
支持的文件格式：仅支持 .ply、.spz、.sog 格式的文件。
文件来源限制：由于坐标轴系统不同，目前仅支持外部来源的3DGS模型上传，不支持aholo生成的模型。
文件大小限制：上传的3DGS模型文件，总大小请务必控制在2GB以内，否则将导致上传或处理失败。
模型朝向建议：建议尽量上传正面朝前、无旋转角度的高斯模型。这样可以提升前端展示的角度精度，避免因模型朝向偏转导致预览角度与最终渲染角度不一致。
二、在设计方案中的使用说明
1. 模型尺寸调整
由于3DGS技术本身的特性，模型数据通常不包含标准的物理尺度信息。当您将模型拖入设计方案时，可能会出现比例过大或过小的情况。请在放入场景后，使用工具栏的缩放功能手动将其调整至适配当前空间的尺寸。
2. 场景预览说明
为了保障您在设计时的流畅体验，酷家乐3D前端场景会使用轻量化转换后的模型进行展示。因此，您在前端设计界面看到的局部细节或材质，可能与原始模型存在轻微偏差（例如复杂结构的适度简化）。这属于正常现象，最终高质量效果请以渲染结果为准。
三、渲染支持与使用限制
1. 推荐使用的渲染模式
出图与视频类型：支持普通图、全景图、俯视图以及普通漫游视频。
灯光模板限制（重要）：支持实时白天/夜晚+极速白天/夜晚3.0及以上版本+室内白天/夜晚3.0及以上版本的灯光模板；支持实时轻量渲染内的系列光影模板。
2. 暂不支持或受限的功能（请尽量避免使用）
视频动效限制：暂不支持在视频中为3DGS模型添加“模型动效”（移动等动画效果会出现方向计算错乱）。
模板视频限制：受引擎兼容性限制，大部分复杂的特效模板视频暂不支持。受限模板包括但不限于：生长动画系列（户型/软装/全屋等）、卡点变装/卡点生长系列、酷炫组合动画、悬浮动画等。
四、灯光与材质的高级建议（混合渲染说明）
由于 3DGS 模型本身已经“烘焙”了实景拍摄阶段的真实颜色与光照信息，它并非基于传统物理材质构建。在将其融入您的酷家乐场景时，请注意以下现象：
阴影表现：模型受场景灯光影响时，无法像普通模型一样完全遵守物理规则，可能会出现不能正确投射阴影或接收场景阴影的情况。
曝光与发白问题：在室内较暗、环境光过亮的情况下，3DGS模型表面可能会出现发白、白影等光照异常。
优化建议：如果您在渲染时发现3DGS模型整体过亮或存在泛白现象，建议您在渲染高级设置中，适当调低/关闭外景的“环境光亮度”，这能有效改善模型与场景的融合效果。
四、视频教程
一、功能介绍
无需手动绘制，一键解锁实景还原与创意设计！该功能支持上传真实场景图片及全景图，自动识别并生成户型，后续可在工具内自由二次设计，完成后一键渲染全新效果图。更灵活的是，识别生成户型时，用户可自主选择是否清除软装及定制家具：若选择不清除，可精准还原上传图片中的真实场景布局；若选择清除，则生成纯净户型基底，灵活适配各类设计改造需求，助力用户高效开启设计工作
二、面向用户
拥有该功能权限的用户，逐步开放中~
三、注意事项
设计工具中显示的点云存在破洞属于正常现象，该点云仅作为设计参考使用，最终渲染效果将呈现高清实景
四、功能描述
1、入口
在设计工具中，点击左侧栏的画户型—实景导入
2、上传普通图/全景图
1）生成点云
第一步：在实景导入页面，你可以根据需要选择上传普通图/全景图，接下来点击上传，在弹出的面板中选择要上传的图片，然后点击打开（也可以直接拖拽图片至此处上传）
若是没有合适的图片/全景图，可以选择下方推荐的示例
上传普通图和全景图的格式要求如下表：
a.普通图：
条件 范围 推荐
像素范围 480*480以上 2K
文件大小 无要求 1~5MB
格式 jpg、jpeg、png、webp 均可
拍摄要求
相机高度：1.3米~1.6米
相机朝向：拍摄位置背靠空间的一面墙，相机朝向与对面墙垂直，平视角拍摄
相机高度：1.4米（根据现场不同高度能够拍摄到的内容灵活调整）
b.全景图：
条件 范围 推荐
像素范围 1440*720以上 3000*1500
比例要求 2：1 2：1
文件大小 无要求 1~5MB
格式 jpg、jpeg、png、webp 均可
拍摄要求
必须是鱼眼全景图（专业全景图拍摄设备，非手机全景图）
相机高度：1.3米~1.6米
相机朝向：拍摄位置尽量靠近空间中心，相机朝向与任意墙垂直，平视角拍摄
相机高度：1.4米
（根据现场不同高度、不同相机位置能够拍摄到的内容灵活调整）
第二步：上传成功后，会自动判断是全景图还是单图（如有错误可手动修改），然后根据需要选择是否清理软装和定制（示例为关闭），设置完成后，点击开始创建
关闭自动清理软装和定制柜选项后生成的全景图中会保留原有的软装和定制柜
第三步：识别户型生成点云，如下图所示：
第四步：生成点云后，可以在顶部设置层高，同时需要确认xy平面下的户型方向是否正确，如果不正确，可以使用右下角旋转轴及顶部的旋转工具进行调整
第五步：调整完成后，点击开启设计
2）放置软装和定制家具
第一步：在设计工具中，可以看到生成的户型
点云存在破洞属于正常现象，最终渲染效果将呈现高清实景
第二步：选择需要的软装模型和定制家具放置户型中
3）渲染出图
第一步：素材放置完成后，点击进入渲染—离线模式
如果你想实时预览设计效果，可以选择使用实时专业模式（实时渲染详细内容：点击查看)
第二步：渲染时，普通图和全景图会自动运用最佳视角，然后在左侧模板选择需要的清晰度以及专属灯光模板，点击立即渲染（渲染时会做AI增强，为保障渲染质量，渲染的普通图不要超过4K，渲染的全景图不要超过6K）
注意：渲染普通图与全景图时，2D 视角会显示绿色椭圆最佳拍摄区域，相机在该区域内可自由调整，均能渲染出高质量的效果图
第三步：渲染完成后，可以点击右上角的图册查看效果
3、上传3DGS文件
1）生成点云
第一步：在实景导入页面，可以上传3DGS文件，你可以通过点击上传，在弹出的面板选择要上传的文件，然后点击打开（也可以直接拖拽文件至此处上传）
第二步：上传完成，点击开始创建
第三步：识别户型生成点云，如下图所示：
生成点云户型后，您可借助界面右下角的旋转轴，配合顶部工具栏中的旋转、剖切、顶底等工具，对点云户型的位置、角度与显示范围进行精准调整
第四步：点击开启设计
2）放置模型素材
根据需要在户型中放置合适的家具素材（如：装饰画、窗帘、窗、定制柜等）
3）渲染出图
第一步：素材放置完成后，点击进入渲染—离线模式
如果你想实时预览设计效果，可以选择使用实时专业模式（实时渲染详细内容：点击查看)
第二步：进入渲染页面，先在顶部选择渲染类型，然后调整至合适的视角，接下来在左侧模板选择需要的清晰度以及专属灯光模板，点击立即渲染（渲染时会做AI增强，为保障渲染质量，渲染的普通图不要超过4K，渲染的全景图不要超过6K）
第三步：点击右上角的图册查看渲染效果
一、功能介绍
渲染视频时，用户可以根据需要选择视频构图、灯光及外景，然后通过导入或自定义镜头片段，快速生成符合需求的视频片段，并可根据实际需要选择不同的清晰度进行渲染
二、面向用户
所有用户
三、操作步骤
第一步：在设计工具页面把鼠标放置顶部的渲染，然后点击进入离线模式
第二步：进入离线模式界面后，点击顶部的视频，然点击左侧栏的基础，设置构图、灯光模板及外景
设置构图：直接点击不同构图比按钮，可进行切换最终生成的视频构图比，并且可以在主视窗中预览效果，也可以在右侧参数面板对镜头高度及视野进行调整，如下图所示：
设置灯光：不同的灯光会影响最终生成视频的效果，在灯光模块中，可以选择不同的灯光模板，也可以在右侧参数面板调整灯光模板的参数，如下图所示：
设置外景：在外景模块中，可以选择不同的外景，也可以在右侧参数面板调整外景参数，如下图所示：
第三步：点击左侧栏的镜头库，在顶部选择空间镜头/商品镜头，可以直接选择左侧的镜头点击导入，也可以鼠标转动至合适的位置点击底部的添加片段，添加完成点击右下角的生成视频
运镜：添加镜头详细操作可见线上文档：点击查看
第三步：在弹出的生成视频窗口，可以选择保存预览视频/渲染视频，然后选择自己需要的清晰度点击确定即可
注意：选择不同的清晰度会显示不同的消耗额度
四、常见问题
Q1：什么是视频额度？
A1：生成渲染视频可使用，每15秒视频消耗1额度，详细说明如下：
用户范围：所有用户均有视频额度，不同档位的额度不同
账号额度：不同等级账号的额度以购买时说明为准，同一等级额度一致
发放时间：每周一发放当周的视频额度，周日晚当周额度过期
Q2：购买账号时送的视频券是否还能用？
A2：部分账号之前购买时有赠送视频券，仍可继续使用。新购买和续约账号会陆续停止送券，账号内视频权益升级为上述周额度
Q3：额度用完还想渲怎么办？
A3：可升级更高级别账号或购买视频券进行使用
Q4：使用额度渲染失败后是否会返回额度？
A4：若渲染失败，以视频券的形式进行返还，券有效期一周
Q5：额度和券的区别是什么？
A5：额度是购买账号内赠送的【权益】无实体券；券是自主购买的商品或参加活动获得的奖品
一、功能介绍
面向AI智能设计平台商家主账号指导商家完成AI智能设计后台自定义选品配置教程
二、面向用户
商家主账号
三、操作步骤
当现有的系统选品无法满足需求时，商家可配置自定义选品，来满足部分个性化的布局需求：
1、点击“添加自定义选品”，依次输入自定义选品编码（如没有接入第三方系统，可填写为随机数字/字母）、选品名称、文件夹路径和二级标签选择、是否支持缩放及展示
2、 根据选品的常见尺寸，输出默认的长和宽，并选择图例所属
例：
3、 如希望自定义选品自动布局，可以设置“布局规则“
例：希望能够在厨房的台面上自动放置小家电，可以以普通地柜的地面中心点为参照点，设置x轴和z轴来代表选品距离中心点的距离和高度即可实现自动布置
注意，需考虑所关联选品范围中的最大或最小尺寸，是否都能够容纳在此规则中，否则会出现穿模等情况。
4、自定义选品布置规则引导：https://kujl.cc/MWEA
一、本月公开课排期日历：
⚠️更多棚拍公开课需求点我：https://www.wjx.cn/vm/mk23sMj.aspx#
二、棚拍历史公开课回放（2025）
【酷家乐棚拍公开课回放】请点击此处
三、推荐有礼
扫码添加，领取限时优惠
一、试用申请入口
开放平台——应用市场——【酷品秀】
https://www.kujiale.com/saas/market/detail?id=3FO4K4VYMNEY
二、规则说明：
1. 确认购买试用版（商品量5）后，系统将自动开通酷品秀上架展位功能权限；
2.申请成功后，请联系客户成功顾问，协助体验酷品秀。
3. 目前只支持3Dmax模型生成酷品秀，非3Dmax模型（如硬装、定制类参数化模型）请联系客户成功顾问。
4. 试用期到期后，系统将自动关闭体验权限，体验期间产生的所有数据都将保留；正式购买后数据可被再次使用。
快来免费体验吧！
一、功能背景
1. 你是否也曾遇到这种情况：
轴心调了半小时，没法复用至其他场景？
灯光/模型动画做了一天，运营突然要换场景？
多店铺出多个视频，换个场景就得重打关键帧？
2.「场景模板」来解决：
场景模板可将灯光、相机、动画、模型参数保存为成模板，支持跨场景、跨子账号复用，减少重复操作，大幅提升设计效率。
二、面向对象
面向棚拍付费企业客户，主账号及绑定电商棚拍管理员角色的子账号
三、功能详情
1. 如何使用
功能入口：在层级面板选中目标对象后右键点击，选择「保存为场景模板」，输入模板名称并选择存储文件夹，确认后完成保存。
模版调用：左侧「企业库」面板 -「场景模版」- 选择任一模版放置到场景内适当位置即可
多选的对象中至少包含一个模型/空对象（单个模型/空对象也支持另存为企业场景模板库）
多选对象的数量需控制在200个以内
2. 功能教程
3. 不同角色操作权限
角色
操作权限
限制
主账号 / 电商棚拍管理员
创建、重命名、删除、迁移模板；
管理企业场景模版文件夹；
无
企业内子账号
调用模板、替换模型、调整已解锁的动画参数
不可修改、删除模板及管理文件夹
一、功能介绍
多张产品图智能一键成片，支持多角度产品套图选用或自定义上传产品图，无需复杂操作，可快速生成适配各类营销场景的产品视频，高效助力产品推广。
二、面向用户
所有核豆解决方案客户
三、功能详情
功能入口1：AI工具箱 - 无限画布 - 上传图片 - 多选三张及以上图片 - 点击工具栏【AI营销视频】快速生成
功能入口2：AI工具箱 - 多角度套图 - AI营销视频（建议选择多角度呈现效果较好的图片去生成视频）
视频构图比不支持指定，按照首帧图自适应生成
图片文件大小不能超过10MB，图片宽高尺寸不小于300px
案例教程
一、功能介绍
面向AI智能设计平台商家主账号 指导商家完成AI智能设计后台成品组合实施教程（全）
二、面向用户
商家主账号
三、操作步骤
一、 采用公库成品素材
选择以下方案复制到自己账号
(1) 现代浅色-10.23（6套全屋软装）
(2) 现代深色-10.27(9套全屋软装）
(3) 奶油现代-11.18（6套全屋软装）
(4) 轻奢现代-1.7（12套全屋软装）
(5) 轻奢意式-11.11（6套全屋软装）
(6) 奶油法式-12.2（15套全屋软装）
(7) 极简黑白组合-10.13（15套全屋软装）
(8) 包豪斯-10.31（6套全屋软装）
(9) 现代中古-11.17（12套全屋软装）
(10) 侘寂中古-9.5（3套全屋软装）
(11) 法式中古-10.29（9套全屋软装）
(12) 北欧原木-10.16（9套全屋软装）
(13) 宋式美学-11.7（12套全屋软装）
(14) 简欧-10.13（3套全屋软装）
(15) 轻美式-12.29（9套全屋软装）
(16) 新中式组合模型-12.17（3套全屋软装）
(17) 南洋复古组合模型-12.19（1套全屋软装）
(18) 儿童房组合模型-12.2
(19) 梳妆台组合模型-12.11
(20) 岛台组合-11.17
(21) 麻将桌组合-11.24
(22) 钢琴组合-11.24
(23) 阳台座椅组合-12.29
(24) 茶桌组合模型-1.13
2.进3D工具—解组—打组—收藏/投稿至企业库
3. 进企业商家库—模型/材质—组合库—未分类—选择对应组合—添加到专用文件夹
二、 采用企业成品素材
创建对应风格方案——进工具打组——收藏/投稿至企业库
打组教程参考：https://kujl.cc/KOKu
搭配参考教程：https://kujl.cc/KOLz
三、 采用青山会成品素材
详见：https://kujl.cc/KOKY
四、注意事项（必看）
商品真分类需准确
a. 【渲染分类】
组合类型 真分类id 渲染真分类要求规范
床组合 床（主商品） 101（床）
199（单人床）
200（双人床）
201（高低床/母子床）
257（儿童床）
3798（床架）
床头柜 137（床头柜）
地毯 116（地毯）
沙发组合 沙发
204（双人沙发）
205（多人沙发）
203（单人沙发）4165（靠背椅）
209（躺椅）
234（沙发凳）
192（凳子）
211（沙发贵妃椅）
3836（懒人沙发）
茶几 152（茶几/茶座）
边几 边几
书桌组合 书桌 147（书桌）
270（书桌组合）
书椅 151（餐椅）
155（吧台椅）
179（靠背椅）
192（凳子）
203（单人沙发）
247（椅子）
384（办公椅）
655（椅子/凳子）
卧室书桌组合 卧室书桌 146（梳妆台）
147（书桌）
270（书桌组合）
椅子 151（餐椅）
154（床尾凳）
155（吧台椅）
179（靠背椅）
192（凳子）
203（单人沙发）
234（沙发凳）
247（椅子）
655（椅子/凳子）
饰品类 陈设饰品
b. 所有AI智能设计平台中支持的布局品类，都可以用【成品组合库】或者【混合组合库】中的商品来匹配。但建议必须将以下4个品类维护成组合库，以便AI可以拆分匹配，后续可以更好的适配不同的户型效果；
i. 沙发组合：
1. 双人/多人沙发
2. 单人沙发
3. 茶几
4. 地毯
ii. 床组合：
1. 床
2. 床头柜
3. 地毯
iii. 餐桌椅组合：
1. 餐桌
2. 餐椅
iv. 书桌椅组合：
1. 书桌
2. 书椅
3. 单人沙发
4. 地毯
2、单商品上传的正方向需准确
c. 成品单品和组合家具的【正方向】需要符合酷家乐上传的主流商品正方向，参考如图；正方向不准确会出现匹配时商品反向的情况，如图所示
i. 组合里面的企业单品方向在上传前需为正方向：即3D建模时前视图=商品正方向
ii. 组合打组时的方向需为正方向：以封面图实际渲染为正即可
✅ ❌
3、成品组合的主商品需准确
d. 成品家具组合的主商品设置正确，例如床组合的主商品是床，沙发组合的主商品是沙发
e. 设置不正确会导致组合匹配的时候，正方向匹配错误，出现如图的情况