Générez des modèles de mode IA entièrement uniques ou téléchargez des images de référence personnalisées à utiliser pour les essayages virtuels.

Création de modèle

La création de modèle vous permet de générer des modèles de mode réalistes avec des invites simples et intuitives ou des images de référence, ou de télécharger des images de modèles existantes dans votre espace de travail.

Nom du modèle : model-create

Cycle de vie : stable

Temps de traitement : ~10s–30s (augmente lors de l'utilisation de références avancées comme le visage/la pose)

Format de sortie : Auto (JPEG ou PNG)

Méthodes de livraison : URL

Crédits : 1 à 5 par modèle (1k: 1, 2k: 3, 4k: 5)

Requête

Générez ou téléchargez des modèles de mode en soumettant votre configuration 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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Réponse

Étant donné que la génération de modèles peut prendre jusqu'à 30 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 réessaierons 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 modèle 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/model-123.png"
  ]
}

Paramètres de la requête

Paramètres obligatoires

typeRequired'generate' | 'upload'

Spécifie s'il faut générer un nouveau modèle via l'IA (generate) ou télécharger une image existante (upload).

nameRequiredstring

Un nom descriptif pour votre modèle. Il est utilisé pour identifier le modèle dans votre studio.

promptstring

Obligatoire pour la génération Description textuelle du modèle à générer. Décrit le modèle de mode, les vêtements, la pose et la scène d'arrière-plan souhaités.

Conseil de pro : Si vous utilisez une référence comme faceModelId, l'IA donnera la priorité à l'identité de la référence, mais utilisera votre invite pour déterminer le décor, la tenue et les caractéristiques corporelles. Facultatif uniquement si un faceModelId est fourni.

imageBase64string

Obligatoire pour le téléchargement Chaîne d'image encodée en Base64. Obligatoire lorsque type est défini sur upload.

Exigence de formatage Votre chaîne Base64 doit inclure le préfixe URI de données standard (par exemple, data:image/jpeg;base64,... ou data:image/png;base64,...). Le téléchargement échouera si seule la chaîne encodée brute est fournie.

Paramètres de génération facultatifs

Ces paramètres s'appliquent lorsque type est défini sur generate.

genderstring

Le genre du modèle. Aide le modèle de génération à déterminer les attributs physiques.

bodyTypestring

Le type de corps du modèle (par exemple, "athlétique", "grande taille", "mince").

clothingstring

Détails vestimentaires spécifiques à appliquer pendant la génération, complétant l'invite principale (prompt).

posestring

Description textuelle de la pose (par exemple, "debout mains dans les poches", "marchant").

faceModelIdstring

UUID d'un modèle de visage existant pour verrouiller une identité spécifique à travers les générations. Le résultat s'adaptera à l'invite cible tout en préservant le visage de référence.

Remarque : Fournir une référence de visage ajoute plusieurs secondes au temps de traitement total car l'IA aligne l'identité.

poseModelIdstring

UUID d'un modèle de pose existant. Force la génération à correspondre strictement à la référence pour la pose et la posture du corps.

Remarque : Fournir une référence de pose augmente le temps de traitement.

poseImageBase64string

Chaîne d'image encodée en Base64 à utiliser comme référence de pose ad hoc au lieu de fournir un poseModelId enregistré.

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

Niveau de résolution de sortie. 1k produit une sortie d'environ 1 mégapixel, 2k environ 4 mégapixels et 4k environ 16 mégapixels. Les résolutions plus élevées consomment plus de crédits. Par défaut : 1k

aspectRatiostring

Définit le rapport largeur/hauteur de l'image générée.

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

Par défaut : 3:4

sampleCountinteger

Nombre de variations d'image à générer par requête. 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 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 du niveau de quality de sortie choisi.

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