Introducción a la API de Revit con Python: herramientas y primeros pasos

¿Qué aprenderás en esta guía?

Al empezar con la API de Revit, el objetivo no es desarrollar de inmediato un complemento completo, sino entender cómo encontrar elementos en el modelo, cómo gestionar sus propiedades y cómo controlar los cambios. El curso introductorio de Autodesk presenta una forma de acceder a la API de Revit con herramientas gratuitas. Entre sus temas principales figuran los filtros de elementos, las transacciones (Transactions) y la interfaz de usuario. Guardar y usar herramientas de Python también forma parte de los objetivos de aprendizaje.

Esta guía convierte esos temas en un pequeño flujo de trabajo con datos de habitaciones. Una habitación es un ejemplo claro para explorar propiedades relacionadas con los datos del proyecto, como el nombre, el número, el tipo de uso y los acabados. El objetivo aquí no es proporcionar una llamada específica a la API ni instrucciones con código ejecutable, sino explicar las herramientas y el orden de aprendizaje respaldados por las fuentes. No se presuponen versiones, métodos de instalación ni ejemplos de código que no aparezcan en ellas.

Requisitos y herramientas

Las herramientas utilizadas en el curso de Autodesk University son RevitPythonShell, Revit Lookup y pyRevit. El curso espera que los participantes tengan conocimientos básicos de Revit y conocimientos iniciales de Python. Según la página para desarrolladores de la API de Revit, la API ofrece una interfaz basada en .NET para automatizar tareas repetitivas y ampliar las funciones principales de Revit.

Antes de empezar, comprueba lo siguiente:

• La instalación de Revit y el archivo del proyecto que se utilizarán.

• Los conocimientos básicos de Revit y de Python.

• La información de instalación y compatibilidad de RevitPythonShell, Revit Lookup y pyRevit con la versión de Revit utilizada.

El curso introductorio no especifica una versión concreta de Revit ni los requisitos actuales de compatibilidad de cada herramienta. Por eso, consulta la documentación correspondiente antes de instalarlas. Como las fuentes tampoco explican si se necesita una cuenta, no debe suponerse que exista un requisito específico.

Primeros pasos, paso a paso

1. Empieza por revisar los datos de la habitación en Revit. Selecciona una habitación y revisa los campos de la paleta Properties. La documentación de Autodesk sobre las propiedades de las habitaciones incluye, entre otros ejemplos, el nombre, el número, el tipo de uso, el departamento y los acabados de muros, techos y suelos. Los valores de área y perímetro son de solo lectura; el volumen también se indica como de solo lectura únicamente cuando está activado el cálculo de volúmenes. Comprender esta diferencia ayuda a decidir qué datos vas a leer y cuáles pretendes modificar.

2. Plantea el primer ejercicio como un problema de búsqueda de elementos. Por ejemplo, empieza por aprender a separar las habitaciones del proyecto según un criterio determinado. El curso de Autodesk University presenta la recopilación y el filtrado de elementos con RevitPythonShell como uno de los objetivos básicos de aprendizaje. Antes de escribir código, describe con claridad qué elementos quieres seleccionar y qué significa la condición del filtro. Verifica las llamadas concretas a la API en la guía para desarrolladores de Autodesk y en sus ejemplos de código.

3. Incluye Revit Lookup entre las herramientas del curso. La fuente de Autodesk University menciona Revit Lookup como una de las herramientas utilizadas durante el curso, pero la descripción disponible no detalla sus funciones ni los pasos para usarlo. Por tanto, consulta su documentación para conocer cómo se utiliza, sin dar por sentado que tiene una función de inspección concreta ni una ruta específica en la interfaz. Así evitarás tratar como parte confirmada del flujo de aprendizaje una función que las fuentes no verifican.

