Meltflex - Ai Room Design

MeltFlex AI Skills

通过 MeltFlex AI 提供用于照片级真实感室内外设计与 3D 的 AI Agent 技能——只需一张照片，即可重新设计房间、摆放真实家具、更换地板、墙壁、楼梯、门窗，改造厨房、浴室、建筑外立面和花园，还能将 3D 草图变成照片。更进一步：创建电影级漫游视频、将2D 户型图 → 3D 模型或渲染后的 3D 图片、将家具照片 → GLB 3D 模型，以及将照片 → 可探索的 3D 世界。适用于 Claude Code、 Hermes、Cursor、Codex、Cline，以及其他可加载基于 Markdown 的技能或支持 MCP 的 AI Agent。

每位用户都使用自己的 MeltFlex API 密钥进行身份验证；每次生成都会从其账户额度中扣费。这些技能直接调用公开的 MeltFlex API，无需额外安装任何内容。

_{室内改造 · 根据材料改造地板 · 花园设计——这是 16 种图像模式中的几种，均只需一张照片。}

_{家具照片 → 3D 模型 · 房间渲染图 → 可探索的 3D 世界 · 2D 户型图 → 3D 模型。由 /api/v1/furniture-3d、/api/v1/world 和 /api/v1/floorplan-to-3d 生成的实际成果。}

安装

任选一种方式。每种方式都会为你的 Agent 配置技能。

npx skills — 推荐，支持多种 Agent

npx skills add MeltFlexDevs/skills

GitHub CLI（v2.90+）

gh skill install MeltFlexDevs/skills

Claude Code marketplace

在 Claude Code 中：

/plugin marketplace add MeltFlexDevs/skills
/plugin install meltflex@meltflex

设置脚本

通用备用方案：

git clone --depth 1 https://github.com/MeltFlexDevs/skills.git
cd skills
./setup

更多选项见 INSTALL.md。由 Agent 驱动的安装（粘贴到你的 Agent 中）：INSTALL_FOR_AGENTS.md。Cline 及其他使用 MCP 设置的 Agent：llms-install.md。

身份验证

你需要有效订阅（任何付费方案）——否则密钥将无法使用。在 https://www.meltflexai.com/settings 订阅后，打开账户设置 → Profile 下的 API Key，然后点击 Generate API Key（密钥只显示一次——请复制）：

然后将其设为环境变量：

export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"

如果你使用 MCP 服务 / CLI，可以跳过复制粘贴，改为在浏览器中登录：npx -y meltflex-mcp auth login 会打开 https://www.meltflexai.com/cli/authorize，根据你已登录的会话生成密钥，并将其保存到 ~/.meltflex/config.json（chmod 600）。

技能

技能	调用方式	描述
meltflex-design	/meltflex:design	重新设计房间、外立面或花园；更换地板、墙面、楼梯、门或窗；重新设计厨房或浴室；优化布局；将 3D 草图变成照片。包含 16 种由提示词驱动的模式，支持质量等级、区域编辑和批量处理，以及通过 API 生成的视频漫游。
meltflex-furniture	/meltflex:furniture	将指定的真实家具／装饰产品放入房间照片中，精确匹配其颜色、材质和比例（最多 10 件参考物品）。
meltflex-3d	/meltflex:3d	3D 输出：将家具照片转换为 GLB 模型，将 2D 平面图转换为 GLB 模型或渲染后的 3D 图片，或将房间照片转换为可探索的 3D 世界（splat + 托管查看器）。支持长时间构建的轮询。
meltflex-embed	/meltflex:embed	通过 iframe 将设计工具嵌入你自己的网站：访客无需账户即可设计房间，或将你商店的产品放入房间中。可将代码安装到 HTML、React、Vue、Shopify 或 WordPress 中，并修复空白框架。无需 API 密钥。

图像技能可独立使用：输入房间照片，输出照片级真实感的改造效果；每张图像收费 10 个点数（失败时自动退还）。

图像模式

meltflex-design — 16 种模式，每种模式都使用同一个 POST /api/v1/generate 端点，并搭配针对该模式调整的提示词：

模式	用途
restyle	更改房间的风格或主题
virtual_staging	为空房间布置家具
layout_boost	重新摆放现有家具，优化布局
declutter	整理空间／去除个性化装饰
exterior	建筑外立面／房屋外观
garden	景观设计和户外设计
wall_texture	更改墙面材质或表面效果
floor_restyle	更换地板
stairs	原地重新设计楼梯
doors	更换室内门
windows	更换窗框／玻璃
kitchen	全面重新设计厨房
bathroom	全面重新设计浴室
photo_to_render	将 3D 草图／SketchUp 截图转换为照片
seasonal	更改一天中的时段／季节／光照效果
region_edit	仅更改一个区域——将其涂成纯红色，并发送 mask: true

每次图像调用都可选填：resolution（512 / 1K / 2K）、designLevel（lite −2 点 · quick · pro +5 点）、variations（每次调用生成 1–3 张，按图像计费），以及最多 10 个 referenceImageUrls。

视频与 3D

同一密钥，五种额外输出。三种 3D 构建可能需要几分钟；如果耗时超过请求时限，则会返回 HTTP 202 + 轮询 URL，/meltflex:3d 会说明如何轮询。

