Kleding · Mogelijkheid

Virtual Try-On API — Photta

Eén REST-call verandert een flat-lay kledingfoto in een campagne-waardige afbeelding op een model. Asynchroon, 1.5–4 minuten per generatie, 5 credits bij 2K of 7 credits bij 4K.

In één zin

Photta's Virtual Try-On API accepteert een flat-lay kledingfoto, een mannequin_id en een pose_id, en retourneert vervolgens een 2K of 4K foto op een model. Je authenticeert met `Authorization: Bearer photta_live_xxx`, doet een POST naar `/api/v1/tryon/apparel`, pollt hetzelfde endpoint met het geretourneerde generatie-ID elke 3–5 seconden en downloadt het resultaat wanneer status verspringt naar `completed`.

Ontvang een API-sleutel→Lees de documentatie

POST/api/v1/tryon/apparel

cURL

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

Wat je kunt verwachten

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Code, van begin tot eind

Kies je taal

Hetzelfde endpoint, drie uitvoerbare handleidingen. Elk fragment komt overeen met de officiële Photta-documentatie.

SDK

→

Node.js

Native fetch in Node 18+ · klaar voor Next.js server actions

SDK

→

Python

requests + een wrapper van 30 regels · Django / FastAPI / Celery

SDK

→

cURL

Shell-test van twee minuten · jq-pipelines · geen installatie nodig

Hoe het werkt

Vier API-calls, één productfoto

Kies een mannequin en een pose, dien de taak in, poll tot het klaar is, download het resultaat.

01
Stap 1
Genereer een API-sleutel
Meld je aan op ai.photta.app, open het Developers-tabblad en klik op Generate API key. Live sleutels beginnen met `photta_live_`. Zet de sleutel in `PHOTTA_API_KEY` — voeg deze nooit toe aan je code.
02
Stap 2
Kies een mannequin en een pose
Gebruik GET `/api/v1/mannequins` en `/api/v1/poses` om beschikbare opties op te vragen. Kies ID's die bij je merk passen — lichaamsbouw, expressie, etniciteit en pose-categorie zijn allemaal filterbaar.
03
Stap 3
POST de try-on taak
Stuur een POST naar `/api/v1/tryon/apparel` met `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution` en `aspect_ratio`. De API retourneert 202 Accepted met een generatie-ID.
04
Stap 4
Poll tot de taak voltooid is
Gebruik GET `/api/v1/tryon/apparel/:id` elke 3 seconden. Wanneer `data.status` verspringt naar `completed`, bevat de payload `output_url` en `thumbnail_url`. Stel een limiet in zodat een vastgelopen taak je verzoek niet blokkeert.
05
Stap 5
Downloaden en opslaan
Haal de bytes op van `output_url` en sla ze op in je eigen object storage. De CDN-URL is stabiel, maar je product moet er niet afhankelijk van zijn voor de weergave.

Vragen die andere developers stellen

Vragen die developers stellen voordat ze kleding try-on lanceren

Wat is de Photta Virtual Try-On API?+

Een REST-endpoint dat een flat-lay productfoto en een paar ID's (mannequin + pose) ontvangt en een fotorealistische afbeelding op een model retourneert. Dezelfde pipeline als de consumenten-app van Photta. Zes producttypes worden ondersteund: top, bottom, top+bottom, dress, one-piece, jumpsuit.

Hoeveel kost het per call?+

5 credits voor een 2K-resultaat, 7 credits voor 4K. Credits zijn inbegrepen bij je abonnement en kunnen worden aangevuld. Mislukte generaties kosten geen credits — deze worden teruggestort.

Hoe lang duurt een generatie?+

De typische voltooiingstijd is 1.5 tot 4 minuten, van begin tot eind gemeten. De POST retourneert een generatie-ID in minder dan een seconde; het GPU-werk gebeurt op de achtergrond terwijl je pollt.

Welke producttypes worden ondersteund?+

Zes: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Elk type verwacht een andere structuur voor `product_images` — `top_and_bottom` vereist bijvoorbeeld zowel `top_image` als `bottom_image` URL's.

Kan ik mijn eigen mannequin gebruiken?+

Ja. Upload een mannequin-foto naar `/api/v1/mannequins/upload` of genereer een nieuwe AI-mannequin met `/api/v1/mannequins/generate-model`. Het geretourneerde ID kan direct in het try-on verzoek worden gebruikt.

Hoe poll ik voor het resultaat?+

Gebruik GET `/api/v1/tryon/apparel/:id` elke 3 tot 5 seconden totdat `data.status` op `completed` of `failed` staat. Stel een maximum aantal pogingen in — 120 × 3s dekt de gedocumenteerde periode met voldoende marge.

Gerelateerd