MeltFlex AI

Diseño de interiores con IA desde tu agente: renueva habitaciones, coloca muebles y ambienta espacios virtualmente a partir de una sola foto.

GitHub

Prueba este MCPPatrocinado

Documentación

Habilidades de MeltFlex AI

Habilidades de agente de IA para diseño fotorrealista de interiores y exteriores y 3D mediante MeltFlex AI: rediseña habitaciones, coloca muebles reales, cambia pisos, paredes, escaleras, puertas y ventanas, rediseña cocinas, baños, fachadas y jardines, y convierte borradores 3D en fotos, todo desde una sola foto. Luego ve más allá: recorridos en video cinematográficos, plano 2D → modelo 3D o imagen 3D renderizada, foto de mueble → modelo 3D GLB, y foto → mundo 3D explorable. Funciona con Claude Code, Hermes, Cursor, Codex, Cline y otros agentes de IA que cargan habilidades basadas en Markdown o hablan MCP.

Cada usuario se autentica con su propia clave de API de MeltFlex; cada generación se factura a los créditos de su cuenta. Las habilidades llaman directamente a la API pública de MeltFlex, por lo que no hay nada adicional que instalar.

Interior design — empty room to a fully furnished, photorealistic redesign
Floor restyle — upload a material and it is applied to your room
Garden design — a plain patio restyled into a Mediterranean garden

_{Rediseño de interiores · cambio de piso desde un material · diseño de jardines — algunos de los 16 modos de imagen, todo desde una sola foto.}

Furniture photo → GLB 3D model: a blue armchair and a green sofa, each turned into a textured 3D model
Room render → explorable 3D world: a Scandinavian living room turned into a walkable Gaussian-splat world
2D floorplan → GLB 3D model

_{Foto de mueble → modelo 3D · render de habitación → mundo 3D explorable · plano 2D → modelo 3D. Resultados reales de /api/v1/furniture-3d, /api/v1/world y /api/v1/floorplan-to-3d.}

Instalación

Elige una. Cada método configura las habilidades para tu agente.

`npx skills` — recomendado, multi-agente

npx skills add MeltFlexDevs/skills

GitHub CLI (v2.90+)

gh skill install MeltFlexDevs/skills

Mercado de Claude Code

Dentro de Claude Code:

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

Script de configuración

Respaldo universal:

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

Más opciones en INSTALL.md. Instalación guiada por agente (pégalo en tu agente): INSTALL_FOR_AGENTS.md. Cline y otros agentes con configuración MCP: llms-install.md.

Autenticación

Necesitas una suscripción activa (cualquier plan de pago) — sin ella la clave no funcionará. Después de suscribirte en https://www.meltflexai.com/settings, abre configuración de cuenta → Clave de API en Perfil, luego Generar clave de API (se muestra una sola vez — cópiala):

Generate API Key

Luego expónla:

export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"

Si usas el servidor MCP / CLI, puedes omitir el copiar y pegar e iniciar sesión desde el navegador: npx -y meltflex-mcp auth login abre https://www.meltflexai.com/cli/authorize, genera una clave desde tu sesión iniciada y la almacena en ~/.meltflex/config.json (chmod 600).

Habilidades

Habilidad	Invocación	Descripción
meltflex-design	`/meltflex:design`	Rediseña una habitación, fachada o jardín; cambia pisos, paredes, escaleras, puertas o ventanas; rediseña una cocina o baño; mejora una distribución; convierte un borrador 3D en foto. 16 modos guiados por prompt con niveles de calidad, edición de regiones y lotes, además de recorridos en video mediante la API.
meltflex-furniture	`/meltflex:furniture`	Coloca muebles/productos de decoración reales específicos en una foto de habitación, coincidiendo con sus colores, materiales y proporciones exactos (hasta 10 artículos de referencia).
meltflex-3d	`/meltflex:3d`	Salida 3D: foto de mueble → modelo GLB, plano 2D → modelo GLB o imagen 3D renderizada, foto de habitación → mundo 3D explorable (splat + visor alojado). Maneja el sondeo de construcciones largas.
meltflex-embed	`/meltflex:embed`	Coloca la herramienta de diseño en tu propio sitio web como iframe: los visitantes diseñan su habitación, o colocan los productos de tu tienda en ella, sin cuenta. Instala el código en HTML, React, Vue, Shopify o WordPress y corrige un marco en blanco. Sin clave de API.

