API para Desarrolladores — Disponible

La API de Imágenes Inmobiliarias

Home staging virtual, renovación, mejora de fotos, day-to-dusk, eliminación de objetos, planos de planta y el resto de herramientas de Roomagen: cada una documentada, detrás de un solo endpoint de trabajos y una sola clave API. Trabajos asíncronos con webhooks, resultados normalmente en 20–60 segundos y sin marca de Roomagen en la salida una vez que su cuenta ha comprado un paquete.

terminal — roomagen api
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
-H "X-Api-Key: rmg_live_..." \
-H "Content-Type: application/json" \
-d '{
"tool": "virtual-staging",
"image_url": "https://example.com/empty-living-room.jpg",
"options": { "style": "scandinavian", "roomType": "living-room" },
"webhook_url": "https://yourapp.com/hooks/roomagen"
}'
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Resultados reales de las herramientas detrás de la API

Este par antes/después viene de la eliminación de objetos, la misma herramienta que ejecuta la API.

Object removal input
input.jpg
Object removal result
✓ result.jpg · 26s

Ejemplo de demostración: la imagen de entrada se creó con IA para este sitio web; no es una foto de un cliente.

Por qué los equipos eligen Roomagen

Todas las herramientas, un endpoint

Staging, renovación, mejora, day-to-dusk, eliminación, exteriores y planos de planta pasan todos por POST /v1/jobs, y las opciones de cada herramienta están documentadas con un ejemplo. Cambia de herramienta con un solo parámetro.

Planos de planta, 2D y 3D

Envíe un plano 2D, un escaneo o una foto con el móvil de un dibujo a mano y reciba un render 3D amueblado o vacío, un plano redibujado y limpio, un plano coloreado o una imagen de marketing en vista cenital.

Sin marca al comprar un paquete

Las 50 imágenes gratuitas se generan con una marca de agua de Roomagen: sirven para construir y probar. En cuanto su cuenta compra un paquete, cada nuevo render llega sin marca de Roomagen, incluidas las imágenes gratuitas que le queden.

Reintentos seguros

Envíe un encabezado Idempotency-Key y una solicitud repetida devuelve el trabajo original: sin segundo cobro ni segundo render.

Los trabajos fallidos se reembolsan

Un trabajo que falla durante la generación se reembolsa automáticamente. Los webhooks van firmados con HMAC, con hasta cinco intentos de entrega en unos 36 minutos.

Autoservicio, documentación real

Cree una clave en el portal para desarrolladores, sin llamadas de ventas. Documentación pública con ejemplos en cURL, Node.js y Python; reciba los resultados por webhook o por polling.

Diseñada para resultar familiar

Envíe un trabajo, obtenga un id de trabajo, reciba un webhook cuando se complete. Una imagen por trabajo: ejecute trabajos en paralelo, hasta 60 trabajos nuevos por minuto y por clave.

POST /api/v1/jobs
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
-H "X-Api-Key: rmg_live_..." \
-H "Content-Type: application/json" \
-d '{
"tool": "virtual-staging",
"image_url": "https://example.com/empty-living-room.jpg",
"options": { "style": "scandinavian", "roomType": "living-room" },
"webhook_url": "https://yourapp.com/hooks/roomagen"
}'
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Precios prepagados simples

Los créditos se denominan en imágenes. Son prepagados y nunca caducan. Las generaciones fallidas nunca se cobran.

Sin tarjeta

Developer

$0

50 imágenes con marca de agua, una vez

solo primera clave

Pilot

$125

500 imágenes

$0.25 / imagen

Comprar en el portal

Prepago · nunca caduca

El más popular

Growth

$550

2,500 imágenes

$0.22 / imagen

Comprar en el portal

Prepago · nunca caduca

Scale

$2,000

10,000 imágenes

$0.20 / imagen

Comprar en el portal

Prepago · nunca caduca

Descuentos por uso comprometido

Volume

Personalizado

Más de 50,000 imágenes

Hable con nosotros

