Vaatteet · Ominaisuus

Virtual Try-On API — Photta

Yksi REST-kutsu muuttaa vaatekuvan kampanjalaatuiseksi mallikuvaksi. Asynkroninen, 1.5–4 minuuttia per generointi, 5 krediittiä 2K-resoluutiolla tai 6 krediittiä 4K-resoluutiolla.

Yhdellä lauseella

Phottan virtuaalinen sovitus-API hyväksyy vaatekuvan ja mallitunnuksen, ja palauttaa 2K- tai 4K-mallikuvan. Tunnistautuminen tapahtuu `Authorization: Bearer photta_live_xxx` -otsakkeella, lähetä POST osoitteeseen `/api/v1/tryon/apparel`, pollata päätepistettä palautetulla tunnuksella 3–5 sekunnin välein ja lataa tulos, kun tila on `completed`.

Hanki API-avain→Lue dokumentaatio
POST/api/v1/tryon/apparel
cURL
curl -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "one_piece",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnk_f3a9b1",
    "background_color": "#F5F0E8",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

Mitä odottaa

Typical completion

1.5–4min

2K / 4K credits

5 / 6

Aspect ratios

10

Product types

4

Koodi alusta loppuun

Valitse kieli

Sama päätepiste, kolme suoritettavaa ohjetta. Jokainen koodinpätkä vastaa virallista Photta-dokumentaatiota.

SDK

→

Node.js

Natiivi fetch Node 18+:ssa · Next.js server actions -valmis

SDK

→

Python

requests + 30 rivin kääre · Django / FastAPI / Celery

SDK

→

cURL

Kahden minuutin shell-testi · jq-putket · nolla-asennus

Miten se toimii

Neljä API-kutsua, yksi tuotekuva

Valitse malli, lähetä tehtävä, pollata valmistumiseen asti, lataa tulos.

  1. 01

    Vaihe 1

    Generoi API-avain

    Rekisteröidy osoitteessa ai.photta.app, avaa Developers-välilehti ja klikkaa Generate API key. Live-avaimet alkavat tunnisteella `photta_live_`. Aseta avain muuttujaan `PHOTTA_API_KEY` — älä koskaan tallenna sitä koodiin.

  2. 02

    Vaihe 2

    Valitse malli

    GET `/api/v1/mannequins` listaa vaihtoehdot. Valitse brändillesi sopiva tunnus — koko, ilme ja etnisyys ovat kaikki suodatettavissa.

  3. 03

    Vaihe 3

    Lähetä sovitustehtävä

    Lähetä POST osoitteeseen `/api/v1/tryon/apparel` sisältäen `product_type`, `product_images`, `mannequin_id`, `resolution` ja `aspect_ratio`. API palauttaa 202 Accepted ja generointitunnuksen.

  4. 04

    Vaihe 4

    Pollata valmistumiseen asti

    GET `/api/v1/tryon/apparel/:id` 3 sekunnin välein. Kun `data.status` on `completed`, vastaus sisältää `output_url` ja `thumbnail_url`. Aseta yläraja kokeiluille, jotta jumiutunut tehtävä ei jää roikkumaan.

  5. 05

    Vaihe 5

    Lataa ja tallenna

    Hae tavut osoitteesta `output_url` ja tallenna ne omaan objektitallennustilaasi. CDN-osoite on vakaa, mutta tuotteesi ei pitäisi riippua siitä renderöinnissä.

Muiden kehittäjien kysymyksiä

Kysymyksiä kehittäjiltä ennen sovitus-API:n julkaisua

Mikä on Phottan virtuaalinen sovitus-API?+

REST-päätepiste, joka ottaa tuotekuvan sekä mallitunnuksen ja palauttaa fotorealistisen mallikuvan. Sama putki kuin Phottan kuluttajasovelluksessa. Tuetut tuotetyypit: yläosa, alaosa, ylä+alaosa, yksiosainen.

Paljonko yksi kutsu maksaa?+

5 krediittiä 2K-tuloksesta, 6 krediittiä 4K-tuloksesta. Krediitit kuuluvat tilaukseesi ja niitä voi ostaa lisää. Epäonnistuneet generoinnit eivät maksa krediittejä — ne hyvitetään.

Kauanko generointi kestää?+

Tyypillinen valmistumisaika on 1.5–4 minuuttia alusta loppuun. POST-kutsu palauttaa tunnuksen alle sekunnissa; GPU-työ tapahtuu taustalla kyselyiden aikana.

Mitä tuotetyyppejä tuetaan?+

Neljä: `top`, `bottom`, `top_and_bottom`, `one_piece`. Jokainen odottaa tiettyä `product_images`-muotoa — esimerkiksi `top_and_bottom` vaatii sekä `top_image`- että `bottom_image`-osoitteet.

Voinko käyttää omaa malliani?+

Kyllä. Lataa mallikuva osoitteeseen `/api/v1/mannequins/upload` tai generoi uusi AI-malli kutsulla `/api/v1/mannequins/generate-model`. Palautettu ID toimii suoraan sovituspyynnössä.

Miten kysyn tulosta?+

GET `/api/v1/tryon/apparel/:id` 3–5 sekunnin välein, kunnes `data.status` on `completed` tai `failed`. Aseta yläraja yrityksille — 120 × 3s kattaa dokumentoidun ikkunan reilusti.

Aiheeseen liittyvää

Liittyvät ominaisuudet

/api/jewelry-try-on-api

jewelry-try-on

5–6 credits · ~3 min

View capability →

/api/ghost-mannequin-api

ghost-mannequin

4–5 credits · ~2 min

View capability →

Vaatteet · Ominaisuus

Luo tili ja hanki API-avain

Phottan virtuaalinen sovitus-API hyväksyy vaatekuvan ja mallitunnuksen, ja palauttaa 2K- tai 4K-mallikuvan. Tunnistautuminen tapahtuu `Authorization: Bearer photta_live_xxx` -otsakkeella, lähetä POST osoitteeseen `/api/v1/tryon/apparel`, pollata päätepistettä palautetulla tunnuksella 3–5 sekunnin välein ja lataa tulos, kun tila on `completed`.

Hanki API-avain →Katso hinnoittelu
Virtual Try-On API vaatteille | Photta | Photta