Guides
Décoration
POST /v1/decorations ajoute des accessoires sur les surfaces libres d’une pièce déjà aménagée : tableaux, textiles, plantes, objets décoratifs, livres, art de la table, lampes à poser et tapis. La décoration n’ajoute aucun meuble.
| Nom | Type | Description |
|---|---|---|
image | chaîne | Obligatoire. URL https:// ou fichier en multipart/form-data (voir Images). |
quality | chaîne | Obligatoire. Résolution de sortie : 1k, 2k, 4k ou 8k (voir Résolutions). |
style | chaîne | auto (par défaut), qui reprend le style de la pièce, ou l’id d’un style. |
density | chaîne | Quantité d’accessoires : minimal (quelques touches), moderate (par défaut) ou rich (pièce abondamment habillée). |
color_tone | chaîne | Tonalité des couleurs : neutral (blancs, beiges, bois clairs), balanced (par défaut, neutres relevés de quelques couleurs) ou bold (couleurs franches). |
character | chaîne | Caractère des objets : subtle (objets simples, intégrés à la pièce), balanced (par défaut, quelques pièces remarquables) ou bold (objets forts, qui affirment le style). |
categories | tableau | Familles d’accessoires permises : wall_art, textiles, plants, decorative_objects, books, tableware, table_lamps, rugs. De 1 à 16 valeurs ; une valeur répétée compte une fois. Par défaut : toutes. |
metadata | objet | Paires clé-valeur libres, rattachées à la génération et renvoyées avec elle (voir Métadonnées). |
background | booléen | true : la requête répond dès l’acceptation, et le résultat arrive par webhook ou par lecture (voir Générations). |
Droit de la clé :
decorations.L’API renvoie la génération terminée, de type
decoration, avec le statut 200 ; avec background: true, elle renvoie la génération en cours, avec le statut 202. L’image produite est dans output[0].url. Le champ input reprend tous les réglages, valeurs par défaut comprises.Chaque appel décore une seule vue. La décoration évite les accessoires des dernières décorations demandées : deux vues d’une même pièce reçoivent donc des décorations différentes.
| Statut | Code | Cause |
|---|---|---|
| 400 | parameter_invalid | quality absente ou inconnue, style inconnu, valeur inconnue de density, color_tone, character ou categories, categories vide ou de plus de 16 valeurs, ou metadata hors limites. |
| 503 | mode_unavailable | Décoration momentanément indisponible, ou indisponible dans la résolution demandée. |
Les erreurs des images d’entrée sont décrites dans Images d’entrée, et les erreurs communes à toutes les routes (clé, droits, solde, limites) dans Erreurs.