Guide · Virtual Try-On

Was ist eine Virtual-Try-On-API? und was sie zurückgibt

In aller Kürze

Eine Virtual-Try-On-API nimmt ein Kleidungsfoto entgegen und liefert ein Bild dieses Kleidungsstücks zurück, getragen von einem Model. Sie senden das Foto per POST zusammen mit Mannequin und Pose, führen Polling für den Job durch und laden das Ergebnis herunter.

API-Key anfordernDokumentation lesen
  • Typische Dauer: 1.5–4 min
  • Credits: 5 Credits bei 2K · 6 Credits bei 4K
  • Verarbeitung: asynchron, Polling

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft

Die kurze Antwort

Eine Virtual-Try-on-API ist ein HTTP-Endpoint, der ein Kleidungsstück auf einem Model rendert. Sie senden ein Foto des Produkts — üblicherweise die bereits vorhandene Flat-Lay- oder Mannequin-Aufnahme — und der Dienst liefert ein Bild dieses getragenen Kleidungsstücks zurück. Kein Studio, kein Model-Booking, kein Nachshooting bei neuen Farbvarianten.

Der Aufruf erfolgt asynchron, da das Rendering länger dauert, als ein Request warten sollte. Sie senden das Kleidungsstück per POST zusammen mit dem gewünschten Model und der Pose, die API nimmt den Job an und liefert eine id zurück, und Sie führen Polling auf einem Status-Endpoint durch, bis der Job als abgeschlossen gemeldet wird. Das fertige Bild wird als URL bereitgestellt, die Sie selbst herunterladen und speichern.

Typische Caller sind Katalogteams, die Model-Aufnahmen für Produkte benötigen, die nie ein Studio erreichen, Marktplätze, die Flat-Lay-Fotos von Händlern erhalten, und Apps, mit denen Shopper ein Kleidungsstück an einem anderen Körper als dem einzelnen Fit-Model der Marke sehen können.

Der Endpoint, der dies ausführt

Aus der Photta-API-Dokumentation generiert, nicht von Hand geschrieben.

Auf einen Blick

Endpoint
POST /api/v1/tryon/apparel
Authentifizierung
Bearer-API-Schlüssel
Verarbeitung
Asynchron — Polling über den Status-Endpoint
Typische Dauer
1.5–4 min
Credits
5 Credits bei 2K · 6 Credits bei 4K
Seitenverhältnisse
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Eingabelimits
Bis zu 10 MB pro Bild; JPEG, PNG, WebP
Idempotent
Nein

Worauf Sie bei jeder Try-On-API achten sollten

  • Was Sie senden

    Ein Produktfoto als https-URL oder Base64-Data-URI sowie das gewünschte Model und die Pose. Photta akzeptiert JPEG, PNG und WebP bis zu 10 MB pro Bild.

  • Wie lange es dauert

    Länger, als innerhalb eines Web-Requests möglich wäre. Photta veröffentlicht eine typische Ausführungszeit pro Endpoint und erwartet Polling alle 3 Sekunden — es gibt keine Webhooks.

  • Was es kostet

    Photta rechnet in credits pro Aufruf ab: 5 bei 2K und 6 bei 4K für Apparel-Try-on, abgebucht beim Jobstart und automatisch erstattet bei Fehlern.

  • Welche Limits gelten

    Ein veröffentlichtes Rate Limit von 600 Requests pro Minute pro Key und ein tarifabhängiges Limit für parallele Renderings. Beides sollte vor einem Durchlauf im Katalogmaßstab geprüft werden.

Der erste Request

Derselbe Aufruf in cURL, Node.js und Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Fragen zu Virtual-Try-On-APIs

Was liefert eine Try-on-API zurück?

Ein Bild des Kleidungsstücks am gewählten Model, bereitgestellt als URL im abgeschlossenen Job. Laden Sie es herunter und speichern Sie es — eine Delivery-URL ist kein permanentes Hosting.

Brauche ich ein Foto eines Models?

Nein. Photta stellt einen Mannequin-Katalog zur Auswahl bereit, und Sie können über Attribute ein eigenes Model generieren oder eines hochladen. Das Produktfoto des Kleidungsstücks ist das einzige Bild, das Sie bereitstellen müssen.

Wie unterscheidet sich das von einer virtuellen Umkleidekabine?

Eine Umkleidekabine ist ein kundenorientiertes Feature. Eine Try-on-API ist der zugrundeliegende Render-Schritt: ein Call rein, ein Bild raus. Sie können darauf eine Umkleidekabine aufbauen oder sie rein zur Erstellung von Katalogfotos nutzen.

Was kostet ein Try-on-Aufruf?

Bei Photta 5 credits bei 2K und 6 bei 4K. Fehlgeschlagene Jobs werden erstattet, die Kosten eines Retrys entsprechen also nur dem Retry selbst.

Wie lange dauert ein Bild?

Der Endpoint gibt seine typische Ausführungszeit an, und der Job meldet seinen eigenen Status. Führen Sie alle 3 Sekunden Polling durch, anstatt eine feste Dauer anzunehmen.

Weiterlesen

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft

Mit einem eigenen Produktfoto testen

Ein Request, ein Polling, ein Bild.

Konto erstellen und API-Key anfordernZum Endpoint
  • 1.5–4 min
  • 5 Credits bei 2K · 6 Credits bei 4K
  • asynchron, Polling