Accès à l'API

Transformez les espaces vides en intérieurs chaleureux et accueillants grâce à notre service de home staging virtuel en marque blanche.
  • Intégrez IACrea à vos applications
  • Bénéficiez de toutes nos fonctionnalités (rénovation, ameublement, extérieur, suppression d'objets...).
  • Bénéficiez de nos mises à jour régulières
IACrea est une application de projection de rendus après rénovation d'un bien immobilier

Navigation

Note: Les appels api déduisent le même nombre de photos qu'une utilisation depuis le site internet.

Note: En cas de statut "FAILED", vos photos sont automatiquement remboursées.

Pré-requis

- Afin d'utiliser nos services d'api, il est nécessaire de créer un compte IACrea et d'activer l'offre API en nous contactant : contact@iacrea.com

- Générez votre API key directement dans votre Espace Développeur.

- Chaque requête API doit être authentifiée à l'aide d'une API key. Veuillez inclure dans le header de toutes vos requêtes :

x-api-key: [API_KEY]

Générer une nouvelle rénovation

POST https://iacrea.com/api/renovate/generate

Appeler cette endpoint lance une nouvelle génération de rénovation suivant le thème et la pièce sélectionnée. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez modifier la décoration (format: jpg, png)
theme

Required. #string

Thème de votre nouvelle rénovation.

Valeurs possibles (différente suivant la pièce sélectionnée):

  • LIVING_ROOM: [MODERN, SCANDINAVIAN, LUXURIOUS, COASTAL, FARMHOUSE_CHIC, MODERN_POP]
  • BEDROOM: [MODERN, SCANDINAVIAN, FARMHOUSE_CHIC, LUXURIOUS, KIDS_ROOM]
  • HOME_OFFICE: [MODERN, SCANDINAVIAN]
  • DINING_ROOM: [MODERN, SCANDINAVIAN, COASTAL]
  • DINING_LIVING_ROOM: [MODERN, SCANDINAVIAN]
  • KITCHEN: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS, COASTAL]
  • BATHROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • SHOWEROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • EMPTY: [MODERN, SCANDINAVIAN]
  • VERANDA: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • WC: [MODERN, SCANDINAVIAN]
room_type

Required. #string

Votre type de pièce.

Valeurs possibles :

  • LIVING_ROOM
  • BEDROOM
  • EMPTY
  • KITCHEN
  • DINING_ROOM
  • DINING_LIVING_ROOM
  • HOME_OFFICE
  • SHOWEROOM
  • BATHROOM
  • VERANDA
  • WC
photo_360

Required. #boolean

True si votre image est une photo 360
keep_ceiling

#boolean

True pour préserver le plafond
keep_floor

#boolean

True pour préserver le sol
keep_wall

#boolean

True pour préserver les murs
webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "photo_360": true,
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/renovate/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","theme": "MODERN","room_type":"LIVING_ROOM","num_samples":"4","resolution":"768","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Générer une variation d'une pièce précédement rénovée

POST https://iacrea.com/api/renovate/generate-variation

Appeler cette endpoint permet de générer une variation d'une pièce précedemment rénovée suivant le thème et la pièce sélectionnée. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre pièce précedemment meublée Espace Développeur
room_type

Required. #string

Votre type de pièce.

Valeurs possibles :

  • LIVING_ROOM
  • BEDROOM
  • EMPTY
  • KITCHEN
  • DINING_ROOM
  • DINING_LIVING_ROOM
  • HOME_OFFICE
  • SHOWEROOM
  • BATHROOM
  • VERANDA
  • WC
theme

Required. #string

Thème de votre nouvelle rénovation.

Valeurs possibles (différente suivant la pièce sélectionnée):

  • LIVING_ROOM: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • BEDROOM: [MODERN, SCANDINAVIAN, FARMHOUSE_CHIC, LUXURIOUS, KIDS_ROOM]
  • HOME_OFFICE: [MODERN, SCANDINAVIAN]
  • DINING_ROOM: [MODERN, SCANDINAVIAN]
  • DINING_LIVING_ROOM: [MODERN, SCANDINAVIAN]
  • KITCHEN: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • BATHROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • SHOWEROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • EMPTY: [MODERN]
  • VERANDA: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • WC: [MODERN, SCANDINAVIAN]
photo_360

Required. #boolean

True si votre image est une photo 360
keep_ceiling

#boolean

True pour préserver le plafond
keep_floor

#boolean

True pour préserver le sol
keep_wall

#boolean

