Passer au contenu principal

​
API Ciel Intérieur

Le service de Ciel Intérieur vous permet d’améliorer la vue depuis les fenêtres de vos intérieurs en remplaçant le ciel visible par un ciel bleu parfait et en optimisant les paysages visibles.

​
Générer un ciel intérieur

​
POST /api/sky_interior/generate
Appeler cet endpoint lance une nouvelle génération permettant d’améliorer les vues extérieures visibles à travers les fenêtres. Cette opération crée aussi un nouveau projet et, selon votre abonnement, il est possible d’obtenir des variations gratuites.

​
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 d’intérieur à améliorer (format: jpg, png)
​
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/sky_interior/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://exemple.com/interieur.jpg"
}'

​
Exemple de réponse

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

​
Générer une variation d’un ciel intérieur

​
POST /api/sky_interior/generate-variation
Cet endpoint permet de générer une variation d’un ciel intérieur précédemment généré.

​
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

​
Réponse

​
generation_id
string
L’identifiant unique de la nouvelle génération
​
remaining_photos
number
Le nombre de photos restant suite à cette génération

​
Exemple de requête

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

​
Exemple de réponse

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

​
Récupérer un ciel intérieur généré

​
POST /api/sky_interior/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/sky_interior/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
}
⌘I