Pikaopas

Ensimmäinen Photta-kuva alle viidessä minuutissa.

Yksi tili, yksi API-avain, viisi komentorivikäskyä. Alla olevat vaiheet vastaavat täsmälleen virallista Photta-dokumentaatiota ilman oletuksia kehitysympäristöstä.

Yhdellä lauseella

Rekisteröidy osoitteessa ai.photta.app, generoi API-avain, aseta se ympäristömuuttujaksi, lähetä POST-pyyntö osoitteeseen /api/v1/tryon/apparel ja pollata palautettua tunnusta 3 sekunnin välein valmistumiseen asti.

Hanki API-avain→Lue dokumentaatio

Miten se toimii

Viisi komentoa nollasta ensimmäiseen kuvaan

Liitä ne terminaaliin järjestyksessä. Jokainen pätkä on itsenäinen ja käyttää vain curl- ja jq-työkaluja.

Vaihe 1

Generoi API-avain

Rekisteröidy osoitteessa ai.photta.app ja avaa Developers-hallintapaneeli. Klikkaa Generate API key — live-avaimet alkavat photta_live_. Aseta se muuttujaksi.

# Sign up at ai.photta.app, open the Developers dashboard,
# click "Generate API key" and copy it into your env.
export PHOTTA_API_KEY="photta_live_xxxxx"
export PHOTTA_BASE_URL="https://ai.photta.app/api/v1"

Vaihe 2

Lähetä ensimmäinen sovitus

Kutsu /api/v1/tryon/apparel tuotekuvan URL-osoitteella, mallitunnuksella ja asentotunnuksella. API vastaa 202 Accepted välittömästi ja palauttaa tunnuksen kohdassa data.id.

curl -X POST "$PHOTTA_BASE_URL/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"
  }'
# Response: 202 Accepted + data.id (generation ID)

Vaihe 3

Pollata valmistumiseen asti

GET /api/v1/tryon/apparel/:id 3 sekunnin välein. Tyypillinen aika on 1.5–4 minuuttia. Aseta yrityksille yläraja skriptin jumittumisen estämiseksi.

# Loop every 3 seconds until status flips to "completed".
# Typical completion: 1.5–4 minutes. Max 120 attempts = 6 min.
for i in $(seq 1 120); do
  RESULT=$(curl -s "$PHOTTA_BASE_URL/tryon/apparel/$ID" \
    -H "Authorization: Bearer $PHOTTA_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.data.status')
  [ "$STATUS" = "completed" ] && break
  [ "$STATUS" = "failed" ] && echo "Job failed" && exit 1
  sleep 3
done

Vaihe 4

Tallenna lopputulos

Kun tila on completed, data.output_url sisältää generoidun kuvan. Lataa se omaan tallennustilaasi.

# Pull the final URL out of the response and save the bytes.
OUTPUT_URL=$(echo "$RESULT" | jq -r '.data.output_url')
curl -sO "$OUTPUT_URL"
echo "Saved $(basename "$OUTPUT_URL")"

Vaihe 5

Käsittele virhetilat rehellisesti

Haaraudu HTTP-tilakoodin mukaan: 402 (krediitit), 429 (nopeusrajoitus), 5xx (palvelinvirhe). Jokainen virherunko sisältää koneluettavan error.code-kentän.

# Surface the common failure modes honestly.
case "$STATUS_CODE" in
  402) echo "Out of credits — top up at ai.photta.app" ;;
  429) echo "Rate limited — honour Retry-After header" ;;
  4??) echo "Client error: $(echo "$BODY" | jq '.error.message')" ;;
  5??) echo "Server error — retry with backoff" ;;
esac

Muiden kehittäjien kysymyksiä

Kysymyksiä aloittamisesta

Kauanko pikaopas vie aikaa?+

Viisi minuuttia rekisteröitymiseen ja ensimmäiseen kutsuun. Generointi vie 1.5–4 minuuttia, joten varaa kymmenen minuuttia ennen kuin näet tuloksen.

Tarvitsenko luottokorttia kokeiluun?+

Uudet tilit sisältävät kokeilukrediittejä. Kun olet valmis tuotantoon, voit tilata paketin saadaksesi enemmän krediittejä ja korkeammat nopeusrajoitukset.

Mitä päätepistettä kannattaa kokeilla ensin?+

Vaatesovitusta (/api/v1/tryon/apparel) — se on käytetyin, parhaiten dokumentoitu ja kattaa saman asynkronisen mallin kuin muutkin Phottan päätepisteet.

Voinko käyttää tätä selaimesta?+

Et. API-avaimesi on pysyttävä palvelimella — sen lähettäminen selaimeen paljastaa sen kaikille vierailijoille. Kierrätä kutsut oman taustajärjestelmäsi kautta.

Pikaopas

Olet viiden minuutin päässä ensimmäisestä kuvastasi

Hanki API-avain →Tutki API:a