Passer au contenu principal

​
API Ciel Bleu

Le service de ciel bleu vous permet de transformer un ciel nuageux, gris ou peu attrayant en un ciel bleu éclatant, améliorant ainsi considérablement l’apparence de vos photos extérieures.

​
Générer un ciel bleu

​
POST /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 plusieurs minutes, le résultat n’est pas immédiatement disponible. Vous pouvez soit fournir une URL de webhook, soit interroger régulièrement l’API de récupération.

​
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 dont vous voulez modifier le ciel (format: jpg, png)
​
webhook
string
L’URL que nous appelons une fois que la génération est terminée. Le request body est le même que la réponse de l’API de récupération

​
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/generate' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg"
}'

​
Exemple de réponse

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

​
Générer une variation d’un ciel bleu

​
POST /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 plusieurs minutes, le résultat n’est pas immédiatement disponible.

​
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
​
generation_id
string
required
L’identifiant unique de la génération précédente dont vous souhaitez créer une variation

​
Réponse

​
generation_id
string
L’identifiant unique de la nouvelle 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

​
Exemple de requête

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": "uuid",
  "generation_id": "uuid"
}'

​
Exemple de réponse

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

​
Récupérer un ciel bleu

​
POST /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 importante: En cas de statut “FAILED”, vos photos sont automatiquement remboursées.

​
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
​
generation_id
string
required
L’identifiant unique de la génération (UUID) retourné par l’API de génération

​
Réponse

​
status
string
Le status 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/get' \
--header x-api-key: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