Logo

Essayage Virtuel

Échangez des vêtements sur des modèles de mode IA de manière transparente à l'aide de références d'images.

Essayage Virtuel (Essayage d'Image)

Le point de terminaison d'Essayage vous permet d'ajuster un vêtement sur une personne de manière transparente à l'aide d'une référence d'image.

Nom du Modèle : tryon

Cycle de vie : stable

Temps de Traitement : ~15s–30s

Format de Sortie : Auto (JPEG ou PNG)

Méthodes de Livraison : URL (via Polling)

Crédits : 1 × sampleCount

Requête

Soumettez votre configuration d'essayage au point de terminaison universel /v1/run en utilisant une charge utile JSON.

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": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

Réponse

La génération d'essayage se déroule de manière asynchrone en arrière-plan. Votre requête renverra immédiatement un statut 200 OK avec un objet de suivi.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Interrogation des Résultats Vous devez utiliser l'id retourné pour interroger le point de terminaison de statut (GET https://fititon.app/api/v1/status/{id}) afin de récupérer les URL de vos images générées. Consultez le guide de Configuration de l'API pour des instructions détaillées.

Paramètres de Requête

Paramètres Obligatoires

personImageRequiredstring

L'image de base du modèle que vous souhaitez habiller. Peut être une URL accessible publiquement ou une chaîne d'image encodée en Base64. Formats pris en charge : JPEG, PNG, WEBP. Taille maximale : 25 Mo.

Conseil de Pro : Les poses de face avec les bras visibles produisent le drapé le plus réaliste. Retirez les sacs, écharpes ou vestes qui couvrent le corps avant la prise de vue.

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,...). Le point de terminaison /v1/run n'accepte que les charges utiles JSON, les téléchargements multipart/form-data ne sont donc pas pris en charge.

garmentImageRequiredstring

L'image du vêtement à essayer. Peut être une URL accessible publiquement ou une chaîne d'image encodée en Base64.

Conseil de Pro : Les photos de vêtements à plat sur fond blanc fonctionnent nettement mieux que les photos sur cintre ou les vêtements froissés.

Paramètres Optionnels

accuracy'standard' | 'high' | 'hyper'

Définit la fidélité de l'ajustement de l'essayage. Une précision plus élevée augmente la précision de la génération mais peut prendre légèrement plus de temps. Par défaut : standard

sampleCountinteger

Nombre de variations d'image à générer par requête. Doit être compris entre 1 et 4. Les images supplémentaires consomment plus de crédits et augmentent le temps de traitement de manière linéaire. Par défaut : 1

Erreurs d'Exécution

Les erreurs d'exécution pour cette fonctionnalité utilisent l'ensemble partagé documenté dans Gestion des Erreurs. Si une erreur survient pendant le traitement, le status passera à "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 point de terminaison d'Essayage Virtuel fonctionne à un tarif forfaitaire de 1 crédit par image générée, quel que soit le niveau de quality demandé.

Formule : Coût = 1 × sampleCount

ParamètreCrédits par Image
Tarif Forfaitaire1