API изображений недвижимости
Виртуальный стейджинг, реновация, улучшение фото, day-to-dusk, удаление объектов, планы этажей и все остальные инструменты Roomagen: каждый задокументирован и доступен через один эндпоинт задач и один API-ключ. Асинхронные задачи с вебхуками, результаты обычно за 20–60 секунд, а после покупки пакета на результатах нет брендинга Roomagen.
$ 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": [] }
Реальные результаты инструментов, стоящих за API
Эта пара «до/после» получена инструментом удаления объектов — тем же, который запускает API.
Демонстрационный пример: входное изображение создано с помощью ИИ для этого сайта; это не фото клиента.
Возможности API по направлениям
Почему команды выбирают Roomagen
Все инструменты, один эндпоинт
Стейджинг, реновация, улучшение, day-to-dusk, удаление, экстерьеры и планы этажей работают через POST /v1/jobs, а параметры каждого инструмента описаны в документации с примером. Инструмент переключается одним параметром.
Планы этажей, 2D и 3D
Отправьте 2D-план, скан или фото рисунка от руки на телефон и получите 3D-рендер с мебелью или без, аккуратно перерисованный план, раскрашенный план или маркетинговое изображение с видом сверху.
Без брендинга после покупки пакета
50 бесплатных изображений генерируются с водяным знаком Roomagen: они нужны для разработки и тестирования. Как только ваш аккаунт покупает пакет, каждый новый рендер приходит без брендинга Roomagen, включая оставшиеся бесплатные изображения.
Безопасные повторы
Передайте заголовок Idempotency-Key, и повторный запрос вернёт исходную задачу: без второго списания и второго рендера.
Неудачные задачи возвращаются
Задача, которая не удалась при генерации, возвращается автоматически. Вебхуки подписаны HMAC, до пяти попыток доставки примерно за 36 минут.
Self-serve и настоящая документация
Создайте ключ в портале разработчика — без звонка в отдел продаж. Публичная документация с примерами cURL, Node.js и Python; результаты — через вебхук или поллинг.
Спроектирован, чтобы быть знакомым
Отправьте задачу, получите id задачи, получите вебхук по её завершении. Одно изображение на задачу: запускайте задачи параллельно, до 60 новых задач в минуту на ключ.
$ 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": [] }
Простые предоплаченные цены
Кредиты измеряются в изображениях. Предоплата, срок действия не истекает. Неудачные генерации никогда не тарифицируются.
Developer
$0
50 изображений с водяным знаком, единоразово
только первый ключ
Growth
$550
2,500 изображений
$0.22 / изображение
Предоплата · не сгорает
Цены за сгенерированное изображение; рендер в 4K считается за два. После покупки пакета рендеры не несут брендинга Roomagen. Уведомление за 30 дней до любого изменения цен.
Запуск за считаные минуты
Создайте ключ, отправьте один POST, получите готовое изображение. Без звонка менеджеру и очереди на подключение.
- 1
Создайте ключ
Войдите в портал разработчика и сгенерируйте ключ. Он показывается один раз — сохраните его в надёжном месте.
developers.roomagen.com/portal ↗ - 2
Запустите первую задачу
Один POST со slug инструмента и вашим изображением. Ответ приходит сразу с id задачи — генерация идёт в фоне.
$ 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
Заберите результат
Укажите webhook_url, и мы вызовем его, когда изображение готово, либо опрашивайте эндпоинт задачи. Обычно 20–60 секунд.
POST → your webhook_urlGET /api/v1/jobs/{id}
✓ 50 бесплатных изображений на первом ключе, с водяным знаком до покупки пакета · карта не требуется
FAQ по API
Создаёте что-то с изображениями недвижимости?
Создайте ключ в портале разработчика и проведите первую задачу уже сегодня. 50 бесплатных изображений для разработки и тестов (с водяным знаком до покупки пакета), карта не требуется.
Получить API-ключ