True pour préserver les murs

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","theme": "MODERN","room_type":"LIVING_ROOM","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

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

POST https://iacrea.com/api/renovate/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/renovate/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}

Générer un extérieur

POST https://iacrea.com/api/exterior/v2/generate

Appeler cette endpoint lance une nouvelle génération d'extérieur suivant le thème sélectionné. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez modifier la décoration (format: jpg, png)
room_type

Required. #string

Votre type de pièce.

Valeurs possibles: JARDIN, POOL, TERRACE, BALCON

keep_facade

#boolean

True pour préserver la façade
blue_sky

#boolean

True pour mettre un ciel bleu
webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "room_type": "JARDIN",
  "keep_facade": true,
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/exterior/v2/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","room_type":"LIVING_ROOM","num_samples":"4","resolution":"768","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Générer une variation d'un extérieur précédement généré

POST https://iacrea.com/api/exterior/v2/generate-variation

Appeler cette endpoint permet de générer une variation d'un extérieur précedemment généré suivant le thème et la pièce sélectionnée. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre extérieur précedemment généré Espace Développeur
room_type

Required. #string

Votre type de pièce.

Valeurs possibles: JARDIN, POOL, TERRACE, BALCON

keep_facade

Required. #boolean

True pour préserver la façade
blue_sky

Required. #boolean

True pour obtenir un ciel bleu

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "room_type": "LIVING_ROOM",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/exterior/v2/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","room_type":"JARDIN","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Récupérer un extérieur généré

POST https://iacrea.com/api/exterieur/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/exterior/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}

Meubler un espace vide

POST https://iacrea.com/api/furnish/generate

Appeler cette endpoint permet de meubler une pièce vide suivant le thème et la pièce sélectionnée. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez modifier la décoration (format: jpg, png)
theme

Required. #string

Thème de votre nouvelle décoration.

Valeurs possibles: MODERN, SCANDINAVIAN, INDUSTRIAL, STANDARD, COASTAL, AMERICAN, FARMHOUSE, LUXURY

room_type

Required. #string

Votre type de pièce.

Valeurs possibles: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR

webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du nouveau projet

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","theme": "MODERN","room_type":"LIVING_ROOM","image_url": "https://my-image.jpg"}'

Exemple de réponse body

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

Récupérer une pièce meublée

POST https://iacrea.com/api/furnish/get

Ce endpoint vous permet d'obtenir le résultat d'une génération d'ameublement précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}

Générer une variation d'une pièce précédement meublée

POST https://iacrea.com/api/furnish/generate-variation

Appeler cette endpoint permet de générer une variation d'une pièce précedemment meublée suivant le thème et la pièce sélectionnée. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre pièce précedemment meublée Espace Développeur
theme

Required. #string

Thème de votre nouvelle décoration.

Valeurs possibles: MODERN, SCANDINAVIAN, INDUSTRIAL, COASTAL, AMERICAN, FARMHOUSE, LUXURY

room_type

Required. #string

Votre type de pièce.

Valeurs possibles: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE

webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/generate/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","theme": "MODERN","room_type":"LIVING_ROOM","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Modifier un élément

POST https://iacrea.com/api/one_element/generate

Appeler ce endpoint permet de modifier un élément d'une photo.

Pour obtenir le résultat final de la génération, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez modifier la décoration (format: jpg, png)
element

Required. #string

Elements à modifier.

Valeurs possibles: WALL, BED, SKY_INTERIOR

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du nouveau projet

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "element": "WALL",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","element": "WALL","image_url": "https://my-image.jpg"}'

Exemple de réponse body

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

Récupérer la photo avec l'élément modifié

POST https://iacrea.com/api/one_element/get

Ce endpoint vous permet d'obtenir le résultat d'une modification d'un élément précédemment effectué. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/one_element/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}

Générer une variation d'un élément modifié

POST https://iacrea.com/api/one_element/generate-variation

Appeler ce endpoint permet de générer une variation d'un élément précedemment modifié. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre photo précedemment modifiée Espace Développeur
element

Required. #string

Elément à modifier.

Valeurs possibles: WALL, BED, SKY_INTERIOR

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "element": "WALL",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/one_element/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","element": "WALL","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Récupérer son nombre de photos

Ce endpoint vous permet d'obtenir vos photos restantes.

POST https://iacrea.com/api/account/credit

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur

API structure - Réponse

total
Le total restant de vos photos.
subscription
Le restant de vos photos issue de votre abonnement
extra
Le restant de vos extra photos

Exemple de request body

{
  "user_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/account/credit' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id"}'

