meltflex-design

MeltFlex — AI インテリアデザイン

MeltFlex は、空間の実際の写真を、デザインを一新したフォトリアルな画像に変換します。このスキルは MeltFlex REST API を直接呼び出すため、ほかに何もインストールせずに、どのエージェントでも動作します。（meltflex-mcp サーバーが設定されている場合は、ファイルの入出力を処理してくれる generate_interior ツールを使用してください。）

部屋に特定の家具製品を配置するには、関連スキルの /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 クレジットが必要です。クレジットは事前に差し引かれ、失敗した場合は自動的に返金されます。クレジットはユーザーのアカウントに属します。

エンドポイントは 1 つだけです

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

ヘッダー：Authorization: Bearer $MELTFLEX_API_KEY、Content-Type: application/json。

本文：

• prompt（string、必須）— デザイン変更の指示です。
• imageUrl（string）または image（base64 データ URL）— 元の写真です。imageUrl を推奨します。
• resolution（string、任意）— 出力品質です。"512"、"1K"、"2K"（最も鮮明）を指定できます。デフォルトではモデルが自動選択します。
• designLevel（string、任意）— "lite"（より高速で低コスト、−2 クレジット）、"quick"（デフォルト）、"pro"（最も詳細、高い思考レベル、+5 クレジット）を指定できます。
• mask（boolean、任意）— 領域編集です。true の場合、元の画像で変更する領域を赤一色で塗る必要があります。プロンプトは赤で示した領域のみに適用され、ほかの部分は保持されます。「この部分だけ変更する」場合に使用します。
• variations（number、任意）— 1 回の呼び出しで生成する画像の数（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"))

ローカルの写真を使う場合は、imageUrl の代わりにデータURLとして image に指定してください。

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 の間取り図から、レンダリング画像（output: "render"、10クレジット、約20秒）またはダウンロード可能な GLB モデル（output: "model"、100クレジット、約3分）を生成します。POST /api/v1/floorplan-to-3d。
• 家具の写真 → 3D モデル — 商品写真1枚から、テクスチャ付き GLB（USDZ／FBX／OBJ のリンクも含む）を生成します。POST /api/v1/furniture-3d、75クレジット、約2～3分。
• 写真 → 探索可能な3Dワールド — 部屋の写真またはレンダリング画像から、ホストされたビューワーのリンク付きで、歩いて回れるガウシアンスプラットのワールドを生成します。POST /api/v1/world、draft は30クレジット、hd は200クレジットです。

3つの3Dエンドポイントは HTTP 202 を返す場合があり、ポーリングが必要です。付属のスキル /meltflex:3d では、これらすべてのリクエスト／レスポンス形式とポーリング用ヘルパーについて説明しています。リファレンス全文：https://www.meltflexai.com/api。

ヒント

• imageUrl は base64 より優先してください。15 MB のボディ制限を回避でき、より高速です。
• 長辺が1024px以上の入力画像で、最良の結果が得られます。
• API キーを表示したり、コミットしたりしないでください。