Las habilidades de imagen son autónomas: una foto de habitación entra, un rediseño fotorrealista sale, 10 créditos por imagen (reembolso automático en caso de fallo).

Modos de imagen

meltflex-design — 16 modos, cada uno el mismo endpoint POST /api/v1/generate con un prompt ajustado al modo:

Modo	Para qué sirve
`restyle`	Cambiar el estilo o tema de una habitación
`virtual_staging`	Amueblar una habitación vacía
`layout_boost`	Reorganizar muebles existentes en una mejor distribución
`declutter`	Limpiar / despersonalizar un espacio
`exterior`	Fachada de edificio / exterior de casa
`garden`	Paisajismo y diseño exterior
`wall_texture`	Cambiar material o acabado de pared
`floor_restyle`	Cambiar el piso
`stairs`	Rediseñar una escalera en su lugar
`doors`	Cambiar puertas interiores
`windows`	Cambiar marcos de ventana / acristalamiento
`kitchen`	Rediseño completo de cocina
`bathroom`	Rediseño completo de baño
`photo_to_render`	Convertir un borrador 3D / captura de SketchUp en foto
`seasonal`	Variación de hora del día / estación / iluminación
`region_edit`	Cambiar solo un área — píntala de rojo sólido, envía `mask: true`

Campos opcionales en cada llamada de imagen: resolution (512 / 1K / 2K), designLevel (lite −2 cr · quick · pro +5 cr), variations (1–3 por llamada, cobrado por imagen), hasta 10 referenceImageUrls.

Video y 3D

Misma clave, cinco salidas más. Las tres construcciones 3D pueden tardar minutos; responden HTTP 202 + una URL de sondeo cuando superan la duración de la solicitud, y /meltflex:3d muestra cómo sondear.

Salida	Endpoint	Créditos	Tiempo	Herramienta MCP · CLI
Video de recorrido cinematográfico (MP4, Veo 3.1)	`POST /api/v1/video`	100 (4s) / 150 (8s)	~1 min	`generate_video` · `meltflex video`
Plano → imagen 3D renderizada (PNG)	`POST /api/v1/floorplan-to-3d` `output: "render"`	10	~20 s	Solo REST
Plano → modelo 3D GLB	`POST /api/v1/floorplan-to-3d` `output: "model"`	100	~3 min	`floorplan_to_3d` · `meltflex floorplan`
Foto de mueble → modelo 3D GLB (+ USDZ/FBX/OBJ)	`POST /api/v1/furniture-3d`	75	2–3 min	`furniture_to_3d` · `meltflex furniture`
Foto → mundo 3D explorable (.spz + enlace de visor)	`POST /api/v1/world`	30 (borrador) / 200 (hd)	~1 / ~5 min	`generate_world` · `meltflex world`

Referencia completa con cuerpos de respuesta y fragmentos de cargador three.js / Spark: https://www.meltflexai.com/api.

Referencia rápida