Exemple de reponse body

{
  "total": "100",
  "subscription": "90",
  "extra": "10"
}

Supprimer de petits élements

POST https://iacrea.com/api/declutter/generate

Appeler cette endpoint permet de supprimer de petits éléments d'une image afin de les faire disparaître.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez supprimer des élements (format: jpg, png)
mark_url

Required. #url

Url du mask indiquant la position des éléments à supprimer (format: jpg, png)
webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "mark_url": "https://my-image-url.jpg",
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/declutter/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","image_url": "https://my-image.jpg"}, "mark_url": "https://my-mask.jpg"}'

Exemple de reponse body

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

Récupérer un désencombrement

POST https://iacrea.com/api/declutter/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/renovate/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
}

Désencombrer un espace

POST https://iacrea.com/api/declutter_total/generate

Appeler cette endpoint lance une nouvelle génération d'un désencombrement. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez supprimer des élements (format: jpg, png)
mark_url

Required. #url

Url du mask indiquant la position des éléments à supprimer (format: jpg, png)
webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "mark_url": "https://my-image-url.jpg",
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/declutter/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","room_type":"LIVING_ROOM","num_samples":"4","resolution":"768","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Générer une variation d'un désencombrement précédement généré

POST https://iacrea.com/api/declutter_total/generate-variation

Appeler cette endpoint permet de générer une variation d'un désencombrement précedemment généré. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre pièce précedemment meublée Espace Développeur
original_url

Required. #string

L'url original de la pièce à désencombrer.
mark_url

Required. #url

Url du mask indiquant la position des éléments à supprimer (format: jpg, png)

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "mark_url": "https://my-image-url.jpg",
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/generate/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","room_type":"JARDIN","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Récupérer un désencombrement généré

POST https://iacrea.com/api/declutter_total/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/renovate/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}
POST https://iacrea.com/api/remove_logo/generate

Appeler cette endpoint lance une nouvelle génération d'une photo sans logo. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez supprimer des élements (format: jpg, png)
mark_url

Required. #url

Url du mask indiquant la position des éléments à supprimer (format: jpg, png)
webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "mark_url": "https://my-image-url.jpg",
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/declutter/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","room_type":"LIVING_ROOM","num_samples":"4","resolution":"768","image_url": "https://my-image.jpg"}'

Exemple de reponse body

{
  "generation_id": "uuid",
  "remaining_photos": 100
  "project_id": "uuid",
}
POST https://iacrea.com/api/remove_logo/generate-variation

Appeler cette endpoint permet de générer une variation d'une suppression de logo précedemment généré. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre pièce précedemment meublée Espace Développeur
original_url

Required. #string

L'url original de la pièce à désencombrer.
mark_url

Required. #url

Url du mask indiquant la position des éléments à supprimer (format: jpg, png)

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "mark_url": "https://my-image-url.jpg",
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/furnish/generate/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","room_type":"JARDIN","image_url": "https://my-image.jpg"}'

Exemple de reponse body

{
  "generation_id": "uuid",
  "remaining_photos": 100
}
POST https://iacrea.com/api/remove_logo/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

Note: En cas de statut "FAILED", vos photos sont automatiquement remboursées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/renovate/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}

Générer une nouvelle rénovation à partir d'un plan

POST https://iacrea.com/api/plan/generate

Appeler cette endpoint lance une nouvelle génération de rénovation à partir d'un plan suivant le thème et la pièce sélectionnée. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez modifier la décoration (format: jpg, png)
theme

Required. #string

Thème de votre nouvelle rénovation.

Valeurs possibles (différente suivant la pièce sélectionnée):

  • LIVING_ROOM: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • BEDROOM: [MODERN, SCANDINAVIAN, FARMHOUSE_CHIC, LUXURIOUS, KIDS_ROOM]
  • HOME_OFFICE: [MODERN, SCANDINAVIAN]
  • DINING_ROOM: [MODERN, SCANDINAVIAN]
  • DINING_LIVING_ROOM: [MODERN, SCANDINAVIAN]
  • KITCHEN: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • BATHROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • SHOWEROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • EMPTY: [MODERN]
  • VERANDA: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • WC: [MODERN, SCANDINAVIAN]
room_type

Required. #string

Votre type de pièce.

Valeurs possibles :

  • LIVING_ROOM
  • BEDROOM
  • EMPTY
  • KITCHEN
  • DINING_ROOM
  • DINING_LIVING_ROOM
  • HOME_OFFICE
  • SHOWEROOM
  • BATHROOM
  • VERANDA
  • WC
