meltflex-design

MeltFlex — AI 室内设计

MeltFlex 可将空间的真实照片转换为重新设计后的逼真效果图。此技能直接调用 MeltFlex REST API，因此无需安装其他内容，即可在任何 Agent 中使用。（如果已配置 meltflex-mcp 服务，请优先使用其 generate_interior 工具——它会为你处理文件 I/O。）

如需将特定家具产品放入房间，请使用配套技能 /meltflex:furniture。如需 3D 输出（家具 GLB、平面图模型、可探索的 3D 世界），请使用 /meltflex:3d。

前提条件

用户需要 MeltFlex API 密钥（mf_sk_...），可通过有效订阅在 https://www.meltflexai.com/settings 获取。请从 MELTFLEX_API_KEY 环境变量中读取该密钥。如果缺少密钥，请让用户进行设置：

export MELTFLEX_API_KEY="mf_sk_..."

每次生成消耗 10 个积分，会预先扣除，失败时自动退还。积分归用户账户所有。

唯一端点

POST https://www.meltflexai.com/api/v1/generate

请求头：Authorization: Bearer $MELTFLEX_API_KEY、Content-Type: application/json。

请求体：

• prompt（字符串，必填）——重新设计的指令。
• imageUrl（字符串）或 image（base64 数据 URL）——源照片。优先使用 imageUrl。
• resolution（字符串，可选）——输出质量："512"、"1K" 或 "2K"（最清晰）。默认由模型自动选择。
• designLevel（字符串，可选）——"lite"（更快、更便宜，−2 个积分）、"quick"（默认）或 "pro"（细节最丰富，HIGH 思考，+5 个积分）。
• mask（布尔值，可选）——区域编辑。设为 true 时，必须在源图中将要更改的区域涂成纯红色；提示词只应用于这些标红区域，其余部分保持不变。适用于“只更改这一部分”。
• variations（数字，可选）——一次调用生成 1–3 张图片（默认 1）。按图片计费；失败的变体会退还积分。

响应：{ "success": true, "image": "data:...", "images": ["data:..."], "count": 1, "creditsUsed": 10 }。

模式

所有模式都使用同一个端点，只是提示词针对模式进行了调整。选择与请求匹配的模式，并将模式说明放在提示词开头。

模式	用途	提示词开头
restyle	更改房间的风格／主题	“将这个房间重新设计为 <风格>：…”
virtual_staging	为空房间添置家具	“将这个空房间布置成 <风格>的<房间类型>：…”
layout_boost	重新布置现有家具	“将现有家具重新布置成更开阔、实用的布局；保留原有家具”
declutter	整理／去个性化	“整理并收拾这个房间，保留布局，采用中性风格”
exterior	建筑立面／房屋外观	“将这栋房屋的外观重新设计为 <风格>，保留结构”
garden	园林设计／户外空间	“重新设计这个花园：<植物、铺装、氛围>”
wall_texture	更改墙面材质／饰面	“将墙面改为 <材质／颜色>，其他部分保持不变”
floor_restyle	更改地板	“将地板换成 <材质>，其他部分保持不变”
stairs	原地重新设计楼梯	“重新设计楼梯（<踏步、栏杆>），保持位置和周围环境不变”
doors	更换室内门	“将门换成 <风格>，墙面和地板保持不变”
windows	更换窗框／玻璃	“将窗户改为 <窗框／玻璃>，保持墙洞不变”
kitchen	整体重新设计厨房	“将这个厨房重新设计为 <风格>，保留原有布局和管道”
bathroom	整体重新设计浴室	“将这个浴室重新设计为 <风格>，保留原有布局和管道”
photo_to_render	将草图／SketchUp 模型转为照片	“将这个 3D 草图转成逼真的照片，保留几何结构和相机视角”
seasonal	更改光线／季节效果	“展现这个房间在 <一天中的时间／季节>、<光线>下的样子”
region_edit	仅更改一个标记区域	发送 mask: true，并在图像中将区域涂成纯红色；“在红色区域放入 <物品>，其余部分保持不变”

