Ensimmäinen Photta-kuva alle viidessä minuutissa.

1. 1

   Vaihe 1

   Luo API-avain

   Rekisteröidy osoitteessa ai.photta.app ja avaa Developers-hallintapaneeli. Klikkaa Generate API key — tuotantoavaimet alkavat etuliitteellä photta_live_. Vie se ympäristömuuttujaksi, jotta läpikäynnin loppuosa voi lukea sen shellistäsi.

   cURL

   Kopioi

   # https://ai.photta.app → Developers → Generate API key
   export PHOTTA_API_KEY="photta_live_xxxxx"
   export PHOTTA_BASE_URL="https://api.photta.app/api/v1"

2. 2

   Vaihe 2

   Tee POST ensimmäistä try-onia varten

   Tee kutsu endpointiin /api/v1/tryon/apparel tuotekuvan URL-osoitteella ja mallinuken mannequin ID:llä. API vastaa välittömästi 202 Accepted ja palauttaa generation ID:n kentässä data.id.

   cURL

   Kopioi

   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')

3. 3

   Vaihe 3

   Tee pollingia valmistumiseen asti

   Tee GET /api/v1/tryon/apparel/:id 3 sekunnin välein. Tyypillinen valmistumisaika on 1.5–4 minuuttia. Aseta yrityskerroille yläraja, jotta jumiutunut työ ei pysäytä skriptiäsi ikuisesti.

   cURL

   Kopioi

   # $ID is data.id from the POST response. Poll every 3 seconds until status is "completed" or "failed".
   for i in $(seq 1 120); do
     RESULT=$(curl -s "https://api.photta.app/api/v1/tryon/apparel/$ID" -H "Authorization: Bearer $PHOTTA_API_KEY")
     STATUS=$(echo "$RESULT" | jq -r '.data.status')
     [ "$STATUS" = "completed" ] && break
     [ "$STATUS" = "failed" ] && echo "generation failed" && exit 1
     sleep 3
   done
   echo "$RESULT" | jq -r '.data.output_url'

4. 4

   Vaihe 4

   Tallenna lopputulos pysyvästi

   Kun tilaksi vaihtuu completed, data.output_url sisältää renderöidyn kuvan. Lataa tavut omaan tallennustilaasi, jotta tuotteesi ei ole riippuvainen Photta:n CDN:stä renderöinnissä.

   cURL

   Kopioi

   OUTPUT_URL=$(echo "$RESULT" | jq -r '.data.output_url')
   curl -sO "$OUTPUT_URL"
   echo "Saved $(basename "$OUTPUT_URL")"

5. 5

   Vaihe 5

   Käsittele virhetilanteet rehellisesti

   Haarauta logiikka HTTP-tilakoodin mukaan: 402 jos credits ei riitä, 429 rate limit -rajoituksille (noudata Retry-After-otsaketta), 5xx väliaikaisille palvelinvirheille. Jokainen virhevastaus sisältää koneluettavan error.code-kentän, johon voit reagoida koodissa.

   cURL

   Kopioi

   case "$STATUS_CODE" in
     402) echo "insufficient_credits_error — top up before retrying" ;;
     429) echo "rate_limit_error — wait the Retry-After seconds (30 by default)" ;;
     4??) echo "$BODY" | jq '.error.type, .error.message' ;;
     5??) echo "api_error — retry with backoff" ;;
   esac

• Ominaisuudet

  Virtuaalinen try-on (vaatteet)

  Aseta flat-lay-vaate tekoälymallin päälle valitsemallasi ilmeellä ja vartalotyypillä. Neljä tuotetyyppiä, viisi kuvasuhdetta.

  Lue

• Ominaisuudet

  Korujen try-on

  Tarkat lähikuvat kaulakoruista, sormuksista, rannekoruista ja korvakoruista varta vasten luoduilla korumalleilla — heijastukset ja pienet pinnat hallittuina.

  Lue

• Ominaisuudet

  Ghost mannequin

  Poista mallinukke vaatekuvasta ja säilytä sisäpuolen rakenne ehjänä. 3D- tai flat-lay-viimeistely, eräajoyhteensopiva.

  Lue

• Ominaisuudet

  Silmälasistudio

  Silmälasit ja aurinkolasit renderöitynä lähikuvamalleille siten, että kehys vastaa tarkasti tuotekuvaasi.

  Lue

• Ominaisuudet

  Yksityiskohtakuvat

  Lähikuvat ompeleista, kankaasta, metalliosista ja lapuista yhdestä tuotekuvasta; analysaattori ehdottaa kuvattavat kohdat.

  Lue

• Ominaisuudet

  Mallinuken luonti

  Luo omat vaate- tai korumallit valintojen perusteella ja käytä niiden tunnisteita uudelleen jokaisessa try-on-kutsussa.

  Lue

• Ominaisuudet

  Työnkulut

  Aja esimääritetty työnkulku — esimerkiksi korun hero-kuva — yhdellä kutsulla ja saat valmiin kuvasarjan.

  Lue

• Ominaisuudet

  Eräajona suoritettava ghost mannequin

  Lähetä kokonainen rekki vaatekuvia yhdellä kutsulla ja pollaa yhtä batch ID:tä; jokainen kuva hinnoitellaan ja seurataan erikseen.

  Lue

• API

  Photta API

  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.

  Lue

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