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
L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
URL de l’image contenant l’élément à modifier (format: jpg, png)
Type d’élément à modifier. Valeurs possibles: “WALL”, “FLOOR”, “CEILING”, “FURNITURE”, etc.
L’URL que nous appelons une fois que la génération est terminée
Réponse
L’identifiant unique de la génération (UUID) à utiliser avec l’API de récupération
Le nombre de photos restant suite à cette génération
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
L’identifiant unique de l’utilisateur (UUID)
L’identifiant unique de la génération précédente
Type d’élément à modifier pour cette variation. Valeurs possibles: “WALL”, “FLOOR”, “CEILING”, “FURNITURE”, etc.
Réponse
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
L’identifiant unique de l’utilisateur (UUID)
L’identifiant unique de la génération à récupérer
Réponse
Le statut de la génération: “STARTING”, “PROCESSING”, “SUCCEEDED”, “FAILED”
Un tableau d’URL contenant les URLs des images générées (présent seulement si status=“SUCCEEDED”)
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.