PTENES
Inmuebles · IA · 360°

Las fotos comunes de un ambiente se convierten en una sala en 360°

De cuatro a seis fotos normales del mismo ambiente, o solo una descripción de texto, se convierten en una panorámica equirectangular fotorrealista que puedes girar como en un tour virtual. Sin cámara 360, sin escaneo, sin software 3D.

Sala reconstruida en 360° a partir de fotos comunes
Qué es

Reconstrucción con IA de un ambiente completo

La IA entiende cómo se conectan las fotos (el mismo sofá en dos fotos, la misma ventana desde dos ángulos) y reconstruye el ambiente como un espacio único, en formato 2:1 de 4096×2048, listo para cualquier visor 360.

🏠 Fiel al inmueble

Conserva paredes, puertas, ventanas, muebles y materiales. No rediseña ni inventa objetos; cada mueble aparece una sola vez. Lo que no muestra ninguna foto se infiere de forma conservadora.

✍️ O solo un tema

¿No tienes fotos? Describe el espacio en texto. La IA crea cinco fotos coherentes del mismo ambiente y luego genera la imagen 360°. Sirve para conceptos, vistas previas y contenido.

🔍 Revisado antes de entregar

Proporción exacta 2:1, resolución mínima de 4096×2048, puntuación de costura entre los bordes, regeneración automática si la costura falla y suavizado final. Todo queda en el informe.

Cómo funciona

Del lote de fotos a la panorámica en cinco pasos

Es una reconstrucción con IA, no una medición. Sirve para marketing inmobiliario, vista previa, tour virtual y como insumo para video con IA. No sustituye un escaneo LiDAR.

Fotos o tema→ Visión entiende la habitación→ Prompt conservador→ Modelo de imagen 2:1 con referencias→ Revisiones + costura→ PNG + visor 360
1

Visión

Gemini lee todas las fotos como un único espacio: paredes, puertas, ventanas, muebles, iluminación, dirección estimada de cada foto y lo que falta.

2

Generación

Las fotos se usan como referencia en un modelo con 2:1 nativo. El predeterminado es Flux 2 Klein vía Freepik/Magnific; GPT Image 2 y Gemini vía OpenRouter son alternativas.

3

Control

Relación de aspecto corregida, remuestreo hasta 4096×2048, puntuación de costura (≤12 buena, ≤30 aceptable, >30 visible), una regeneración automática y fundido cruzado en los bordes.

Requisitos previos

Python 3.12 y dos claves de API

Las claves se leen en runtime desde tu archivo de entorno. No se copia nada al proyecto.

Dependencias

FastAPI, Pillow, NumPy y httpx.

# en la carpeta del proyecto
pip install -r requirements.txt

Claves

Freepik/Magnific para generar, Gemini para la visión. OpenRouter es opcional.

# ~/projetos/wifi/.env
MAGNIFIC_API_KEY=...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=...  # opcional

Fotos

4 a 6 JPG/PNG del mismo ambiente, desde distintos ángulos. Una buena cobertura vale más que cinco fotos casi iguales.

sala/
├── 01.jpg  # giro hacia el sofá
├── 02.jpg  # giro hacia la ventana
└── 03.jpg  # giro hacia la entrada
Guía de uso · paso a paso

Tres formas de usarlo: línea de comandos, interfaz web o skill

Todos usan el mismo motor. El resultado se guarda en ~/projetos/output/fotos3d/<nome>/ con el PNG, el análisis, el prompt y el informe.

1

Genera una imagen 360° a partir de una carpeta de fotos

Indica la carpeta y ponle un nombre. El modelo predeterminado es Flux 2 Klein (10 créditos Magnific por imagen).

cd ~/projetos/fotos3d
python3 -m engine.pipeline /caminho/fotos-da-sala --nome sala-302  # ~1 min
2

O genera a partir de un tema

Describe el ambiente. La IA crea cinco fotos coherentes y sigue el mismo flujo.

