Klær · Funksjon

Virtual Try-On API — Photta

Ett REST-kall forvandler et flat-lay-bilde til et kampanjeklart modellbilde. Asynkront, 1.5–4 minutes per generering, 5 credits ved 2K eller 7 credits ved 4K.

Kort fortalt

Phottas API for virtuell prøving tar imot et flat-lay-bilde, en mannequin_id og en pose_id, og returnerer et modellbilde i 2K eller 4K. Du autentiserer med `Authorization: Bearer photta_live_xxx`, sender en POST til `/api/v1/tryon/apparel`, poller samme endepunkt med den returnerte genererings-ID-en hvert 3–5 sekunder, og laster ned resultatet når status blir `completed`.

Hent en API-nøkkel→Les dokumentasjonen

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

Hva du kan forvente

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Kode, ende-til-ende

Velg ditt språk

Samme endepunkt, tre kjørbare gjennomganger. Hvert kodeeksempel samsvarer med den offisielle Photta-dokumentasjonen.

SDK

→

Node.js

Native fetch i Node 18+ · klar for Next.js server actions

SDK

→

Python

requests + en 30-linjers wrapper · Django / FastAPI / Celery

SDK

→

cURL

To-minutters shell-test · jq-pipelines · null installasjon

Slik fungerer det

Fire API-kall, ett produktbilde

Velg en mannequin og en positur, send inn jobben, poll til den er ferdig, last ned resultatet.

01
Steg 1
Generer en API-nøkkel
Registrer deg på ai.photta.app, åpne Developers-fanen, klikk på Generate API key. Live-nøkler starter med `photta_live_`. Legg nøkkelen i `PHOTTA_API_KEY` — aldri sjekk den inn.
02
Steg 2
Velg en mannequin og en positur
Bruk GET `/api/v1/mannequins` og `/api/v1/poses` for å se tilgjengelige valg. Velg ID-er som matcher merkevaren din — kroppsstørrelse, uttrykk, etnisitet og positur-kategorier kan filtreres.
03
Steg 3
POST prøve-jobben
Send en POST til `/api/v1/tryon/apparel` med `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. API-et returnerer 202 Accepted med en genererings-ID.
04
Steg 4
Poll til jobben er ferdig
GET `/api/v1/tryon/apparel/:id` hvert 3 sekunder. Når `data.status` endres til `completed`, inneholder responsen `output_url` og `thumbnail_url`. Sett en øvre grense slik at en fastlåst jobb ikke stopper applikasjonen.
05
Steg 5
Last ned og lagre
Hent bildedata fra `output_url` og lagre dem i din egen lagringsløsning. CDN-URL-en er stabil, men produktet ditt bør ikke være avhengig av den for visning.

Spørsmål andre utviklere stiller

Spørsmål utviklere stiller før de lanserer virtuell prøving

Hva er Phottas API for virtuell prøving?+

Et REST-endepunkt som tar et flat-lay-produktbilde og et par ID-er (mannequin + positur) og returnerer et fotorealistisk modellbilde. Samme teknologi som Phottas forbruker-app. Seks produkttyper støttes: top, bottom, top+bottom, dress, one-piece, jumpsuit.

Hvor mye koster det per kall?+

5 credits for et 2K-resultat, 7 credits for 4K. Credits følger med abonnementet og kan fylles på. Mislykkede genereringer koster ikke credits — de refunderes.

Hvor lang tid tar en generering?+

Typisk fullføring er 1.5 to 4 minutes, målt ende-til-ende. POST returnerer en genererings-ID på under ett sekund; selve GPU-arbeidet skjer i bakgrunnen mens du poller.

Hvilke produkttyper støttes?+

Seks stykker: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Hver forventer en spesifikk `product_images`-struktur — for eksempel krever `top_and_bottom` både `top_image` og `bottom_image` URL-er.

Kan jeg bruke min egen mannequin?+

Ja. Last opp et bilde av en mannequin til `/api/v1/mannequins/upload` eller generer en ny AI-mannequin med `/api/v1/mannequins/generate-model`. Den returnerte ID-en kan brukes direkte i prøve-forespørselen.

Hvordan poller jeg for resultatet?+

GET `/api/v1/tryon/apparel/:id` hvert 3 til 5 sekunder til `data.status` er `completed` eller `failed`. Sett en øvre grense for forsøk — 120 × 3s dekker det dokumenterte vinduet med god margin.

Relatert