MeltFlex AI

Habilidades do MeltFlex AI

Habilidades de agente de IA para design de interiores e exteriores fotorrealista e 3D via MeltFlex AI — reformule ambientes, coloque móveis reais, troque pisos, paredes, escadas, portas e janelas, redesenhe cozinhas, banheiros, fachadas e jardins, e transforme rascunhos 3D em fotos, tudo a partir de uma única foto. Depois vá além: vídeos cinematográficos de passeio, planta 2D → modelo 3D ou imagem 3D renderizada, foto de móvel → modelo 3D GLB, e foto → mundo 3D explorável. Funciona com Claude Code, Hermes, Cursor, Codex, Cline e outros agentes de IA que carregam habilidades baseadas em Markdown ou falam MCP.

Cada usuário autentica com sua própria chave de API MeltFlex; cada geração é cobrada nos créditos da conta dele. As habilidades chamam a API pública do MeltFlex diretamente, então não há nada extra para instalar.

_{Redesign de interiores · reforma de piso a partir de um material · design de jardim — alguns dos 16 modos de imagem, todos a partir de uma única foto.}

_{Foto de móvel → modelo 3D · render de ambiente → mundo 3D explorável · planta 2D → modelo 3D. Resultados reais de /api/v1/furniture-3d, /api/v1/world e /api/v1/floorplan-to-3d.}

Instalação

Escolha um. Cada método configura as habilidades para o seu agente.

npx skills — recomendado, multi-agente

npx skills add MeltFlexDevs/skills

GitHub CLI (v2.90+)

gh skill install MeltFlexDevs/skills

Marketplace do Claude Code

Dentro do Claude Code:

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

Script de configuração

Fallback universal:

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

Mais opções em INSTALL.md. Instalação guiada por agente (cole no seu agente): INSTALL_FOR_AGENTS.md. Cline e outros agentes com configuração MCP: llms-install.md.

Autenticação

Você precisa de uma assinatura ativa (qualquer plano pago) — sem ela, a chave não funciona. Após assinar em https://www.meltflexai.com/settings, abra configurações da conta → API Key em Perfil, depois Generate API Key (mostrada uma única vez — copie-a):

Depois, exponha-a:

export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"

Se você usar o servidor MCP / CLI, pode pular o copiar-e-colar e entrar pelo navegador: npx -y meltflex-mcp auth login abre https://www.meltflexai.com/cli/authorize, gera uma chave a partir da sua sessão autenticada e a armazena em ~/.meltflex/config.json (chmod 600).

Habilidades

Habilidade	Invocar	Descrição
meltflex-design	/meltflex:design	Reformule um ambiente, fachada ou jardim; troque pisos, paredes, escadas, portas ou janelas; redesenhe uma cozinha ou banheiro; melhore um layout; transforme um rascunho 3D em foto. 16 modos orientados por prompt com níveis de qualidade, edição de regiões e lotes, além de vídeos de passeio via API.
meltflex-furniture	/meltflex:furniture	Coloque produtos específicos de móveis/decor reais em uma foto de ambiente, combinando cores, materiais e proporções exatas (até 10 itens de referência).
meltflex-3d	/meltflex:3d	Saída 3D: foto de móvel → modelo GLB, planta 2D → modelo GLB ou imagem 3D renderizada, foto de ambiente → mundo 3D explorável (splat + visualizador hospedado). Gerencia a consulta de builds longos.
meltflex-embed	/meltflex:embed	Coloque a ferramenta de design no seu próprio site como iframe: visitantes projetam seu ambiente, ou colocam os produtos da sua loja nele, sem conta. Instala o código em HTML, React, Vue, Shopify ou WordPress e corrige um frame em branco. Sem chave de API.

As habilidades de imagem são autocontidas: uma foto de ambiente entra, um redesign fotorrealista sai, 10 créditos por imagem (reembolso automático em caso de falha).

Modos de imagem

meltflex-design — 16 modos, cada um no mesmo endpoint POST /api/v1/generate com um prompt ajustado ao modo:

Modo	Para que serve
restyle	Mudar o estilo ou tema de um ambiente
virtual_staging	Mobiliar um ambiente vazio
layout_boost	Reorganizar móveis existentes em um layout melhor
declutter	Limpar / despersonalizar um espaço
exterior	Fachada de prédio / exterior de casa
garden	Paisagismo e design externo
wall_texture	Mudar material ou acabamento de parede
floor_restyle	Trocar o piso
stairs	Reformular uma escada no lugar
doors	Trocar portas internas
windows	Trocar molduras de janela / vidros
kitchen	Redesign completo de cozinha
bathroom	Redesign completo de banheiro
photo_to_render	Transformar um rascunho 3D / captura do SketchUp em foto
seasonal	Variação de hora do dia / estação / iluminação
region_edit	Mudar apenas uma área — pinte-a de vermelho sólido, envie mask: true

Campos opcionais em cada chamada de imagem: resolution (512 / 1K / 2K), designLevel (lite −2 cr · quick · pro +5 cr), variations (1–3 por chamada, cobrado por imagem), até 10 referenceImageUrls.

Vídeo e 3D

Mesma chave, mais cinco saídas. As três builds 3D podem levar minutos; elas respondem HTTP 202 + uma URL de consulta quando excedem o tempo da requisição, e /meltflex:3d mostra como consultar.