4. Aprende sobre las transacciones junto con los cambios en el modelo. El curso incluye entre sus temas principales la ejecución de operaciones en elementos mediante RevitPythonShell. Antes de probar cambios en los datos del modelo, define de forma clara y acotada qué quieres modificar. Cambiar un dato como el nombre de una habitación no es lo mismo que leer un valor de solo lectura, como el área. No pases a una automatización amplia sin comprobar cómo afecta el cambio al archivo del proyecto. Como las fuentes no incluyen un ejemplo de código concreto para iniciar y finalizar una transacción, consulta la documentación pertinente de la API para verificar el método que debes aplicar.

5. Define un objetivo para guardar y reutilizar una herramienta de Python. Guardar y usar herramientas de Python también figura entre los objetivos de aprendizaje del curso introductorio. Primero, prepara una prueba pequeña para una sola tarea y luego evalúa si necesitas reutilizarla. pyRevit aparece en la lista de herramientas del curso, pero el texto de las fuentes no proporciona un comando concreto ni un flujo de trabajo con pyRevit. Consulta la documentación actual de la herramienta para conocer los detalles de instalación y uso.

6. Compara el resultado con las propiedades de la habitación. Comparar los datos obtenidos mediante la API con las propiedades que se muestran en Revit ayuda a verificar la información leída. Según la documentación de Autodesk, el número de habitación debe ser único en el proyecto; si ya se ha utilizado, Revit muestra una advertencia, pero permite continuar. Durante las pruebas, no confundas que aparezca una advertencia con que la operación quede completamente bloqueada. El área y el perímetro son valores de solo lectura; en el caso del volumen, que sea de solo lectura depende de que esté activado el cálculo de volúmenes.

Errores frecuentes

• Dar por sentada la versión: el curso introductorio no especifica una versión concreta de Revit ni de las herramientas. Verifica por separado la información de instalación y compatibilidad.

• Suponer que se pueden editar todas las propiedades de una habitación: el área y el perímetro son de solo lectura. El volumen también se define como de solo lectura únicamente cuando está activado el cálculo de volúmenes. Comprueba las características de cada propiedad antes de operar sobre ella.

• Escribir código sin definir el filtro: primero determina qué elementos quieres seleccionar y con qué condición; después, consulta la documentación de la API y sus ejemplos de código.

• Pasar por alto las transacciones: si las pruebas implican modificar el modelo, incluye el tema de las transacciones en tu plan de aprendizaje. Verifica en la documentación de la API el método concreto de implementación.

• Atribuir funciones que las fuentes no mencionan basándose solo en el nombre de una herramienta: RevitPythonShell, Revit Lookup y pyRevit aparecen en la lista de herramientas del curso, pero las fuentes no describen todas sus funciones ni los pasos de instalación actuales.

Próximos pasos: flujos de trabajo de arquitectura y visualización

Puedes usar este recorrido inicial para entender datos del proyecto como el número, el nombre, el tipo de uso y los acabados de las habitaciones. La página de la API de Revit menciona posibilidades para ampliar las funciones principales del software en ámbitos como la automatización, la simulación y la construcción. Esto ofrece una orientación para explorar tareas repetitivas con datos, pero no significa que una automatización concreta vaya a producir el mismo resultado en todos los proyectos.

Para arquitectos e interioristas, la prioridad es entender la naturaleza de los datos del modelo y qué propiedades están disponibles. Los equipos de BIM y visualización pueden evaluar cómo gestionar la información que necesitan mediante pequeñas pruebas. Antes de pasar a una herramienta más compleja, comprueba la compatibilidad de las herramientas con la versión de Revit utilizada, el efecto de los cambios en el proyecto y las condiciones de licencia. El curso de Autodesk University presenta un método para acceder a la API con herramientas gratuitas, pero esa afirmación no describe las condiciones actuales de licencia de todo el software ni de todas sus versiones.

Fuentes y licencia

Esta guía se ha adaptado al español a partir de la página para desarrolladores de la API de Revit de Autodesk, la documentación de Autodesk Revit 2025 sobre las propiedades de ejemplo de las habitaciones y el curso de Autodesk University “Revit Programming for Beginners: Easily Access the Revit API Using Free Tools”. En los registros de las fuentes, el estado de la licencia aparece como “libre”. Como no se especifica una licencia concreta de Creative Commons, no se afirma que exista una licencia abierta.