En resumen
- Para empezar, se necesita una cuenta de Google y una clave de API creada en Google AI Studio.
- Gemini API puede utilizarse mediante REST o con los SDK de Python, Go, Node.js, Java y C#.
- Los prompts de la guía se centran en evaluar la distribución espacial, los materiales, la iluminación, la cámara y la coherencia visual.
- Hay un ejemplo de comprensión de escenas 3D con la API; los resultados no deben sustituir las decisiones de diseño y han de compararse con la imagen de referencia.
Qué aprenderás
En esta guía veremos cómo plantear a Gemini API preguntas claras y acotadas junto con una imagen arquitectónica o una escena 3D. El objetivo no es pedirle que diseñe la imagen automáticamente, sino describir relaciones espaciales, establecer puntos de control antes de una presentación y obtener notas más estructuradas sobre la escena.
Gemini API Cookbook de Google incluye entre sus temas iniciales la creación de prompts básicos y las entradas multimodales. La misma fuente también ofrece un ejemplo orientado a comprender escenas 3D. Los prompts que aparecen a continuación no se han copiado de esos documentos: son ejemplos originales adaptados a los flujos de trabajo de arquitectura y visualización. La respuesta del modelo no debe considerarse un registro verificado de las medidas reales ni de las decisiones de diseño representadas en la imagen.
Requisitos
Para empezar, se necesita una cuenta de Google y una clave de API creada en Google AI Studio. Gemini API se puede invocar directamente como API REST; también ofrece SDK oficiales para Python, Go, Node.js, Java y C#. Cookbook recomienda seguir primero las guías de autenticación y «Get Started».
Esta guía no exige una versión de software concreta. El cliente o el código que utilices para añadir imágenes a la API debe admitir entradas multimodales. Mantén en secreto la clave de API y, antes de usar imágenes de proyectos o clientes, consulta las normas de tu organización sobre el intercambio de datos. Como el coste depende del modelo elegido y de las condiciones de uso, revisa los precios vigentes del modelo correspondiente antes de empezar a trabajar.
Análisis arquitectónico paso a paso
Elige el contenido que vas a analizar. Empieza con un único render de interior, una imagen de fachada o una vista de una escena 3D. Acota la pregunta según el contenido de la imagen: por ejemplo, pide comentarios solo sobre la percepción de la circulación o la distribución de la luz. No esperes que el modelo deduzca como datos ciertos medidas que no aparecen en la imagen.
Indica la tarea y sus límites en el prompt. En lugar de una petición amplia como «analiza la imagen», especifica qué elementos debe examinar y cómo debe organizar la respuesta. Añade la imagen a la llamada a la API como entrada multimodal.
Pide una descripción de las relaciones espaciales. Este ejemplo busca convertir en notas organizadas las relaciones visibles en un render de interior.
Bu iç mekân görselini mimari sunum kontrolü için incele. Görülebilen ana mekânları, açıklıkların konumunu ve mobilyaların birbirleriyle ilişkisini ayrı maddeler hâlinde tarif et. Görselde açıkça seçilemeyen bilgileri tahmin etme; belirsiz noktaları ayrıca belirt.Utiliza la respuesta como una lista de observaciones que el equipo de proyecto pueda revisar mientras consulta la imagen. Distinguir entre lo «visible» y lo «incierto» reduce el riesgo de tratar inferencias como datos de diseño.
Analiza los materiales y la iluminación con prompts separados. En vez de pedir muchas evaluaciones distintas en una sola solicitud, céntrate en un aspecto específico de la imagen. Así será más fácil organizar las notas según las revisiones del render.
Bu mimari görselde seçilebilen yüzey ve malzeme özelliklerini tarif et. Renk, parlaklık ve doku izlenimlerini gözleme dayalı olarak ayır; gerçek malzeme türünü görselden kesin belirleyemiyorsan bunu açıkça yaz. Görselde olmayan ürün veya malzeme adı ekleme.Este prompt no genera una lista de materiales: su objetivo es clasificar las impresiones que pueden percibirse en la imagen. Para elegir los materiales reales, utiliza la documentación del proyecto y las muestras.
Görseldeki ışık ve gölge dağılımını sunum kontrolü açısından değerlendir. Aydınlık ve karanlık bölgeleri, öne çıkan yansımaları ve okunması zorlaşan alanları ayrı başlıklarda belirt. Işık kaynağının yönü kesin seçilemiyorsa tahmin yürütme.Considera este resultado una lista de comprobación para volver a revisar la escena, no una instrucción para modificar directamente los ajustes del render.
Revisa la cámara y el encuadre. En especial en las imágenes de presentación, puedes preguntar qué elementos de diseño destaca el encuadre y qué zonas quedan fuera.
Bu mimari görselin kadrajını incele. Görselde en çok dikkat çeken üç unsuru ve kadraj nedeniyle daha az görünür kalan alanları belirt. Perspektif veya gerçek mekân ölçüsü hakkında kesin sonuç çıkarma; yalnızca görüntüde görülenleri değerlendir.En la última ronda, pide una revisión de coherencia. En lugar de dar por válidas como realidad del proyecto las respuestas anteriores, pide que genere preguntas para que el equipo las compruebe en la imagen.
Bu görsel için tasarım ekibinin doğrulaması gereken beş kontrol sorusu hazırla. Sorular; mekânsal ilişki, malzeme okunabilirliği, ışık ve kadrajla ilgili olsun. Görselde doğrulanamayan bir durumu gerçekmiş gibi ifade etme.Errores habituales
Deducir con certeza medidas o características técnicas a partir de la imagen: Una imagen en perspectiva, por sí sola, no ofrece medidas verificadas. Si necesitas medidas, códigos de materiales o nombres de productos, consulta las fuentes del proyecto.
Asignar varias tareas a un solo prompt: Divide la lectura del espacio, la interpretación de los materiales y la crítica del encuadre en prompts separados. Así será más fácil comparar las respuestas.
No mencionar la incertidumbre en el prompt: Si no quieres que el modelo especule, pídele explícitamente que señale lo que desconoce y no invente información que no se distinga en la imagen.
Tomar la respuesta como una aprobación del diseño: El resultado puede ayudar en las revisiones y los debates del equipo, pero no sustituye los planos del proyecto, el modelo ni la evaluación del responsable de diseño.
No comprobar los costes y las condiciones de acceso: Crear una clave de API es uno de los primeros pasos; antes de decidir qué modelo utilizar, revisa la información pertinente sobre acceso y precios.
Efectos en los flujos de trabajo de arquitectura y visualización
Este enfoque puede resultar útil para estudios de arquitectura, interioristas y equipos de archviz que quieran preparar rápidamente una lista de comprobación visual antes de renderizar o presentar un proyecto. Los estudiantes también pueden practicar cómo distinguir los elementos que se leen con claridad en una imagen de aquellos que admiten varias interpretaciones. Para contenido 3D más complejo, la fuente incluye un ejemplo de comprensión de escenas 3D; para conocer los formatos de datos y los detalles de implementación, consulta la guía de la API correspondiente.
Antes de empezar el flujo de trabajo, conviene revisar el acceso a la API, la seguridad de la clave y las condiciones de coste. Las fuentes no especifican requisitos de hardware local, por lo que esta guía no puede recomendar una tarjeta gráfica ni una estación de trabajo. Para tomar decisiones de producción, evalúa conjuntamente la imagen, la respuesta del modelo y la documentación del proyecto.
Próximos pasos
Haz la primera prueba con una sola imagen y un único objetivo de evaluación. Compara los resultados con la imagen junto con el equipo y registra qué prompts funcionan mejor. Después, consulta las guías de autenticación y de inicio de Gemini API Cookbook, la información sobre entradas multimodales y el ejemplo de escena 3D. Los equipos que trabajen con código pueden elegir la API REST o uno de los SDK oficiales.
Fuentes y licencia
Gemini API Cookbook de Google se publica bajo la licencia CC BY 4.0. Esta guía se ha adaptado al turco a partir de la ruta de inicio, la información sobre entradas multimodales y el ejemplo de escena 3D de la fuente. Los ejemplos de prompts son originales y se han preparado para el contexto de la arquitectura y la visualización.
Fuentes
1 fuenteNo republicamos los textos de las fuentes; las citas breves van marcadas y el resto es resumen y comentario propios.
Para los equipos de arquitectura y archviz, lo más práctico es considerar el modelo un asistente que enumera puntos que podrían pasar inadvertidos, no una herramienta que toma decisiones de diseño. Analizar por separado el espacio, los materiales y la iluminación mediante distintos prompts puede ayudar a organizar mejor los comentarios del equipo.
Para los estudios y estudiantes de Turquía, es importante revisar el coste de la API, la seguridad de la clave y las condiciones para compartir imágenes de clientes antes de empezar. Las fuentes no especifican requisitos de hardware local, por lo que no se puede concluir que sea necesaria una nueva inversión en estaciones de trabajo. Los resultados no sustituyen la verificación de medidas o materiales.
Preguntas frecuentes
¿Qué se necesita para analizar imágenes arquitectónicas con Gemini API?
Se necesita una cuenta de Google y una clave de API creada en Google AI Studio. La API puede utilizarse mediante REST o con los SDK de Python, Go, Node.js, Java y C#.
¿Puede Gemini API analizar escenas 3D?
Gemini API Cookbook incluye un ejemplo de comprensión de escenas 3D. Para conocer los detalles de implementación, consulta la guía de la API correspondiente.
¿Las respuestas de Gemini API al analizar imágenes arquitectónicas proporcionan medidas exactas?
Los prompts de esta guía están pensados para describir elementos visibles; no proporcionan medidas exactas ni información definitiva sobre materiales. Estos datos deben verificarse en las fuentes del proyecto.