Precios por imagen generada; un render 4K cuenta como dos. Los renders no llevan marca de Roomagen una vez que la cuenta ha comprado un paquete. Aviso con 30 días de antelación antes de cualquier cambio de precio.

En marcha en minutos

Cree una clave, envíe un POST y reciba la imagen terminada. Sin llamada comercial, sin cola de incorporación.

roomagen-api — quickstartv1
  1. 1

    Cree su clave

    Inicie sesión en el portal de desarrolladores y genere una clave. Se muestra una sola vez, guárdela en un lugar seguro.

    developers.roomagen.com/portal ↗
  2. 2

    Lance su primer trabajo

    Un POST con el slug de la herramienta y su imagen. Responde de inmediato con un id de trabajo; la generación corre en segundo plano.

    $ curl -X POST https://api.roomagen.com/api/v1/jobs \
    -H "X-Api-Key: rmg_live_..." \
    -H "Content-Type: application/json" \
    -d '{ "tool": "virtual-staging",
    "image_url": "https://example.com/photo.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" } }'
    # → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
  3. 3

    Obtenga el resultado

    Defina un webhook_url y le avisamos cuando la imagen esté lista, o consulte el endpoint del trabajo. Normalmente entre 20 y 60 segundos.

    POST → your webhook_urlGET /api/v1/jobs/{id}

✓ 50 imágenes gratis con su primera clave, con marca de agua hasta que compre un paquete · sin tarjeta

Preguntas frecuentes sobre la API

Todas las herramientas de la aplicación web de Roomagen: home staging virtual, vaciado y ordenado de espacios, renovación interior y exterior, cocinas y baños, edición de fotos, day-to-dusk y las herramientas de planos de planta. Usted elige la herramienta por trabajo con un solo parámetro. Cada herramienta está documentada con sus opciones y un ejemplo en developers.roomagen.com/docs/tools, y GET /v1/tools lista todos los slugs que su clave puede llamar.

Los trabajos suelen estar listos en 20–60 segundos; el home staging virtual y la renovación virtual quedan en la parte alta de ese rango. Recibe un webhook cuando un trabajo termina, o puede consultar el trabajo cada 2–5 segundos.

Sí, una vez que su cuenta ha comprado un paquete: los renders no llevan marca ni marca de agua de Roomagen, mientras que los renders anteriores hechos con las 50 imágenes gratuitas llevan marca de agua, para construir y probar. La API no añade su logotipo ni una etiqueta de divulgación: añada la etiqueta que exijan sus reglas de anuncios en su propio flujo.

Un trabajo que falla durante la generación se reembolsa automáticamente, y su campo error indica el motivo. Un trabajo completado se cobra una vez; ejecutarlo de nuevo es un trabajo nuevo.

Paquetes prepagados denominados en imágenes: 500 imágenes a $0.25, 2,500 a $0.22, 10,000 a $0.20, y precios negociados de uso comprometido por encima de 50,000. Un render 4K cuenta como dos imágenes. Los paquetes nunca caducan y se acumulan.

No. Un trabajo devuelve solo la imagen editada: sin etiqueta de divulgación, sin registro de cambios y sin copia del original. Conserve su foto de origen y etiquete las imágenes editadas cuando su MLS o la ley local lo exijan; la ley AB 723 de California, por ejemplo, exige una declaración de divulgación y un enlace al original sin alterar.

Integrar la salida de Roomagen en su propio producto o plataforma es exactamente para lo que existe la API. Redistribuir la API en bruto como su propia API requiere un acuerdo de reventa — contáctenos.

Sí — al crear su primera clave API se añaden 50 imágenes gratuitas a la cuenta, una sola vez y sin tarjeta. Se generan con una marca de agua de Roomagen hasta que la cuenta compra un paquete y cubren el ciclo completo de un trabajo, webhooks incluidos, para construir y probar antes de comprar.

¿Está construyendo algo con imágenes de propiedades?

Cree una clave en el portal de desarrolladores y lance su primer trabajo hoy mismo. 50 imágenes gratis para construir y probar (con marca de agua hasta que compre un paquete), sin tarjeta.

Obtenga su clave API