Piattaforma AI per la Progettazione Moda per Marchi e Creatori

Autenticazione

Crea una chiave API e invia il segreto completo come credenziale bearer. Il segreto viene visualizzato una sola volta.

Authorization: Bearer fd_live_xxx

Tutti gli endpoint utilizzano JSON e restituiscono un ID richiesta nell'intestazione della risposta.

Prova virtuale

Invia un'immagine dell'indumento e un'immagine del modello. Una richiesta corretta restituisce HTTP 202 con l'ID task.

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": "auto",
    "mode": "FAST",
    "model": "standard",
    "prompt": "Keep the garment shape and fabric texture"
  }'

# Use Base64 instead of URL fields; each image accepts exactly one input form
"garmentImageBase64": "data:image/jpeg;base64,/9j/4AAQSk...",
"modelImageBase64": "data:image/png;base64,iVBORw0KGgo..."

Parametro	Valori supportati	Predefinito
imageCount	1, 2, 4	1
resolution	2K, 4K	2K
ratio	auto, 1:1, 3:4, 4:3, 9:16, 16:9	auto
mode	FAST, REFINE	FAST
model	standard, pro	standard

Ogni immagine può essere un URL HTTPS pubblico o un URL dati Base64. Le immagini JPEG, PNG e WebP non devono superare i 20 MB; l'API memorizza gli input prima di creare il task.

Questa versione non supporta l'idempotenza: ogni richiesta accettata crea un nuovo task e ne addebita il costo. Non ripetere automaticamente un invio scaduto, salvo accettare eventuali addebiti duplicati.

Ritocco selettivo con IA

Sostituisci o ripara un'area selezionata di un'immagine utilizzando un prompt testuale. L'immagine maschera è opzionale; in sua assenza, il provider seleziona l'area modificabile.

curl -X POST \
  "https://www.fashiondiffusion.ai/api/public/v1/ai-inpainting/tasks" \
  -H "Authorization: Bearer fd_live_xxx" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "originalImageUrl": "https://cdn.example.com/source.jpg",
    "prompt": "Replace the jacket with a black leather jacket",
    "model": "standard",
    "resolution": "2K",
    "ratio": "auto"
          }'

// Base64 input (use imageBase64 instead of originalImageUrl)
{
  "imageBase64": "data:image/png;base64,iVBORw0KGgo...",
  "prompt": "Remove the selected object",
  "model": "standard"
}

Parametro	Valori supportati	Predefinito
model	standard, pro	standard
resolution	2K, 4K	2K
ratio	auto, 1:1, 3:4, 4:3, 9:16, 16:9	auto

Fornisci originalImageUrl (o imageBase64) e il prompt. Gli URL dati Base64 devono essere in formato JPEG, PNG o WebP e non superare i 20 MB. Scegli il modello come standard o pro. Utilizza referenceImages per immagini di riferimento opzionali.

La risposta è 202 Accepted con lo stesso oggetto task utilizzato per il Virtual Try-On. Esegui polling sull'endpoint task riportato di seguito per ottenere gli output.

Esegui una query su un task

Utilizza l'ID task restituito dall'endpoint submit. Una chiave API può leggere solo i task di proprietà dell'utente e del team corrente.

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

Gli stati del task sono QUEUED, RUNNING, SUCCEEDED e FAILED. Gli URL delle immagini di output riuscite vengono restituiti nel campo outputs.

Elenca i task

Elenca i task di virtual try-on inviati tramite l'API pubblica dall'utente corrente. Vengono inclusi tutti i task inviati con una qualsiasi delle chiavi API dell'utente.

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

Il parametro limit accetta valori da 1 a 100 e ha valore predefinito pari a 20. Utilizza nextCursor come cursor nella richiesta successiva. createdAfter è un timestamp ISO 8601 opzionale.

Errori

Gli errori utilizzano un envelope coerente. L'ID richiesta viene inoltre restituito nell'intestazione di risposta X-Request-Id.

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