En esta página
- Tres formas de hacer llegar una sesión a la edición
- Importación automática desde Dropbox: automatizar sin desarrollador
- La API de edición: editar dentro de tu propia plataforma
- Cómo elegir la forma de automatizar la edición de fotos inmobiliarias
- Por qué muchos equipos usan las dos
- Acceso y seguridad
- Cómo ponerlo en marcha
- Cuánto cuesta
Cuando una empresa de medios inmobiliarios decide automatizar la edición de fotos inmobiliarias, la siguiente pregunta es cómo deben llegar las sesiones a la edición. La respuesta depende menos de la edición y más de tu equipo: dónde dejan ya sus archivos los fotógrafos, si tienes un desarrollador y dónde tienen que acabar las fotos terminadas.
Esta guía compara las dos vías automatizadas que ofrece Stager AI, una carpeta vigilada de Dropbox y la API de edición, tomando la aplicación web como punto de partida.
Tres formas de hacer llegar una sesión a la edición
| Aplicación web | Importación automática desde Dropbox | API de edición | |
|---|---|---|---|
| Quién la configura | Nadie | Un responsable de operaciones, una vez | Un desarrollador |
| Qué pone en marcha la edición | Alguien sube y hace clic | Una subida completa a la carpeta vigilada | Tu software, por lote |
| Dónde están los ajustes | Se eligen en la barra lateral y se recuerdan por persona | Guardados en la conexión con Dropbox | Se envían con cada petición |
| Adónde van los resultados | Al proyecto de Stager AI | Al proyecto de Stager AI | A tu sistema, con un webhook firmado por foto |
| Ideal para | Sesiones ocasionales o puntuales | Equipos que ya usan Dropbox | Plataformas con sus propios pedidos y entregas |
Importación automática desde Dropbox: automatizar sin desarrollador
Con la importación automática desde Dropbox, conectas una cuenta de Dropbox una vez, eliges la carpeta que quieres vigilar y guardas tus ajustes HDR. A partir de ahí, basta con que un fotógrafo suba una sesión: 10 minutos después de que llegue el último archivo, la sesión se convierte en un proyecto y se edita.
- Encaja con cómo ya trabajan los fotógrafos. Siguen subiendo a Dropbox y nadie mueve archivos.
- Funciona con carpetas de equipo, con una subcarpeta por sesión o con tu propia estructura y una etiqueta en las carpetas que quieres editar.
- Controles de volumen: un límite diario de archivos con aprobación, pausa y cancelación.
- Acceso de solo lectura. Las fotos editadas aparecen en tu proyecto de Stager AI, listas para revisar y entregar. No se escribe nada de vuelta en Dropbox.
La limitación está al final del flujo: alguien sigue revisando y entregando desde el proyecto de Stager AI. Para muchos equipos, ahí es justo donde quieren a una persona de todos modos. La configuración completa para equipos está en nuestro flujo de trabajo con Dropbox para equipos de fotografía inmobiliaria.
La API de edición: editar dentro de tu propia plataforma
Si tu empresa tiene su propio sistema de reservas, pedidos o entregas, la API de edición de fotos inmobiliarias permite que ese sistema envíe sesiones y reciba los resultados sin que nadie abra Stager AI. Una sesión completa son cuatro llamadas:
- 1Crea un lote para la sesión, con tu propio ID de trabajo adjunto.
- 2Sube cada foto mediante URL de subida firmadas.
- 3Inicia el procesamiento. Los horquillados se agrupan en escenas automáticamente.
- 4Recibe un webhook por cada foto terminada o fallida, firmado con HMAC-SHA256 para que puedas comprobar que de verdad viene de nosotros. También puedes consultar el estado del lote en cualquier momento.
- 1. Crea un proyecto para el inmueblePOST /api/projects{ "title": "12 Harbour View" }
- 2. Crea el lote, con tu ID de trabajoPOST /api/hdr-batch{ "projectId": "project_uuid", "perspectiveCorrection": true, "clientReferenceId": "JOB-2041" }
- 3. Pide una URL de subida firmada por fotoPOST /api/hdr-batch/:batchId/url
- 4. Inicia el procesamientoPOST /api/hdr-batch/:batchId/enhance
- 5. Webhook: una foto está listaPOST https://your-app.com/webhooks/stagerX-Stager-Signature: sha256=… { "eventType": "hdr.image.completed", … }
La API usa los mismos ajustes que la aplicación: estilo de edición, corrección de lente y de perspectiva, eliminación del fotógrafo, fuego, pantalla de TV en negro, privacidad y blurLicensePlates, definidos por lote. Tu ID de trabajo interno vuelve en cada consulta de estado, así que cuadrar trabajos y pedidos es sencillo. Todos los planes incluyen acceso a la API: genera una clave y añade la URL de tu webhook en la sección Acceso a la API de tu página de cuenta, y luego consulta la documentación de la API.
Cómo elegir la forma de automatizar la edición de fotos inmobiliarias
Cuatro preguntas suelen bastar para decidir:
- ¿Adónde van hoy las sesiones? Si la respuesta es Dropbox, empieza por la importación automática. Conectarla es gratis y se hace en minutos.
- ¿Tienes un desarrollador, en plantilla o externo? La API necesita a alguien que construya y mantenga la integración.
- ¿Dónde tienen que acabar las fotos terminadas? Si deben aparecer automáticamente en tu propia galería de clientes o en tu sistema, eso es trabajo de la API.
- ¿Quién da el visto bueno a una galería? Si una persona revisa igualmente cada entrega, Dropbox más un paso de revisión en Stager AI suele ser suficiente.
¿Qué vía encaja con tu equipo?
0/4Responde cuatro preguntas rápidas y te damos una recomendación.
1.¿Dónde acaban hoy tus sesiones?
2.¿Tienes un desarrollador, propio o externo?
3.¿Las fotos terminadas deben llegar solas a tu sistema?
4.¿Quién da el visto bueno a una galería?
Por qué muchos equipos usan las dos
Las vías no son excluyentes. Una configuración habitual es Dropbox para los fotógrafos que están en la calle y la API para los pedidos que entran por la plataforma de la empresa, por ejemplo reediciones o sesiones entregadas por colaboradores. Mientras las dos usen el mismo estilo de edición, el resultado se ve igual: guárdalo en la conexión con Dropbox y envía editingStyle en cada petición a la API. Explicamos por qué importa en cómo mantener un estilo de edición coherente entre todos tus fotógrafos.
Elijas la vía que elijas, mantén un control de calidad antes de entregar. Nuestro checklist de control de calidad de fotos inmobiliarias recoge qué mirar, y AI QA puntúa cada foto terminada para que sepas por dónde empezar.
Acceso y seguridad
Automatizar significa que otro sistema toca tus archivos y las fotos de tus clientes, así que conviene saber qué puede ver y hacer cada vía.
- Dropbox: Stager AI pide acceso de solo lectura y solo procesa los archivos subidos a la carpeta vigilada después de elegirla. Nunca escribe, mueve ni borra nada en tu Dropbox.
- API: cada petición usa tu cabecera stager-api-key. Guarda la clave en tu servidor, nunca en una aplicación ni en una página web.
- Webhooks: cada evento va firmado con HMAC-SHA256. Verifica la firma antes de actuar sobre un evento, para que nadie más pueda marcar un trabajo como terminado en tu sistema.
Cómo ponerlo en marcha
Elijas la vía que elijas, empieza con poco y amplía cuando las primeras sesiones salgan bien.
Importación automática desde Dropbox
- 1Conecta una cuenta de Dropbox de la empresa y elige la carpeta.
- 2Guarda el estilo de edición y los ajustes HDR, y fija un límite diario de archivos.
- 3Haz una sesión de prueba de principio a fin, de la subida a la entrega.
- 4Suma uno o dos fotógrafos durante una semana y luego al resto del equipo.
API de edición
- 1Genera una clave de API y configura la URL de tu webhook en tu página de cuenta.
- 2Construye las cuatro llamadas y el endpoint del webhook, con tus propios ID de trabajo adjuntos.
- 3Envía algunas sesiones reales y compáralas con las mismas sesiones editadas en la aplicación web.
- 4Pasa tu plataforma primero para un cliente o una zona, y luego para todo.
Cuánto cuesta
Conectar Dropbox es gratis. Cada foto editada usa 1 crédito, llegue por la vía que llegue, y un horquillado de 3, 5 o 7 exposiciones cuenta como una foto. Los planes empiezan en 10 fotos al mes y las fotos no utilizadas se acumulan para el mes siguiente. Todos los planes incluyen acceso a la API. Para descuentos por volumen, cuéntanos cómo son tus sesiones.
Preguntas frecuentes
Para la mayoría de los equipos, una carpeta vigilada de Dropbox. Conectas Dropbox una vez, eliges una carpeta y guardas tus ajustes, y cada sesión que se sube se edita automáticamente 10 minutos después de que llegue su último archivo. No hace falta desarrollador.
Cuando las sesiones entran por tu propio software de reservas o de entrega, o cuando las fotos terminadas tienen que llegar automáticamente a tu sistema. La API envía un webhook firmado por cada foto terminada o fallida.
Sí. Muchos equipos usan Dropbox para los fotógrafos y la API para los pedidos de su plataforma. Guarda el estilo de edición en la conexión con Dropbox y envía el mismo editingStyle en cada petición a la API, y los resultados se verán iguales.
Todos los planes incluyen acceso a la API. Genera una clave en la sección Acceso a la API de tu página de cuenta y añade una URL de webhook si quieres un evento por cada foto terminada. Para descuentos por volumen, escríbenos por el chat.
No. El acceso es de solo lectura, así que las fotos editadas aparecen en tu proyecto de Stager AI, donde puedes revisarlas, descargarlas o entregarlas.