输出	端点	积分	耗时	MCP 工具 · CLI
电影感漫游视频（MP4，Veo 3.1）	POST /api/v1/video	100（4s）/ 150（8s）	~1 分钟	generate_video · meltflex video
平面图 → 渲染后的 3D 图片（PNG）	POST /api/v1/floorplan-to-3d output: "render"	10	~20 s	仅限 REST
平面图 → GLB 3D 模型	POST /api/v1/floorplan-to-3d output: "model"	100	~3 分钟	floorplan_to_3d · meltflex floorplan
家具照片 → GLB 3D 模型（+ USDZ/FBX/OBJ）	POST /api/v1/furniture-3d	75	2–3 分钟	furniture_to_3d · meltflex furniture
照片 → 可探索的 3D 世界（.spz + 查看器链接）	POST /api/v1/world	30（draft）/ 200（hd）	~1 / ~5 分钟	generate_world · meltflex world

包含响应正文以及 three.js / Spark 加载器代码片段的完整参考文档：https://www.meltflexai.com/api。

快速参考

你想做什么	技能	备注
根据照片为房间换风格	meltflex-design	选择模式，编写具体的提示词
为空房间添置家具	meltflex-design	virtual_staging 模式
摆放特定沙发/床/桌子	meltflex-furniture	将产品图片作为参考传入
重新设计房屋外观或花园	meltflex-design	exterior / garden 模式
更换地板或墙面饰面	meltflex-design	floor_restyle / wall_texture（将材料作为参考附加）
为楼梯、门或窗换风格	meltflex-design	stairs / doors / windows 模式
重新设计厨房或浴室	meltflex-design	kitchen / bathroom 模式
将 3D 草图转换为照片	meltflex-design	photo_to_render 模式
仅更改一个标记区域	meltflex-design	region_edit — 将其涂成红色，设置 mask: true
输出更清晰 / 提供多个选项	meltflex-design	resolution: "2K"、designLevel: "pro"、variations: 3
电影感漫游视频	meltflex-design	POST /api/v1/video（100–150 积分）
家具单品的 3D 模型	meltflex-3d	POST /api/v1/furniture-3d（75 积分）
2D 平面图 → 3D 模型 / 3D 图片	meltflex-3d	POST /api/v1/floorplan-to-3d（100 / 10 积分）
以 3D 方式漫游房间	meltflex-3d	POST /api/v1/world（30 draft / 200 hd）
查看积分余额	—	meltflex credits（CLI）或 MCP check_credits 工具

在你的网站中嵌入

_{已在 Kondela 家具商店上线：顾客可在商店自有页面上，将商店自有商品放入房间照片中。}

无需 API 密钥，也无需后端：在 Website Embed Builder 中创建嵌入内容（设置你的域名、Logo、颜色、语言；商店还可设置产品源），然后粘贴一个 iframe。访客无需账号即可在你的页面上设计房间；每次设计会从你的账户扣除 10 积分。任何账户均可获取代码和 10 次免费设计；之后需使用 Enterprise plan。

<iframe
  src="https://widget.meltflexai.com/YOUR_EMBED_ID"
  title="AI Interior Design by MeltFlex"
  width="100%"
  height="720"
  style="border:0;border-radius:12px;max-width:100%;"
  allow="clipboard-write"
  loading="lazy"
></iframe>

在商店的产品页面中，添加 ?product=<product page address>，工具便会以该产品打开。/meltflex:embed 会在你的项目中安装代码（HTML、React / Next.js、Vue、Shopify、WordPress），如果你的网站使用内容安全策略（Content Security Policy），则会设置 frame-src 规则，并演示如何处理空白框架。指南：https://www.meltflexai.com/api#embed。

与 MCP 服务搭配使用

偏好调用工具而非编写脚本调用 API 的 Agent 可以运行 meltflex-mcp 服务（npm、stdio）。它提供六个工具——generate_interior、generate_video、floorplan_to_3d、furniture_to_3d、generate_world、check_credits——并负责轮询和将文件保存到磁盘。

npx -y meltflex-mcp auth login              # or: npx -y meltflex-mcp auth mf_sk_xxxxxxxx
claude mcp add meltflex -- npx -y meltflex-mcp

任何 MCP 客户端都可以使用相同的配置（command: npx、args: ["-y", "meltflex-mcp"]，以及可选的 env.MELTFLEX_API_KEY）。同一个软件包也是一个终端 CLI：meltflex generate | video | floorplan | furniture | world | credits。Claude Desktop 扩展包位于 mcpb/。

Hermes

Hermes（Nous Research）支持 MCP，因此可以通过同一个服务运行 MeltFlex。

从目录安装（合并到 Hermes 目录后）：

hermes mcp install meltflex

手动配置——登录一次，然后将服务添加到 ~/.hermes/config.yaml：

npx -y meltflex-mcp auth login

mcp_servers:
  meltflex:
    command: npx
    args: ["-y", "meltflex-mcp"]

启动 hermes chat（或在会话中运行 /reload-mcp）以加载六个 MeltFlex 工具。完整指南：https://www.meltflexai.com/mcp。

进一步了解

• API 文档： https://www.meltflexai.com/api
• CLI： https://www.meltflexai.com/cli — 在终端中运行 meltflex generate
• MCP 服务： https://www.meltflexai.com/mcp — npx -y meltflex-mcp
• 操作手册： COOKBOOK.md · 更新日志： CHANGELOG.md

安全

这些技能绝不包含密钥。每位用户都通过 MELTFLEX_API_KEY 提供自己的 mf_sk_ 密钥；生成内容会消耗该用户自己的额度。额度、身份验证和速率限制均在服务端执行。切勿提交你的密钥——你可以随时在设置中撤销它。

许可证

MIT——参见 LICENSE。欢迎贡献——参见 CONTRIBUTING.md。