Isolez un sujet et générez un arrière-plan entièrement nouveau et réaliste.

Remplacement d'arrière-plan

Le point de terminaison Remplacement d'arrière-plan vous permet d'isoler un sujet d'une image et de générer un arrière-plan entièrement nouveau et réaliste basé sur une invite textuelle.

Nom du modèle : background-replace

Cycle de vie : stable

Temps de traitement : ~5s–15s

Format de sortie : Auto (JPEG ou PNG)

Méthodes de livraison : URL

Crédits : 1 à 5 par génération (dépend de la qualité)

Requête

Soumettez votre configuration de remplacement d'arrière-plan au point de terminaison universel /v1/run :

POSThttps://fititon.app/api/v1/run

Exemples de requêtes

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

Réponse

Renvoie un statut 201 Created avec l'objet de suivi initial. La génération s'exécute de manière asynchrone.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Une fois que le status passe à "succeeded" (en interrogeant le point de terminaison GET), le champ output contiendra un tableau avec l'URL pointant vers votre arrière-plan généré :

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/bg-replace-123.png"
  ]
}

Paramètres de la requête

Paramètres obligatoires

subjectImageRequiredstring

L'image contenant le sujet que vous souhaitez isoler. Peut être une URL accessible publiquement ou une chaîne d'image encodée en Base64. Taille maximale : 25 Mo.

Conseil de pro : Les sujets avec des bords nets et précis sur un arrière-plan contrastant obtiennent les découpes les plus propres. Évitez les images où le sujet se fond dans l'arrière-plan (par exemple, une chemise blanche sur un mur blanc). Un éclairage à contraste élevé aide l'IA à s'appuyer sur la détection des bords pour séparer parfaitement le sujet.

Exigence de formatage Lors de la soumission d'une chaîne Base64, elle doit inclure le préfixe URI de données standard (par exemple, data:image/jpeg;base64,...).

scenePromptRequiredstring

Une description textuelle de la nouvelle scène d'arrière-plan que vous souhaitez générer derrière le sujet.

Paramètres facultatifs

quality'1k' | '2k' | '4k'

Niveau de résolution de sortie. Définit la résolution de l'image finale générée. Par défaut : 1k

Erreurs d'exécution

Les erreurs d'exécution pour cette fonctionnalité utilisent l'ensemble partagé documenté dans Gestion des erreurs. Si une erreur se produit pendant le traitement, le status sera mis à jour à "error" et le champ error contiendra la raison spécifique de l'échec.

Coût en crédits

Pour les requêtes API développeur, le coût dépend entièrement du niveau de quality de sortie choisi.

Formule : Coût = CréditsQualité

Niveau de qualité	Crédits par image
1k (Par défaut)	1
2k	3
4k	5