对于表面和固定装置更换模式（wall_texture、floor_restyle、stairs、doors、windows），你可以附上目标材质或产品的参考图（referenceImageUrls），以精确匹配——参考机制请见 /meltflex:furniture。

除非模式明确要求更改，否则始终保留房间结构（墙壁、窗户、门、地板）。

如何运行

使用一个小脚本将 base64 结果解码到文件中（Python 示例）：

import os, base64, requests

resp = requests.post(
    "https://www.meltflexai.com/api/v1/generate",
    headers={"Authorization": f"Bearer {os.environ['MELTFLEX_API_KEY']}"},
    json={
        "imageUrl": "https://your-cdn.com/empty-room.jpg",
        "prompt": "Redesign in warm Scandinavian style: light oak floor, beige linen sofa, soft daylight. Preserve windows and walls.",
    },
    timeout=180,
)
data = resp.json()
if data.get("success"):
    open("redesign.png", "wb").write(base64.b64decode(data["image"].split(",", 1)[1]))
    print("Saved redesign.png")
else:
    print("Error:", data.get("error") or data.get("message"))

对于本地源照片，请将其作为数据 URL 发送到 image，而不是 imageUrl：

import base64, mimetypes
path = "living-room.jpg"
mime = mimetypes.guess_type(path)[0] or "image/jpeg"
b64 = base64.b64encode(open(path, "rb").read()).decode()
body = {"image": f"data:{mime};base64,{b64}", "prompt": "..."}

如何与用户协作

1. 始终需要源照片。 MeltFlex 会对现有照片进行重新设计，不会凭空创造空间。如果用户只提供描述，请索要文件路径或 URL。
2. 选择一种模式，然后编写具体的提示词——包括材质、颜色、家具、光线和氛围。“让它变得温馨” → “温暖的斯堪的纳维亚风格客厅：浅橡木地板、米色亚麻沙发、奶油色羊毛地毯、柔和的漫射日光。”
3. 报告保存路径和使用的点数；并询问用户是否需要继续调整。
4. 错误：402 = 点数不足（指引至 /settings）；401 = 密钥错误或缺失；429 = 请求过于频繁（采用退避策略重试）；5xx = 请求失败，点数会自动退还。

不止静态图像：视频与 3D

同一账户和 API 密钥还可调用更多端点。当需求不止于静态改造时，可以使用这些端点：

• 电影感视频漫游 — 将静态图像（MeltFlex 渲染图或任意室内照片）制作成简短的漫游视频（Veo 3.1）。 POST /api/v1/video，参数为 { imageUrl, durationSeconds: 4|8, aspectRatio: "16:9"|"9:16", prompt? } → { videoUrl, durationSeconds, aspectRatio, creditsUsed }（托管的 MP4）。费用为 100 点数（4 秒）或 150 点数（8 秒）。最多可能需要约 5 分钟。
• 平面图 → 3D — 将 2D 平面图转换为渲染后的 3D 图片（output: "render"，10 点数，约 20 秒），或可下载的 GLB 模型（output: "model"，100 点数，约 3 分钟）。POST /api/v1/floorplan-to-3d。
• 家具照片 → 3D 模型 — 将一张产品照片转换为带纹理的 GLB（并附有 USDZ/FBX/OBJ 链接）。POST /api/v1/furniture-3d，75 点数，约 2–3 分钟。
• 照片 → 可探索的 3D 世界 — 将房间照片或一张渲染图转换为可步行探索的 Gaussian-splat 世界，并提供托管的查看器链接。POST /api/v1/world，draft 需 30 点数，hd 需 200 点数。

三个 3D 端点都可能返回 HTTP 202，需要轮询；配套技能 /meltflex:3d 介绍了所有端点的请求/响应格式和轮询辅助工具。完整参考文档：https://www.meltflexai.com/api。

提示

• 优先使用 imageUrl，而不是 base64 — 这样可以避免 15 MB 的请求体限制，速度也更快。
• 输入图像较长的一边达到 ≥1024px 时效果最佳。
• 切勿打印或提交 API 密钥。