Authentifizierung

Erstellen Sie einen API-Schlüssel und senden Sie das vollständige Geheimnis als Bearer-Anmeldeinformation. Das Geheimnis wird nur einmal angezeigt.

Authorization: Bearer fd_live_xxx

Eine Aufgabe für virtuelles Anprobieren übermitteln

Übermitteln Sie ein Bekleidungsbild und ein Modellbild. Eine erfolgreiche Anfrage gibt HTTP 202 mit der Aufgaben-ID zurück.

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"
  }'

Beide Bilder müssen öffentliche HTTPS-URLs sein, einen Bild-Inhaltstyp zurückgeben und nicht größer als 20 MB sein.

Jede akzeptierte Anfrage erstellt und berechnet eine neue Aufgabe. Diese Version bietet keinen Idempotenzschutz; wiederholen Sie daher eine Zeitüberschreitungsanfrage nicht automatisch, es sei denn, doppelte Berechnungen sind akzeptabel.

Eine Aufgabe abfragen

Verwenden Sie die Aufgaben-ID, die vom Submit-Endpunkt zurückgegeben wurde. Ein API-Schlüssel kann nur Aufgaben lesen, die dem jeweiligen Benutzer und dem aktuellen Team gehören.

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

Aufgabenstatus sind QUEUED, RUNNING, SUCCEEDED und FAILED. Erfolgreiche Ausgabebild-URLs werden in outputs zurückgegeben.

Aufgaben auflisten

Listet virtuelle Anprobe-Aufgaben auf, die vom aktuellen Benutzer über die öffentliche API eingereicht wurden. Dazu zählen Aufgaben, die mit einem beliebigen API-Schlüssel des Benutzers eingereicht wurden.

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

limit akzeptiert Werte von 1 bis 100 und hat den Standardwert 20. Verwenden Sie nextCursor als cursor in der nächsten Anfrage. createdAfter ist ein optionaler ISO 8601-Zeitstempel.

Fehler

Fehler verwenden ein konsistentes Envelope-Format. Die Request-ID wird zudem im Antwort-Header X-Request-Id zurückgegeben.

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