webhook

Required. #url

L'url que nous appelons une fois que la génération est terminée. Le request body est le même que le request response de l'API de récupération

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "webhook": "https://my-webhook-url"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/plan/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","theme": "MODERN","room_type":"LIVING_ROOM","num_samples":"4","resolution":"768","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Générer une variation d'une pièce précédement rénovée à partir d'un plan

POST https://iacrea.com/api/plan/generate-variation

Appeler cette endpoint permet de générer une variation d'une pièce précedemment rénovée suivant le thème et la pièce sélectionnée. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre pièce précedemment meublée Espace Développeur
room_type

Required. #string

Votre type de pièce.

Valeurs possibles :

  • LIVING_ROOM
  • BEDROOM
  • EMPTY
  • KITCHEN
  • DINING_ROOM
  • DINING_LIVING_ROOM
  • HOME_OFFICE
  • SHOWEROOM
  • BATHROOM
  • VERANDA
  • WC
theme

Required. #string

Thème de votre nouvelle rénovation.

Valeurs possibles (différente suivant la pièce sélectionnée):

  • LIVING_ROOM: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • BEDROOM: [MODERN, SCANDINAVIAN, FARMHOUSE_CHIC, LUXURIOUS, KIDS_ROOM]
  • HOME_OFFICE: [MODERN, SCANDINAVIAN]
  • DINING_ROOM: [MODERN, SCANDINAVIAN]
  • DINING_LIVING_ROOM: [MODERN, SCANDINAVIAN]
  • KITCHEN: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • BATHROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • SHOWEROOM: [MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS]
  • EMPTY: [MODERN]
  • VERANDA: [MODERN, SCANDINAVIAN, LUXURIOUS, FARMHOUSE_CHIC, MODERN_POP]
  • WC: [MODERN, SCANDINAVIAN]

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/plan/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","theme": "MODERN","room_type":"LIVING_ROOM","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Récupérer une rénovation générée à partir d'un plan

POST https://iacrea.com/api/plan/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

Note: En cas de statut "FAILED", vos photos sont automatiquement remboursées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/plan/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}

Obtenir un ciel bleu

POST https://iacrea.com/api/sky/generate

Appeler cette endpoint lance une nouvelle génération permettant d'obtenir un ciel bleu. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la génération, vous devez soit fournir une URL de webhook à appeler lorsque les résultats sont prêts, soit interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
image_url

Required. #url

Url de l'image dont vous voulez modifier le ciel (format: jpg, png)

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération
project_id
L'id du project

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/sky/generate' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Générer une variation d'un ciel bleu précédement généré

POST https://iacrea.com/api/sky/generate-variation

Appeler cette endpoint permet de générer une variation d'un ciel bleu précedemment généré. Comme une génération peut prendre jusqu'à plusieurs minutes pour s'exécuter, le résultat ne sera pas immédiatement disponible.

Pour obtenir le résultat final de la variation, vous devez interroger régulièrement l'API de récupération pour obtenir une génération jusqu'à ce que le statut soit succeeded ou failed.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

Id de votre ciel bleu précedemment meublée

API structure - Réponse

generation_id
L'id de votre génération à ré-utiliser dans l'API de récupération
remaining_photos
Le nombre de photos restant suite à cette génération

Exemple de request body

{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/sky/generate-variation' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","image_url": "https://my-image.jpg"}'

Exemple de reponse body

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

Récupérer un ciel bleu généré

POST https://iacrea.com/api/sky/get

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

Note: En cas de statut "FAILED", vos photos sont automatiquement remboursées.

API structure - Request

user_id

Required. #string

Id de votre compte IACrea, vous pouvez le récupérer dans votre Espace Développeur
generation_id

Required. #string

L'Id de la génération retournée par l'API de génération

API structure - Réponse

status
Le status de la génération. starting, failed, succeeded
urls
Un tableau d'url contenant les urls des images générées
variationNumber
Le nombre de variation déjà effectué sur ce projet

Exemple de request body

{
  "user_id": "uuid",
  "generation_id": "uuid"
}

Exemple de cUrl request

curl --request POST \

--url 'https://iacrea.com/api/sky/get' \

--header x-api-key:API_KEY \

--header 'Content-Type: application/json' \

--data '{"user_id": "my-user-id","generation_id":"my-generation-id"}'

Exemple de reponse body

{
  "status": "SUCEEDED",
  "urls": ["https://url-de-image-generée"]
  "variationNumber": 2
}