Authentification

Créez une clé API et envoyez le secret complet comme identifiant porteur (bearer credential). Le secret n’est affiché qu’une seule fois.

Authorization: Bearer fd_live_xxx

Soumettre une tâche d'essayage virtuel

Soumettez une image de vêtement et une image de mannequin. Une requête réussie renvoie le code HTTP 202 avec l’identifiant de la tâche.

curl -X POST \
  "https://www.fashiondiffusion.ai/api/public/v1/virtual-try-on/tasks" \
  -H "Authorization: Bearer fd_live_xxx" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "garmentImageUrl": "https://cdn.example.com/garment.jpg",
    "modelImageUrl": "https://cdn.example.com/model.jpg",
    "imageCount": 1,
    "resolution": "2K",
    "ratio": "3:4",
    "mode": "FAST",
    "prompt": "Keep the garment shape and fabric texture"
  }'

Les deux images doivent être des URL HTTPS publiques, renvoyer un type de contenu image et ne pas dépasser 20 Mo.

Chaque requête acceptée crée et facture une nouvelle tâche. Cette version ne dispose pas de protection contre l’idempotence ; évitez donc de relancer automatiquement une soumission ayant expiré, sauf si des facturations en double sont acceptables.

Interroger une tâche

Utilisez l’identifiant de tâche renvoyé par le point de terminaison de soumission. Une clé API ne peut lire que les tâches appartenant à son utilisateur et à son équipe actuelle.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks/{taskId}"

Les statuts des tâches sont : QUEUED, RUNNING, SUCCEEDED et FAILED. Les URL des images de sortie réussies sont renvoyées dans le champ outputs.

Lister les tâches

Liste les tâches d’essayage virtuel soumises via l’API publique par l’utilisateur actuel. Sont incluses toutes les tâches soumises avec l’une des clés API de cet utilisateur.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks?limit=20&createdAfter=2026-08-01T00%3A00%3A00Z"

limit accepte des valeurs de 1 à 100 et prend par défaut la valeur 20. Utilisez nextCursor comme cursor dans la requête suivante. createdAfter est un horodatage optionnel au format ISO 8601.

Erreurs

Les erreurs utilisent un enveloppe cohérente. L’identifiant de la requête est également renvoyé dans l’en-tête de réponse X-Request-Id.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "garmentImageUrl: Invalid url",
    "requestId": "request-uuid"
  }
}