Hurtigstart

Første Photta-bilde på under fem minutter.

Én konto, én API-nøkkel, fem terminal-kommandoer. Stegene nedenfor samsvarer nøyaktig med det den offisielle Photta-dokumentasjonen anbefaler — ingen SDK-er eller rammeverkspreferanser.

Kort fortalt

Registrer deg på ai.photta.app, klikk på Generate API key, eksporter den som PHOTTA_API_KEY, send POST til /api/v1/tryon/apparel og poll den returnerte ID-en hvert 3 sekunder til status er completed — vanligvis innen 1.5 to 4 minutes.

Hent en API-nøkkel→Les dokumentasjonen

Slik fungerer det

Fem kommandoer fra null til første bilde

Lim dem inn i terminalen etter tur. Hvert eksempel er selvstendig og bruker kun curl + jq.

01
Steg 1
Generer en API-nøkkel
Registrer deg på ai.photta.app og åpne Developers-dashbordet. Klikk på Generate API key — live-nøkler starter med photta_live_. Eksporter den slik at terminalen din kan lese den.
```
# 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"
```

Steg 2

POST din første prøving

Kall /api/v1/tryon/apparel med en bilde-URL, en mannequin_id og en pose_id. API-et svarer 202 Accepted umiddelbart og returnerer en genererings-ID i 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)

Steg 3

Poll til den er ferdig

Kall /api/v1/tryon/apparel/:id hvert 3 sekunder. Typisk fullføring er 1.5–4 minutes. Sett en øvre grense slik at skriptet ikke henger evig.

# 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

Steg 4

Lagre resultatet

Når status blir completed, inneholder data.output_url det ferdige bildet. Last ned filen til din egen lagring slik at du ikke er avhengig av Phottas CDN.

# 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")"

Steg 5

Håndter feilsituasjoner skikkelig

Sjekk HTTP-statuskoden: 402 for manglende credits, 429 for ratelimits (respekter Retry-After), 5xx for serverfeil. Hver feilmelding inneholder en maskinlesbar error.code.

# 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

Spørsmål andre utviklere stiller

Spørsmål om å komme i gang

Hvor lang tid tar hurtigstarten?+

Fem minutter for registrering, nøkkel og første cURL. Selve genereringen tar 1.5 to 4 minutes, så beregn ca. ti minutter totalt før du ser ditt første modellbilde.

Trenger jeg kredittkort for å prøve?+

Nye kontoer får prøvekreditter du kan bruke med en gang. Når du er klar for produksjon, kan du abonnere på en plan for flere credits og høyere ratelimits.

Hvilket endepunkt bør jeg prøve først?+

Virtuell prøving av klær (/api/v1/tryon/apparel) — det er det mest brukte, har best dokumentasjon og dekker asynkron- og polling-mønsteret som alle andre endepunkter bruker. Når du er trygg der, fungerer smykker og ghost mannequin på samme måte.

Kan jeg kjøre det fra nettleseren?+

Nei. API-nøkkelen din må holdes på serversiden — hvis du bruker den i en nettleser, blir den synlig for alle besøkende. Ruter kallene gjennom en enkel proxy på din egen backend (Next.js route handler, Express, Lambda).