Kläder · Funktionalitet

Virtual Try-On API — Photta

Ett REST-anrop förvandlar ett flat-lay-foto av ett plagg till en kampanjredo bild på modell. Asynkront, 1.5–4 minuter per generering, 5 credits vid 2K eller 7 credits vid 4K.

I en mening

Phottas API för virtuell provning accepterar en flat-lay-bild på ett plagg, ett mannequin_id och ett pose_id, och returnerar sedan ett 2K- eller 4K-foto på modell. Du autentiserar med Authorization: Bearer photta_live_xxx, skickar POST till /api/v1/tryon/apparel, pollar samma slutpunkt med det returnerade generations-ID:t var 3–5 sekund och laddar ner resultatet när status blir completed.

Hämta en API-nyckel→Läs dokumentationen

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

Vad du kan förvänta dig

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Kod, hela vägen

Välj språk

Samma slutpunkt, tre körbara genomgångar. Varje kodsnutt matchar Phottas officiella dokumentation.

SDK

→

Node.js

Inbyggd fetch i Node 18+ · Redo för Next.js server actions

SDK

→

Python

requests + en wrapper på 30 rader · Django / FastAPI / Celery

SDK

→

cURL

Två minuters shell-test · jq-pipelines · ingen installation krävs

Så fungerar det

Fyra API-anrop, ett produktfoto

Välj en modell och en pose, skicka jobbet, polla tills det är klart, ladda ner resultatet.

01
Steg 1
Generera en API-nyckel
Registrera dig på ai.photta.app, öppna fliken för utvecklare, klicka på Generate API key. Live-nycklar börjar med photta_live_. Spara nyckeln i PHOTTA_API_KEY — checka aldrig in den.
02
Steg 2
Välj en modell och en pose
Använd GET /api/v1/mannequins och /api/v1/poses för att lista tillgängliga alternativ. Välj ID:n som matchar ditt varumärke — kroppsstorlek, uttryck, etnicitet och pose-kategori är alla filtrerbara.
03
Steg 3
POST:a provningsjobbet
Skicka en POST till /api/v1/tryon/apparel med product_type, product_images, mannequin_id, pose_id, resolution, aspect_ratio. API:et returnerar 202 Accepted med ett generations-ID.
04
Steg 4
Polla tills jobbet är klart
Använd GET /api/v1/tryon/apparel/:id var 3:e sekund. När data.status blir completed innehåller svaret output_url och thumbnail_url. Sätt en övre gräns så att ett fastnat jobb inte låser din förfrågan.
05
Steg 5
Ladda ner och spara
Hämta rådatan från output_url och spara den i din egen lagring. CDN-URL:en är stabil, men din produkt bör inte vara beroende av den för rendering.

Frågor från andra utvecklare

Frågor utvecklare ställer innan de lanserar virtuell provning

Vad är Phottas API för virtuell provning?+

En REST-slutpunkt som tar en flat-lay-produktbild och ett par ID:n (modell + pose) och returnerar en fotorealistisk bild på modell. Samma pipeline som Phottas konsumentapp. Sex produkttyper stöds: top, bottom, top+bottom, dress, one-piece, jumpsuit.

Vad kostar det per anrop?+

5 credits för ett 2K-resultat, 7 credits för 4K. Credits ingår i din prenumeration och kan fyllas på. Misslyckade genereringar kostar inga credits — de återbetalas.

Hur lång tid tar en generering?+

En typisk generering tar 1.5 till 4 minuter, mätt från början till slut. POST-anropet returnerar ett generations-ID på under en sekund; GPU-arbetet sker i bakgrunden medan du pollar.

Vilka produkttyper stöds?+

Sex stycken: top, bottom, top_and_bottom, dress, one_piece, jumpsuit. Varje typ förväntar sig olika format på product_images — till exempel vill top_and_bottom ha URL:er för både top_image och bottom_image.

Kan jag använda min egen modell?+

Ja. Ladda upp ett foto på en modell till /api/v1/mannequins/upload eller generera en ny AI-modell med /api/v1/mannequins/generate-model. Det returnerade ID:t används direkt i provningsförfrågan.

Hur pollar jag efter resultatet?+

Använd GET /api/v1/tryon/apparel/:id var 3:e till 5:e sekund tills data.status är completed eller failed. Sätt en övre gräns för antalet försök — 120 × 3s täcker det dokumenterade fönstret med god marginal.

Relaterat