Photta API

Photta API virtuaalinen try-on, ghost mannequin ja tuotekuvaus RESTin kautta

Yhdellä lauseella

Photta API on credits-pohjainen REST API: tee POST tuotekuvasta kyvykkyyden endpointiin, tee polling sen tila-endpointiin muutaman sekunnin välein ja lataa valmis kuva. Kahdeksan kyvykkyyttä, yksi avain, yksi credits-saldo.

  • Ominaisuudet: 8 ominaisuutta
  • Rate limit: 600 pyyntöä/min
  • Autentikointi: Bearer-avain
  • Malli: asynkroninen, polling

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Ominaisuudet

Jokainen endpoint kyvykkyyksittäin

Metodi, polku, credits ja tyypillinen aika suoraan API-dokumentaatiosta. Tämän sivun tiedot on tarkistettu dokumentaatiota vasten alareunassa näkyvänä päivämääränä.

Pikaopas

Rekisteröitymisestä ensimmäiseen kuvaan viidessä minuutissa.

Jokainen kyvykkyys noudattaa samaa kaavaa: todenna, lähetä, tee polling. Opi se kerran.

  1. Vaihe 1: Rekisteröidy osoitteessa ai.photta.app ja luo live-API-avain Developers-hallintapaneelista.

  2. Vaihe 2: Tee POST työstä avaimesi ollessa Authorization-otsakkeessa — API palauttaa generointi-ID:n välittömästi.

  3. Vaihe 3: Tee polling samaan endpointiin 3 sekunnin välein, kunnes tilaksi vaihtuu completed, ja lataa sitten tuloksen URL.

Pikaopas

Kysymykset

Asioita, joita kehittäjät kysyvät ennen rekisteröitymistä

Mikä on Photta API?

Phottan API on credits-pohjainen REST-palvelu, joka generoi ammattitasoista muotikuvausta tuotekuvistasi. Se on sama putki, joka pyörittää Phottan kuluttajasovelluksia — virtuaalinen vaatteiden try-on, korujen try-on ja ghost mannequin -erotus — tuotuna kehittäjille kahdeksana kyvykkyytenä omien työkalujen rakentamiseen.

Miten saan API-avaimen?

Rekisteröidy osoitteessa ai.photta.app, avaa hallintapaneelin Developers-osio ja klikkaa Generate API key. Live-avaimesi alkaa merkkijonolla `photta_live_`, jota seuraa 32 heksadesimaalimerkkiä. Säilytä se ympäristömuuttujassa — älä koskaan commitoi sitä versionhallintaan äläkä toimita sitä selaimeen.

Onko saatavilla ilmaisversiota?

Uudet tilit saavat kokeilu-credits-saldoa, jota voit käyttää mihin tahansa kyvykkyyteen. Kun olet valmis tuotantoon, tilaa paketti, jossa on suurempi kuukausittainen credits-saldo. Rate limit on sama kaikissa paketeissa: 600 pyyntöä minuutissa per API-avain. Ei kutsukohtaisia vähimmäismääriä.

Kuinka nopeaa generointi on?

Try-on- ja ghost mannequin -työt valmistuvat tyypillisesti 1.5–4 minuutissa; silmälasikuvat, yksityiskohtakuvat ja työnkulkukuvat 20–60 sekunnissa; mallinuken generointi 30–60 sekunnissa. Jokainen generointi-endpoint on asynkroninen: POST palauttaa generointi-ID:n heti, ja teet pollingia 3–5 sekunnin välein, kunnes työ valmistuu. Avoinna pidettävää HTTP-yhteyttä ei tarvitse hallita.

Onko virallista Photta SDK:ta olemassa?

Ei vielä. Tuettu integraatiotapa on suora REST cURLin, Noden natiivin fetchin tai Pythonin requests-kirjaston kautta — kaikki kolme on dokumentoitu alusta loppuun tällä sivustolla jokaiselle kyvykkyydelle.

Referenssi

Dokumentaation osat, jotka avaat useammin kuin kerran.

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu

Kokeile APIa viidessä minuutissa

Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.

  • 8 ominaisuutta
  • 600 pyyntöä/min
  • Bearer-avain
  • asynkroninen, polling