python3 -m engine.pipeline --assunto "sala moderna, sofá cinza em L, janela grande com vista pro jardim, piso de madeira clara" --nome demo
3

Elegir modelo y resolución

Cambia de modelo cuando quieras más referencias o 4K nativo. El informe registra cuál se usó.

python3 -m engine.pipeline sala/ --nome sala-302 --modelo gpt-image-2 --size 4K
python3 -m engine.pipeline sala/ --nome sala-302 --modelo or-gemini-pro   # vía OpenRouter
4

Usar la interfaz web

Arrastra las fotos (o pega la ruta de la carpeta), elige el modelo con el costo al lado, sigue el progreso y gira el resultado en el visor integrado. Galería con todo lo que ya se generó.

uvicorn web.app:app --port 8360   # abre http://127.0.0.1:8360
5

Revisar en el visor 360

Revisa siempre el resultado en el visor, no en la imagen plana: muebles duplicados, puertas repetidas, paredes imposibles, cambios bruscos de luz o cortes en el punto de giro. Si algo está mal, vuelve a generar o cambia de modelo.

# visor independiente: ábrelo en el navegador y arrastra el PNG
viewer/index.html
# informe con la proporción, la resolución y la puntuación de costura
~/projetos/output/fotos3d/sala-302/relatorio.json
6

Usar como skill en Claude Code

Instálala una vez y después pide en lenguaje natural: "usa la skill property-360 en las fotos de la carpeta X".

ln -s ~/projetos/fotos3d/skill/property-360 ~/.claude/skills/property-360
ModeloProveedor2:1 nativoResultado de la pruebaCosto
flux-klein (predeterminado)Freepik / Magnificsí, 2048×1024 remuestreadoequirectangular real, muy fiel10 créditos
gpt-image-2Freepik / Magnificsí, hasta 4K, 16 refsmejor calidad: proyección esférica correcta, buena unión~45 a 90 créditos
or-gemini-proOpenRouterno (16:9 remuestreado)360 plausible, menos fiel a los detalles~US$ 0,13
or-gemini-flashOpenRouternotiende a salir con gran angular, no en 360~US$ 0,04
Ejemplos

Sala real y sala imaginada

Arriba, las fotos de entrada. Abajo, la panorámica generada (parece estirada en la pantalla plana, pero completa los 360° en el visor).

Seis fotos de la sala de Robie House
Entrada: 6 fotos reales de la sala de Robie House (Frank Lloyd Wright). Wikimedia Commons, foto de w_lemay, CC BY-SA 2.0.
Cinco fotos generadas por tema
Entrada por tema: "sala moderna, sofá gris en L, ventana amplia, piso de madera". Cinco fotos coherentes creadas por la IA.
Panorámica 360 de Robie House
Resultado con Flux 2 Klein: chimenea, banco rojo, vitrales y techo reconstruidos como un único espacio, 4096×2048.
Panorámica 360 de Robie House con GPT Image 2
Resultado con GPT Image 2: proyección esférica correcta (techo y suelo curvados), buena costura. La opción de calidad.
Panorámica 360 de una sala a partir de un tema
Resultado del modo por tema con Gemini Flash: coherente con las fotos, pero con un campo de visión más reducido. Por eso el modelo predeterminado es Flux Klein.
Hoja de ruta

De una sala a todo el inmueble

La versión 1.0 resuelve una sala a la vez. Las próximas fases conectan las salas en un tour.

v1.0 ✓
Una sala, a partir de fotos o de un temaPipeline completo, verificaciones, suavizado de costura, interfaz web con visor y galería, skill property-360.
Fase 2
Inmueble completoUna carpeta por espacio, generación por lotes y un tour que conecta las panorámicas con flechas de navegación entre la sala, la cocina y los dormitorios.
Fase 3
Corrección guiadaInpainting de la costura y de objetos duplicados directamente en el visor, y exportación a video 360 con IA.