Transformez des photos de produits à plat ou sur mannequin fantôme en photographies professionnelles sur modèle.

Produit vers Modèle

Le point de terminaison Produit vers Modèle transforme les photos de produits à plat ou sur mannequin fantôme en photographies professionnelles sur modèle, vous permettant de spécifier l'apparence du modèle ou le style photographique.

Nom du modèle : product-to-model

Cycle de vie : stable

Temps de traitement : ~10s–30s (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 image de produit 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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Réponse

Étant donné que la génération d'images peut prendre jusqu'à 20 secondes, le point de terminaison /v1/run renvoie immédiatement un statut 201 Created avec un id de tâche asynchrone. Vous devez interroger l'API de statut en utilisant GET /v1/status/{id} pour récupérer les résultats finaux. Alternativement, vous pouvez configurer des webhooks pour recevoir des notifications automatiquement. Veuillez noter que notre répartiteur de webhooks applique un délai d'attente strict de 15 secondes. Votre serveur doit accuser réception du webhook avec un code de statut 2xx dans les 15 secondes, sinon nous le considérerons comme échoué et le retenterons plus tard.

{
  "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", le champ output contiendra un tableau avec l'URL pointant vers votre image générée :

{
  "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/product-model-123.png"
  ]
}

Paramètres de la requête

Paramètres obligatoires

productImageRequiredstring

L'image du produit à draper sur un modèle (à plat ou sur mannequin fantôme). Peut être une URL accessible publiquement ou une chaîne d'image encodée en Base64. Taille maximale : 25 Mo.

Conseil de pro : Les photos à plat sur fond blanc produisent les résultats sur modèle les plus cohérents. Les photos de mannequin fonctionnent également bien. Retirez les étiquettes, les autocollants de prix ou les accessoires ne faisant pas partie du vêtement avant de prendre la photo. Assurez-vous que le vêtement entier est visible et déplié — pas de manches coupées.

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,...).

Paramètres facultatifs

customPromptstring

Instructions textuelles décrivant le modèle souhaité (par exemple, sexe, ethnie, pose) ou la scène. Longueur maximale : 500 caractères.

modelImageUrlstring

L'URL d'un modèle de référence humain à utiliser pour la génération. Si omis, un modèle diversifié aléatoire sera généré.

Modèles prédéfinis disponibles :

Remarque : Fournir un modèle de référence augmente le temps de traitement global.

styleIdstring

L'ID de style photographique à appliquer (par exemple, "studio", "iphone", "editorial"). Si omis, la valeur par défaut est une présentation de studio neutre.

Styles disponibles :

Style Name	Style ID (`styleId`)

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

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

Niveau de résolution de sortie. 1k produit une sortie d'environ 1 mégapixel, 2k d'environ 4 mégapixels et 4k d'environ 16 mégapixels. Par défaut : 1k

sampleCountinteger

Nombre de variations d'image à générer par requête. Doit être compris entre 1 et 4. 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 3:4 pour les photos de mode.

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

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

Coût des crédits

Pour les requêtes API développeur, le coût dépend du niveau de quality de sortie choisi multiplié par le sampleCount.

Formule : Coût = CréditsQualité × sampleCount

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