API-Stilkonfiguration Dokumentation#

Basis-URL: https://api.ideal.house
Version: v1
Aktualisiert: 2026-05-21

📖 Übersicht#

Der API-Stilkonfiguration-Endpunkt gibt Stiloption-Gruppen zurück, die von Generierungs-APIs verwendet werden. Diese Optionen bieten gültige IDs für Anfragefelder wie styleId, roomId, indoorStyleId, sceneId und ähnliche Stilparameter.

Unterstützte Funktionsseiten umfassen:

Die aktuellen Ressourcendateien umfassen virtual-staging.json, sodass virtual_staging der gültige Werkzeugname für die virtuelle Raumausstattung ist. Die falsch geschriebene Version virual_staging wird von der aktuellen Ressourcendatei nicht unterstützt und gibt leere Inhalte zurück. Jeder nicht unterstützte toolName gibt leere Inhalte zurück.

🔐 Authentifizierung#

📌 API-Endpunkt#

Stilkonfiguration abrufen#

Endpunkt

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

Anforderungsheader

Pfadparameter

📥 Anfragbeispiel#

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

📤 Antwortstruktur#

Der Antwortkörper ist nach Stilbereich gruppiert. Jeder Bereich wird über backendParamKey einem Anfrageparameter zugeordnet.

{
  "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"
        }
      ]
    }
  }
}

Einige Anfragefelder unterstützen mehrere Options-IDs. Für diese Felder werden die ausgewählten id-Werte durch Kommas getrennt, z. B. id1,id2.

🧭 Zuordnung der Werkzeugnamen#

Planvisualisierung#

GET /api/v1/style/ai_plan_visualizer/getStyles

Möbel ändern#

GET /api/v1/style/change_furniture/getStyles

Außengestaltung#

GET /api/v1/style/exterior_renovator/getStyles

Raumdekoration#

GET /api/v1/style/home_decor_ideas/getStyles

Innenraumrenovierung#

GET /api/v1/style/interoir_remodel/getStyles

Gartengestaltung#

GET /api/v1/style/landscaping/getStyles

Virtuelle Raumausstattung#

GET /api/v1/style/virtual_staging/getStyles

❌ Fehlerantworten#

Bei nicht unterstützten toolName-Werten gibt der Endpunkt leere Inhalte in data zurück.