Documentación de la configuración de estilo de la API#

URL base: https://api.ideal.house
Versión: v1
Actualizado: 2026-05-21

📖 Descripción general#

El endpoint de configuración de estilo de la API devuelve grupos de opciones de estilo utilizados por las APIs de generación. Estas opciones proporcionan identificadores válidos para campos de solicitud como styleId, roomId, indoorStyleId, sceneId y parámetros de estilo similares.

Las páginas de funciones compatibles incluyen:

Los archivos de recursos actuales incluyen virtual-staging.json, por lo que virtual_staging es el nombre de la herramienta de trabajo para Ambientación virtual. virual_staging, que tiene un error tipográfico, no está respaldado por el archivo de recursos actual y devuelve contenido vacío. Cualquier toolName no compatible devuelve contenido vacío.

🔐 Autenticación#

📌 Endpoint de la API#

Obtener configuración de estilo#

Endpoint

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

Encabezados de la solicitud

Parámetros de ruta

📥 Ejemplo de solicitud#

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

📤 Estructura de respuesta#

El cuerpo de la respuesta se agrupa por categoría de estilo. Cada categoría se asigna a un parámetro de solicitud a través de 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"
        }
      ]
    }
  }
}

Algunos campos de solicitud admiten varios identificadores de opción. Para esos campos, une los valores de id seleccionados con comas, por ejemplo id1,id2.

🧭 Asignación de nombres de herramientas#

Visualización de planos#

GET /api/v1/style/ai_plan_visualizer/getStyles

Cambio de muebles#

GET /api/v1/style/change_furniture/getStyles

Renovación exterior#

GET /api/v1/style/exterior_renovator/getStyles

Decoración del hogar#

GET /api/v1/style/home_decor_ideas/getStyles

Remodelación interior#

GET /api/v1/style/interoir_remodel/getStyles

Paisajismo#

GET /api/v1/style/landscaping/getStyles

Ambientación virtual#

GET /api/v1/style/virtual_staging/getStyles

❌ Respuestas de error#

Para valores de toolName no compatibles, el endpoint devuelve contenido vacío en data.