用途:MeltFlex Design 基于 MeltFlex AI,把一张真实空间照片重绘为写实的室内或室外设计效果图,适用于改风格、重新设计、去杂乱、虚拟布置等需求。它直接调用 MeltFlex REST API,可在任意智能体中运行,无需额外安装;若已配置 meltflex-mcp 服务器,可优先使用其 generate_interior 工具。
主要能力:单一端点 POST https://www.meltflexai.com/api/v1/generate,请求头为 Authorization: Bearer $MELTFLEX_API_KEY 与 Content-Type: application/json。请求体包含 prompt(必填)、imageUrl 或 image(base64 data URL,优先 imageUrl)、resolution(512/1K/2K)、designLevel(lite/quick/pro)、mask(区域编辑,需把待改区域涂成纯红)、variations(1–3 张)。响应返回 success、image、images、count、creditsUsed。
模式:restyle、virtual_staging、layout_boost、declutter、exterior、garden、wall_texture、floor_restyle、stairs、doors、windows、kitchen、bathroom、photo_to_render、seasonal、region_edit。每种模式是同一端点配合调优的提示词,需以对应引导语开头。除明确要改动的模式外,应保留房间结构。
使用方式:需用户拥有 MeltFlex API 密钥(mf_sk_...)与有效订阅,通过环境变量 MELTFLEX_API_KEY 提供,例如 export MELTFLEX_API_KEY="mf_sk_..."。每次生成消耗 10 积分,预先扣除,失败自动退还。可用 Python 脚本调用并解码 base64 结果保存为文件;本地照片可转成 data URL 放入 image 字段。
适用场景:室内外重设计、空房布置、家具重排、去杂乱、墙面地板门窗楼梯更换、厨卫整体改造、草图转写实、季节光照变化、局部区域编辑等。
限制:必须有源照片,MeltFlex 不凭空生成空间;提示词需具体说明材质、颜色、家具、光照与氛围。错误码:402 积分不足,401 密钥错误或缺失,429 限流需退避重试,5xx 失败会自动退还积分。建议优先用 imageUrl 以避免 15 MB 请求体限制,输入图长边不小于 1024px,切勿打印或提交 API 密钥。同一账号与密钥还可使用视频与 3D 端点(视频、平面图转 3D、家具转 3D、照片转可探索 3D 世界),其中三个 3D 端点可能返回 HTTP 202 需轮询,详见配套技能与官方 API 文档。