Documentazione della configurazione degli stili API#

URL di base: https://api.ideal.house
Versione: v1
Aggiornato: 2026-05-21

📖 Panoramica#

L'endpoint di configurazione degli stili API restituisce gruppi di opzioni di stile usati dalle APIs di generazione. Queste opzioni forniscono identificatori validi per campi della richiesta come styleId, roomId, indoorStyleId, sceneId e parametri di stile simili.

Le pagine delle funzionalità supportate comprendono:

I file di risorse attuali includono virtual-staging.json, quindi virtual_staging è il nome funzionante dello strumento di allestimento virtuale. La grafia errata virual_staging non corrisponde al file di risorse attuale e restituisce contenuto vuoto. Qualsiasi toolName non supportato restituisce contenuto vuoto.

🔐 Autenticazione#

📌 Endpoint API#

Ottieni la configurazione degli stili#

Endpoint

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

Intestazioni della richiesta

Parametri del percorso

📥 Esempio di richiesta#

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

📤 Struttura della risposta#

Il corpo della risposta è raggruppato per categoria di stile. Ogni categoria viene associata a un parametro della richiesta tramite 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"
        }
      ]
    }
  }
}

Alcuni campi della richiesta supportano più identificatori di opzione. Per questi campi, unisci i valori id selezionati con una virgola, ad esempio id1,id2.

🧭 Associazione dei nomi degli strumenti#

Visualizzazione delle planimetrie#

GET /api/v1/style/ai_plan_visualizer/getStyles

Sostituzione dei mobili#

GET /api/v1/style/change_furniture/getStyles

Ristrutturazione degli esterni#

GET /api/v1/style/exterior_renovator/getStyles

Decorazione della casa#

GET /api/v1/style/home_decor_ideas/getStyles

Ristrutturazione degli interni#

GET /api/v1/style/interoir_remodel/getStyles

Progettazione del paesaggio#

GET /api/v1/style/landscaping/getStyles

Allestimento virtuale#

GET /api/v1/style/virtual_staging/getStyles

❌ Risposte di errore#

Per valori toolName non supportati, l'endpoint restituisce contenuto vuoto in data.