Saída	Endpoint	Créditos	Tempo	Ferramenta MCP · CLI
Vídeo de passeio cinematográfico (MP4, Veo 3.1)	POST /api/v1/video	100 (4s) / 150 (8s)	~1 min	generate_video · meltflex video
Planta → imagem 3D renderizada (PNG)	POST /api/v1/floorplan-to-3d output: "render"	10	~20 s	Somente REST
Planta → modelo 3D GLB	POST /api/v1/floorplan-to-3d output: "model"	100	~3 min	floorplan_to_3d · meltflex floorplan
Foto de móvel → modelo 3D GLB (+ USDZ/FBX/OBJ)	POST /api/v1/furniture-3d	75	2–3 min	furniture_to_3d · meltflex furniture
Foto → mundo 3D explorável (.spz + link do visualizador)	POST /api/v1/world	30 (rascunho) / 200 (hd)	~1 / ~5 min	generate_world · meltflex world

Referência completa com corpos de resposta e trechos de carregamento three.js / Spark: https://www.meltflexai.com/api.

Referência rápida

O que você quer	Habilidade	Observação
Reformular um ambiente a partir de uma foto	meltflex-design	Escolha um modo, escreva um prompt específico
Mobiliar um ambiente vazio	meltflex-design	Modo virtual_staging
Colocar um sofá/cama/mesa específico	meltflex-furniture	Envie imagens do produto como referências
Redesenhar o exterior de uma casa ou jardim	meltflex-design	Modo exterior / garden
Trocar piso ou acabamento de parede	meltflex-design	floor_restyle / wall_texture (anexe o material como referência)
Reformular escadas, portas ou janelas	meltflex-design	Modo stairs / doors / windows
Redesenhar uma cozinha ou banheiro	meltflex-design	Modo kitchen / bathroom
Transformar um rascunho 3D em foto	meltflex-design	Modo photo_to_render
Mudar apenas uma área marcada	meltflex-design	region_edit — pinte-a de vermelho, mask: true
Saída mais nítida / várias opções	meltflex-design	resolution: "2K", designLevel: "pro", variations: 3
Vídeo de passeio cinematográfico	meltflex-design	POST /api/v1/video (100–150 créditos)
Modelo 3D de uma peça de mobília	meltflex-3d	POST /api/v1/furniture-3d (75 créditos)
Planta 2D → modelo 3D / imagem 3D	meltflex-3d	POST /api/v1/floorplan-to-3d (100 / 10 créditos)
Percorrer um ambiente em 3D	meltflex-3d	POST /api/v1/world (30 rascunho / 200 hd)
Verificar saldo de créditos	—	meltflex credits (CLI) ou a ferramenta MCP check_credits

Incorporar no seu site

_{Ao vivo na loja de móveis Kondela: os compradores colocam os próprios produtos da loja em uma foto do ambiente deles, na página da própria loja.}

Sem chave de API e sem backend: crie um embed no Website Embed Builder (seu domínio, logotipo, cor, idioma e, para lojas, seu feed de produtos), depois cole um iframe. Os visitantes projetam o ambiente deles na sua página sem conta; cada design usa 10 créditos da sua conta. O código é desbloqueado em um plano 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>

Na página de produto de uma loja, adicione ?product=<product page address> e a ferramenta abre com esse produto. /meltflex:embed instala o código no seu projeto (HTML, React / Next.js, Vue, Shopify, WordPress), define a regra frame-src se o seu site tiver uma Política de Segurança de Conteúdo e orienta sobre um frame em branco. Guia: https://www.meltflexai.com/api#embed.

Uso com o servidor MCP

Agentes que preferem chamadas de ferramenta a chamadas de API via script podem executar o servidor meltflex-mcp (npm, stdio). Ele expõe seis ferramentas — generate_interior, generate_video, floorplan_to_3d, furniture_to_3d, generate_world, check_credits — e gerencia a consulta e o salvamento de arquivos em disco.

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

Qualquer cliente MCP funciona com o mesmo formato (command: npx, args: ["-y", "meltflex-mcp"], env.MELTFLEX_API_KEY opcional). O mesmo pacote é um CLI de terminal: meltflex generate | video | floorplan | furniture | world | credits. Um pacote de extensão do Claude Desktop está em mcpb/.

Hermes

Hermes (Nous Research) fala MCP, então executa o MeltFlex pelo mesmo servidor.

Pelo catálogo (após ser mesclado ao catálogo do Hermes):

hermes mcp install meltflex

Manualmente — entre uma vez e adicione o servidor a ~/.hermes/config.yaml:

npx -y meltflex-mcp auth login

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

Inicie hermes chat (ou execute /reload-mcp em uma sessão) para carregar as seis ferramentas do MeltFlex. Guia completo: https://www.meltflexai.com/mcp.

Indo além

• Documentação da API: https://www.meltflexai.com/api
• CLI: https://www.meltflexai.com/cli — meltflex generate do seu terminal
• Servidor MCP: https://www.meltflexai.com/mcp — npx -y meltflex-mcp
• Livro de receitas: COOKBOOK.md · Changelog: CHANGELOG.md

Segurança

As habilidades nunca contêm uma chave. Cada usuário fornece sua própria chave mf_sk_ via MELTFLEX_API_KEY; as gerações gastam os créditos do próprio usuário. Créditos, autenticação e limites de taxa são todos aplicados no lado do servidor. Nunca faça commit da sua chave — revogue-a a qualquer momento em configurações.

Licença

MIT — veja LICENSE. Contribuições são bem-vindas — veja CONTRIBUTING.md.