Documentation de configuration de style API#

URL de base : https://api.ideal.house
Version : v1
Mis à jour le : 2026-05-21

📖 Vue d'ensemble#

Le point de terminaison de configuration de style renvoie les groupes d'options de style utilisés par les API de génération. Ces options fournissent des identifiants valides pour des champs de requête tels que styleId, roomId, indoorStyleId, sceneId et d'autres paramètres de style similaires.

Les pages de fonctionnalités prises en charge incluent :

Les fichiers de ressources actuels incluent virtual-staging.json, de sorte que virtual_staging est le nom d'outil opérationnel pour la mise en scène virtuelle. La faute de frappe virual_staging n'est pas prise en charge par le fichier de ressources actuel et renvoie un contenu vide. Tout toolName non pris en charge renvoie un contenu vide.

🔐 Authentification#

📌 Point de terminaison API#

Obtenir la configuration de style#

Point de terminaison

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

En-têtes de la requête

Paramètres de chemin

📥 Exemple de requête#

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

📤 Structure de réponse#

Le corps de la réponse est regroupé par catégorie de style. Chaque catégorie correspond à un paramètre de requête via 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"
        }
      ]
    }
  }
}

Certains champs de requête prennent en charge plusieurs identifiants d'option. Pour ces champs, joignez les valeurs id sélectionnées avec une virgule, par exemple id1,id2.

🧭 Correspondance des noms d'outils#

Visualisation de plans#

GET /api/v1/style/ai_plan_visualizer/getStyles

Remplacement de mobilier#

GET /api/v1/style/change_furniture/getStyles

Rénovation extérieure#

GET /api/v1/style/exterior_renovator/getStyles

Décoration intérieure#

GET /api/v1/style/home_decor_ideas/getStyles

Réaménagement intérieur#

GET /api/v1/style/interoir_remodel/getStyles

Aménagement paysager#

GET /api/v1/style/landscaping/getStyles

Mise en scène virtuelle#

GET /api/v1/style/virtual_staging/getStyles

❌ Réponses d'erreur#

Pour les valeurs toolName non prises en charge, le point de terminaison renvoie un contenu vide dans data.