Документация по конфигурации стилей API#

Базовый URL: https://api.ideal.house
Версия: v1
Обновлено: 2026-05-21

📖 Обзор#

Конечная точка API настройки стиля возвращает группы вариантов стиля, используемые API генерации. Эти варианты предоставляют допустимые идентификаторы для полей запроса, таких как styleId, roomId, indoorStyleId, sceneId и аналогичных параметров стиля.

Поддерживаемые страницы функций включают:

Текущие файлы ресурсов включают virtual-staging.json, поэтому virtual_staging — это рабочее имя инструмента для виртуальной меблировки. Опечатка virual_staging не поддерживается текущим файлом ресурсов и возвращает пустое содержимое. Любое неподдерживаемое значение toolName возвращает пустое содержимое.

🔐 Аутентификация#

📌 Конечная точка API#

Получение конфигурации стилей#

Конечная точка

GET /api/v1/style/{toolName}/getStyles

Заголовки запроса

Параметры пути

📥 Пример запроса#

curl -X GET "https://api.ideal.house/api/v1/style/change_furniture/getStyles" \
  -H "APIKEY: your_api_key_here"

📤 Структура ответа#

Тело ответа сгруппировано по категориям стилей. Каждая категория сопоставляется с параметром запроса через backendParamKey.

{
  "code": 0,
  "message": "success",
  "data": {
    "roomType": {
      "backendParamKey": "indoorTypeId",
      "options": [
        {
          "name": {
            "en": "Living Room",
            "zh-CN": "客厅"
          },
          "id": "Interior Design_Interior Scene_Living Room",
          "url": "https://example.com/style-preview.webp"
        }
      ]
    }
  }
}

Некоторые поля запроса поддерживают несколько идентификаторов опций. Для таких полей объединяйте выбранные значения id запятой, например id1,id2.

🧭 Соответствие имен инструментов#

Визуализация плана#

GET /api/v1/style/ai_plan_visualizer/getStyles

Замена мебели#

GET /api/v1/style/change_furniture/getStyles

Обновление экстерьера#

GET /api/v1/style/exterior_renovator/getStyles

Декорирование дома#

GET /api/v1/style/home_decor_ideas/getStyles

Обновление интерьера#

GET /api/v1/style/interoir_remodel/getStyles

Ландшафтный дизайн#

GET /api/v1/style/landscaping/getStyles

Виртуальная меблировка#

GET /api/v1/style/virtual_staging/getStyles

❌ Ответы об ошибках#

Для неподдерживаемых значений toolName точка входа возвращает пустое содержимое в data.