Logo

Virtuelle Anprobe

Tauschen Sie Kleidungsstücke nahtlos auf KI-Modellen aus, indem Sie Bildreferenzen verwenden.

Virtuelle Anprobe (Bild-Anprobe)

Der Anprobe-Endpunkt ermöglicht es Ihnen, ein Kleidungsstück nahtlos an einer Person anzupassen, indem Sie eine Bildreferenz verwenden.

Modellname: tryon

Lebenszyklus: stable

Verarbeitungszeit: ~15s–30s

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL (via Polling)

Credits: 1 × sampleCount

Anfrage

Senden Sie Ihre Anprobe-Konfiguration an den universellen Endpunkt /v1/run unter Verwendung einer JSON-Nutzlast.

POSThttps://fititon.app/api/v1/run

Anfragebeispiele

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

Antwort

Die Generierung der virtuellen Anprobe erfolgt asynchron im Hintergrund. Ihre Anfrage gibt sofort einen 200 OK-Status mit einem Tracking-Objekt zurück.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Abrufen der Ergebnisse Sie müssen die zurückgegebene id verwenden, um den Status-Endpunkt (GET https://fititon.app/api/v1/status/{id}) abzufragen und Ihre generierten Bild-URLs abzurufen. Detaillierte Anweisungen finden Sie im API-Setup-Leitfaden.

Anfrageparameter

Erforderliche Parameter

personImageRequiredstring

Das Basisbild des Modells, das Sie anziehen möchten. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein. Unterstützte Formate: JPEG, PNG, WEBP. Max. Größe: 25MB.

Profi-Tipp: Frontale Posen mit sichtbaren Armen erzeugen die realistischste Drapierung. Entfernen Sie Taschen, Schals oder Jacken, die den Körper bedecken, vor dem Shooting.

Formatierungsanforderung Beim Übermitteln eines Base64-Strings muss dieser das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,...). Der Endpunkt /v1/run akzeptiert nur JSON-Nutzlasten, daher werden multipart/form-data-Uploads nicht unterstützt.

garmentImageRequiredstring

Das Bild des Kleidungsstücks, das anprobiert werden soll. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein.

Profi-Tipp: Flach liegende Kleidungsfotos auf weißem Hintergrund funktionieren merklich besser als Aufnahmen auf Kleiderbügeln oder zerknitterte Kleidung.

Optionale Parameter

accuracy'standard' | 'high' | 'hyper'

Definiert die Genauigkeit der Anprobe-Passform. Eine höhere Genauigkeit erhöht die Generierungspräzision, kann aber etwas länger dauern. Standard: standard

sampleCountinteger

Anzahl der zu generierenden Bildvarianten pro Anfrage. Muss zwischen 1 und 4 liegen. Zusätzliche Bilder verbrauchen mehr Credits und erhöhen die Verarbeitungszeit linear. Standard: 1

Laufzeitfehler

Laufzeitfehler für diese Funktion verwenden den gemeinsamen Satz, der in der Fehlerbehandlung dokumentiert ist. Tritt während der Verarbeitung ein Fehler auf, wird der status auf "error" aktualisiert und das Feld error enthält den spezifischen Fehlergrund.

Kosten für Credits

Für Developer API-Anfragen arbeitet der Endpunkt für virtuelle Anproben mit einem Pauschalsatz von 1 Credit pro generiertem Bild, unabhängig von der angeforderten quality-Stufe.

Formel: Kosten = 1 × sampleCount

ParameterCredits pro Bild
Pauschalsatz1