Lo que quieres	Habilidad	Nota
Rediseñar una habitación desde una foto	`meltflex-design`	Elige un modo, escribe un prompt específico
Amueblar una habitación vacía	`meltflex-design`	Modo `virtual_staging`
Colocar un sofá/cama/mesa específico	`meltflex-furniture`	Pasa imágenes de productos como referencias
Rediseñar un exterior de casa o jardín	`meltflex-design`	Modo `exterior` / `garden`
Cambiar piso o acabado de pared	`meltflex-design`	`floor_restyle` / `wall_texture` (adjunta el material como referencia)
Rediseñar escaleras, puertas o ventanas	`meltflex-design`	Modo `stairs` / `doors` / `windows`
Rediseñar una cocina o baño	`meltflex-design`	Modo `kitchen` / `bathroom`
Convertir un borrador 3D en foto	`meltflex-design`	Modo `photo_to_render`
Cambiar solo un área marcada	`meltflex-design`	`region_edit` — píntala de rojo, `mask: true`
Salida más nítida / varias opciones	`meltflex-design`	`resolution: "2K"`, `designLevel: "pro"`, `variations: 3`
Video de recorrido cinematográfico	`meltflex-design`	`POST /api/v1/video` (100–150 créditos)
Modelo 3D de una pieza de mobiliario	`meltflex-3d`	`POST /api/v1/furniture-3d` (75 créditos)
Plano 2D → modelo 3D / imagen 3D	`meltflex-3d`	`POST /api/v1/floorplan-to-3d` (100 / 10 créditos)
Recorrer una habitación en 3D	`meltflex-3d`	`POST /api/v1/world` (30 borrador / 200 hd)
Consultar saldo de créditos	—	`meltflex credits` (CLI) o la herramienta MCP `check_credits`

Incrusta en tu sitio web

The MeltFlex embed live on the Kondela furniture shop: a room photo on the left, the shop's own products with prices on the right

_{En vivo en la tienda de muebles Kondela: los compradores colocan sus propios productos en una foto de su habitación, en la propia página de la tienda.}

Sin clave de API y sin backend: crea una incrustación en el Constructor de incrustaciones web (tu dominio, logotipo, color, idioma y, para tiendas, tu feed de productos), luego pega un iframe. Los visitantes diseñan su habitación en tu página sin cuenta; cada diseño usa 10 créditos de tu cuenta. El código se desbloquea con un plan Enterprise.

<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>

En la página de producto de una tienda, agrega ?product=<product page address> y la herramienta se abre con ese producto. /meltflex:embed instala el código en tu proyecto (HTML, React / Next.js, Vue, Shopify, WordPress), establece la regla frame-src si tu sitio tiene una Política de Seguridad de Contenido, y guía a través de un marco en blanco. Guía: https://www.meltflexai.com/api#embed.

Uso con el servidor MCP

Los agentes que prefieren llamadas de herramientas sobre llamadas API con script pueden ejecutar el servidor meltflex-mcp (npm, stdio). Expone seis herramientas — generate_interior, generate_video, floorplan_to_3d, furniture_to_3d, generate_world, check_credits — y maneja el sondeo y el guardado de archivos en disco.

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

Cualquier cliente MCP funciona con la misma forma (command: npx, args: ["-y", "meltflex-mcp"], env.MELTFLEX_API_KEY opcional). El mismo paquete es un CLI de terminal: meltflex generate | video | floorplan | furniture | world | credits. Un paquete de extensión de Claude Desktop vive en mcpb/.

Hermes

Hermes (Nous Research) habla MCP, por lo que ejecuta MeltFlex a través del mismo servidor.

Desde el catálogo (una vez fusionado en el catálogo de Hermes):

hermes mcp install meltflex

Manualmente — inicia sesión una vez, luego agrega el servidor a ~/.hermes/config.yaml:

npx -y meltflex-mcp auth login

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

Inicia hermes chat (o ejecuta /reload-mcp en una sesión) para cargar las seis herramientas de MeltFlex. Guía completa: https://www.meltflexai.com/mcp.

Ir más allá

Documentación de API: https://www.meltflexai.com/api
CLI: https://www.meltflexai.com/cli — meltflex generate desde tu terminal
Servidor MCP: https://www.meltflexai.com/mcp — npx -y meltflex-mcp
Libro de recetas: COOKBOOK.md · Registro de cambios: CHANGELOG.md

Seguridad

Las habilidades nunca contienen una clave. Cada usuario proporciona su propia clave mf_sk_ mediante MELTFLEX_API_KEY; las generaciones gastan los créditos propios de ese usuario. Los créditos, la autenticación y los límites de velocidad se aplican en el servidor. Nunca comprometas tu clave — revócala en cualquier momento en configuración.

Licencia

MIT — ver LICENSE. Las contribuciones son bienvenidas — ver CONTRIBUTING.md.