API Élément Ciblé

Le service d’Élément Ciblé vous permet de transformer un élément précis d’une image tout en préservant le reste de la composition.

Modifier un élément

POST /api/one_element/generate
Cet endpoint lance une nouvelle génération pour modifier un élément spécifique de votre image. Cette opération crée aussi un nouveau projet.

Paramètres de la requête

user_id
string
required
L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
image_url
string
required
URL de l’image contenant l’élément à modifier (format: jpg, png)
element
string
required
Type d’élément à modifier. Valeurs possibles: “WALL”, “FLOOR”, “CEILING”, “FURNITURE”, etc.
webhook
string
L’URL que nous appelons une fois que la génération est terminée

Réponse

generation_id
string
L’identifiant unique de la génération (UUID) à utiliser avec l’API de récupération
remaining_photos
number
Le nombre de photos restant suite à cette génération
project_id
string
L’identifiant unique du projet (UUID)

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/one_element/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://exemple.com/image.jpg",
  "element": "WALL"
}'

Exemple de réponse

{
  "generation_id": "uuid",
  "remaining_photos": 100,
  "project_id": "uuid"
}

Générer une variation d’une modification

POST /api/one_element/generate-variation
Cet endpoint permet de générer une variation d’une modification d’élément précédemment réalisée.

Paramètres de la requête

user_id
string
required
L’identifiant unique de l’utilisateur (UUID)
generation_id
string
required
L’identifiant unique de la génération précédente
room_type
string
required
Type d’élément à modifier pour cette variation. Valeurs possibles: “WALL”, “FLOOR”, “CEILING”, “FURNITURE”, etc.

Réponse

generation_id
string
L’identifiant unique de la nouvelle génération

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/one_element/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "room_type": "FLOOR"
}'

Exemple de réponse

{
  "generation_id": "uuid"
}

Récupérer une modification générée

POST /api/one_element/get
Cet endpoint vous permet d’obtenir le résultat d’une génération précédemment effectuée.

Paramètres de la requête

user_id
string
required
L’identifiant unique de l’utilisateur (UUID)
generation_id
string
required
L’identifiant unique de la génération à récupérer

Réponse

status
string
Le statut de la génération: “STARTING”, “PROCESSING”, “SUCCEEDED”, “FAILED”
urls
array
Un tableau d’URL contenant les URLs des images générées (présent seulement si status=“SUCCEEDED”)
variationNumber
number
Le nombre de variations déjà effectuées sur ce projet

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/one_element/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'

Exemple de réponse

{
  "status": "SUCCEEDED",
  "urls": ["https://url-de-image-generée"],
  "variationNumber": 2
}
Note importante: En cas de statut “FAILED”, vos photos sont automatiquement remboursées.