API Suppression de Logo

Le service de Suppression de Logo vous permet d’effacer les logos et filigranes de vos images tout en préservant la qualité visuelle.

POST /api/remove_logo/generate

Cet endpoint lance une nouvelle génération pour supprimer un logo ou filigrane d’une 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 le logo à supprimer (format: jpg, png)

mask_url
string
required

URL du masque indiquant la zone du logo à supprimer

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/remove_logo/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/masque.png"
}'

Exemple de réponse

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

Générer une variation de suppression

POST /api/remove_logo/generate-variation

Cet endpoint permet de générer une variation d’une suppression de logo 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

original_url
string
required

URL de l’image originale contenant le logo

mask_url
string

URL optionnelle d’un nouveau masque. Si non fourni, le masque de la génération précédente sera utilisé

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 nouvelle génération

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/remove_logo/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png"
}'

Exemple de réponse

{
  "generation_id": "uuid"
}

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

POST /api/remove_logo/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/remove_logo/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": 0
}

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