Bekleidung · Funktion
Virtual Try-On API — Photta
Ein einziger REST-Aufruf verwandelt ein Flat-Lay-Produktfoto in ein kampagnentaugliches On-Model-Bild. Asynchron, 1.5–4 Minuten pro Generierung, 5 Credits bei 2K oder 7 Credits bei 4K.
Kurz zusammengefasst
Die Virtual Try-On API von Photta akzeptiert ein Flat-Lay-Produktbild, eine Mannequin-ID sowie eine Pose-ID und liefert ein 2K- oder 4K-On-Model-Foto zurück. Sie authentifizieren sich mit `Authorization: Bearer photta_live_xxx`, senden einen POST an `/api/v1/tryon/apparel`, pollen denselben Endpunkt mit der erhaltenen Generations-ID alle 3–5 Sekunden und laden das Ergebnis herunter, sobald der Status auf `completed` wechselt.
curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["https://example.com/dress.jpg"],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K",
"aspect_ratio": "3:4"
}'Was Sie erwartet
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Aspect ratios
5
Product types
6
Code, End-to-End
Wählen Sie Ihre Sprache
Derselbe Endpunkt, drei ausführbare Anleitungen. Jedes Snippet entspricht der offiziellen Photta-Dokumentation.
Funktionsweise
Vier API-Aufrufe, ein Produktfoto
Wählen Sie ein Mannequin und eine Pose, senden Sie den Job, pollen Sie bis zum Abschluss, laden Sie das Ergebnis herunter.
- 01
Schritt 1
API-Key generieren
Registrieren Sie sich auf ai.photta.app, öffnen Sie den Developers-Tab und klicken Sie auf Generate API key. Live-Keys beginnen mit `photta_live_`. Speichern Sie den Key in `PHOTTA_API_KEY` — niemals committen.
- 02
Schritt 2
Mannequin und Pose wählen
Nutzen Sie GET `/api/v1/mannequins` und `/api/v1/poses`, um verfügbare Optionen aufzulisten. Wählen Sie IDs, die zu Ihrer Marke passen — Körpergröße, Ausdruck, Ethnizität und Pose-Kategorie sind filterbar.
- 03
Schritt 3
Try-On-Job POSTen
Senden Sie einen POST an `/api/v1/tryon/apparel` mit `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. Die API antwortet mit 202 Accepted und einer Generations-ID.
- 04
Schritt 4
Pollen bis zum Abschluss
Fragen Sie GET `/api/v1/tryon/apparel/:id` alle 3 Sekunden ab. Wenn `data.status` auf `completed` springt, enthält die Antwort `output_url` und `thumbnail_url`. Setzen Sie ein Limit für die Versuche, damit ein hängender Job Ihren Request nicht blockiert.
- 05
Schritt 5
Herunterladen und persistieren
Laden Sie die Bytes von `output_url` und speichern Sie diese in Ihrem eigenen Object-Storage. Die CDN-URL ist stabil, aber Ihr Produkt sollte für das Rendering nicht davon abhängig sein.
Fragen anderer Entwickler
Fragen, die Entwickler vor dem Einsatz von Apparel Try-On stellen
Was ist die Virtual Try-On API von Photta?+
Ein REST-Endpunkt, der ein Flat-Lay-Produktbild sowie zwei IDs (Mannequin + Pose) entgegennimmt und ein fotorealistisches On-Model-Bild zurückgibt. Dieselbe Pipeline wie in der Photta Consumer-App. Sechs Produkttypen werden unterstützt: top, bottom, top+bottom, dress, one-piece, jumpsuit.
Was kostet ein Aufruf?+
5 Credits für ein 2K-Ergebnis, 7 Credits für 4K. Credits sind in Ihrem Abo enthalten und können aufgeladen werden. Fehlgeschlagene Generierungen kosten keine Credits — diese werden erstattet.
Wie lange dauert eine Generierung?+
Die Fertigstellung dauert typischerweise 1.5 bis 4 Minuten, End-to-End gemessen. Der POST liefert in unter einer Sekunde eine Generations-ID; die GPU-Arbeit erfolgt im Hintergrund während Ihres Pollings.
Welche Produkttypen werden unterstützt?+
Sechs: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Jeder Typ erwartet eine spezifische Struktur für `product_images` — zum Beispiel benötigt `top_and_bottom` sowohl URLs für `top_image` als auch für `bottom_image`.
Kann ich mein eigenes Mannequin verwenden?+
Ja. Laden Sie ein Mannequin-Foto über `/api/v1/mannequins/upload` hoch oder generieren Sie ein neues KI-Mannequin mit `/api/v1/mannequins/generate-model`. Die erhaltene ID wird direkt im Try-On-Request verwendet.
Wie frage ich das Ergebnis ab (Polling)?+
Senden Sie alle 3 bis 5 Sekunden ein GET an `/api/v1/tryon/apparel/:id`, bis `data.status` entweder `completed` oder `failed` ist. Begrenzen Sie die Versuche — 120 × 3s deckt das dokumentierte Zeitfenster großzügig ab.
Bekleidung · Funktion
Account erstellen und API-Key erhalten
Die Virtual Try-On API von Photta akzeptiert ein Flat-Lay-Produktbild, eine Mannequin-ID sowie eine Pose-ID und liefert ein 2K- oder 4K-On-Model-Foto zurück. Sie authentifizieren sich mit `Authorization: Bearer photta_live_xxx`, senden einen POST an `/api/v1/tryon/apparel`, pollen denselben Endpunkt mit der erhaltenen Generations-ID alle 3–5 Sekunden und laden das Ergebnis herunter, sobald der Status auf `completed` wechselt.