Décrivez une nouvelle tenue à l'aide de texte pour l'appliquer sur des modèles de mode IA.

Essayage par Prompt

Le point de terminaison d'Essayage par Prompt vous permet de décrire une nouvelle tenue à l'aide de texte pour l'appliquer de manière transparente sur un modèle de mode IA.

Nom du modèle : prompt-tryon

Cycle de vie : stable

Temps de traitement : ~15s–40s (augmente lors de l'utilisation de références de style ou de modèle)

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 d'essayage au point de terminaison universel /v1/run :

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

Exemples de requêtes

Authentification Vous pouvez transmettre votre clé API soit en tant que jeton Bearer (Authorization: Bearer YOUR_API_KEY) soit via l'en-tête x-api-key (x-api-key: YOUR_API_KEY).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

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.

Lorsque la génération est terminée, le point de terminaison d'interrogation renverra status: "success" avec le tableau output suivant contenant les URL des images finales :

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

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.

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.

promptRequiredstring

Description textuelle de la tenue que vous souhaitez que le modèle porte.

Conseil de pro : Incluez le type de tissu (soie, coton, denim) et le style de coupe (ajusté, oversize) pour les meilleurs résultats. Spécifiez les couleurs précisément ("bleu marine" fonctionne mieux que "bleu") et référencez explicitement ce que le modèle porte déjà afin que l'IA sache exactement quoi changer.

Paramètres facultatifs

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

Niveau de résolution de sortie pour l'Essayage par Prompt (modèles Gemini). Les résolutions plus élevées consomment plus de crédits. Par défaut : 1k

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

ratiostring

Définit le rapport largeur/hauteur de l'image générée. Si vide, le système utilise par défaut le rapport d'aspect de l'image personImage.

Valeurs prises en charge : '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

modelImageUrlstring

Facultatif. URL d'un modèle de référence humain à utiliser au lieu de préserver les caractéristiques de la personne originale.

Modèles prédéfinis disponibles :

styleIdstring

Facultatif. Applique un style photographique spécifique à l'image de sortie.

Styles disponibles :

Style Name	Style ID (`styleId`)

Valeurs valides : y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

Remarque : Les styles complexes peuvent augmenter le temps de génération global.

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 sera mis à jour à "error" et le champ error contiendra la raison spécifique de l'échec.

Coût en crédits

Le coût dépend du niveau de quality sélectionné et est multiplié par votre sampleCount.

Formule : Cost = QualityCredits × sampleCount

Paramètre	Crédits par image
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5