mcpField
M
meltflex-furniture

meltflex-furniture

github.com/meltflexdevs创意与媒体860 次安装1 周前更新
代码仓库

关于 meltflex-furniture

meltflex-furniture 是一项调用 MeltFlex REST API 的家具摆放技能，供需要将指定家具或装饰品合成到房间照片中的用户使用。它根据房间图和产品参考图生成符合透视、光线与阴影的场景图。

主要功能

  1. 01将指定产品合成到房间照片
  2. 02使用产品参考图或图片 URL
  3. 03通过提示词描述摆放方式
  4. 04支持多件产品与多种生成变体
  5. 05返回生成图像及使用额度

适用场景

  1. 01预览指定沙发在客厅中的摆放效果
  2. 02比较多件家具在房间里的组合
  3. 03用产品图片制作室内场景效果图

MCP 相关

输入未说明 MCP 集成；该技能通过 MeltFlex REST API 的生成端点提交房间图、产品参考图和摆放提示词。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/meltflexdevs/skills --skill meltflex-furniture

安装后在 Claude Code 中输入/meltflex-furniture确认已加载。

详细介绍

MeltFlex — 家具摆放

这项技能可将指定产品放入房间照片中：你提供房间照片，以及一张或多张精确家具／装饰品的参考图片，MeltFlex 会将它们合成到场景中，并匹配正确的透视、光线和阴影。使用相同的 MeltFlex REST API，无需额外安装。

如果想在没有指定产品的情况下进行整体风格改造，请使用 /meltflex:design。若要将家具照片转换为可下载的3D 模型（GLB），请使用 /meltflex:3d（POST /api/v1/furniture-3d，75 credits）。

前提条件

需要在 MELTFLEX_API_KEY 中设置 MeltFlex API 密钥（mf_sk_...，任何有效订阅均可）。请前往 https://www.meltflexai.com/settings 获取。每次生成消耗 10 credits（失败时自动退还），费用从用户账户中扣除。

端点

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

请求体：

  • prompt（string，必填）— 摆放说明。
  • imageUrl 或 image — 房间照片。
  • referenceImageUrls（string[]）— 要放入场景的产品公开 URL，最多 10 个。（本地文件也可使用 base64 数据 URL 形式的 referenceImages。）
  • referenceProducts（object[]，可选）— 每张参考图片的元数据，例如 [{"name": "Modular Sofa"}]，用于帮助摆放。
  • resolution（"512"|"1K"|"2K"）、designLevel（"lite"|"quick"|"pro"）、variations（1–3）— 与 /meltflex:design 相同的可选质量／批量字段。

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

示例

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": "Place these furniture items naturally in this living room, matching their exact look.",
        "referenceImageUrls": [
            "https://your-cdn.com/modular-sofa.jpg",
            "https://your-cdn.com/oak-coffee-table.jpg"
        ],
        "referenceProducts": [{"name": "Modular Sofa"}, {"name": "Oak Coffee Table"}],
    },
    timeout=180,
)
data = resp.json()
if data.get("success"):
    open("furnished.png", "wb").write(base64.b64decode(data["image"].split(",", 1)[1]))

如何与用户协作

  1. 需要房间照片和至少一张产品图片。 如果用户提到了产品但没有提供图片，请向其索要该产品的照片或 URL。
  2. 使用干净的产品图片（白色／中性色背景），以获得最佳匹配效果。
  3. 在 referenceProducts 中写明产品名称，帮助 AI 正确摆放。
  4. 每次调用最多可提供 10 个参考物品。告知用户保存路径和消耗的 credits。
  5. 错误处理方式与 /meltflex:design 相同（402 表示 credits 不足，401 表示密钥无效，429 表示请求过多，5xx 时自动退款）。

提示

  • 房间照片和参考图片都优先使用 URL 而非 base64——速度更快，也能避免 15 MB 的限制。
  • 要摆放多件物品时，请在提示词中描述理想布局（例如“沙发靠后墙摆放，茶几居中”）。

评论

支持 Markdown