Snabbstart

Första Photta-bilden på under fem minuter.

Ett enda konto, en API-nyckel, fem kommandon i skalet. Stegen nedan matchar exakt vad den officiella Photta-dokumentationen rekommenderar — inga wrappers, inga SDK:er, inga antaganden om ramverk.

I en mening

Registrera dig på ai.photta.app, klicka på Generate API key, exportera den som PHOTTA_API_KEY, skicka POST till /api/v1/tryon/apparel och polla det returnerade generations-ID:t var 3:e sekund tills status blir completed — vanligtvis inom 1.5 till 4 minuter.

Hämta en API-nyckel→Läs dokumentationen

Så fungerar det

Fem kommandon från noll till första bilden

Klistra in dem i en terminal i tur och ordning. Varje kodsnutt är fristående och använder endast curl + jq.

01
Steg 1
Generera en API-nyckel
Registrera dig på ai.photta.app och öppna instrumentpanelen för utvecklare. Klicka på Generate API key — live-nycklar börjar med photta_live_. Exportera den så att resten av genomgången kan läsa den från ditt skal.
```
# 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:a din första provning

Anropa /api/v1/tryon/apparel med en produkt-URL, ett mannequin_id och ett pose_id. API:et svarar 202 Accepted omedelbart och returnerar ett generations-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

Polla tills det är klart

Anropa GET /api/v1/tryon/apparel/:id var 3:e sekund. Typisk tid för slutförande är 1.5–4 minuter. Sätt en övre gräns för antalet försök så att ett fastnat jobb inte låser ditt skript för evigt.

# 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

04
Steg 4
Spara resultatet
När status blir completed innehåller data.output_url den färdiga bilden. Ladda ner rådatan till din egen lagring så att din produkt inte är beroende av Phottas CDN för rendering.
```
# 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

Hantera fel ärligt

Agera utifrån HTTP-statuskoden: 402 för otillräckliga credits, 429 för rate limits (följ Retry-After), 5xx för tillfälliga serverfel. Varje felmeddelande innehåller en maskinläsbar error.code som du kan agera på.

# 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

Frågor från andra utvecklare

Frågor om att komma igång

Hur lång tid tar snabbstarten?+

Fem minuter för registrering + nyckelgenerering + första cURL. Själva genereringen tar 1.5 till 4 minuter, så räkna med tio minuter totalt innan du ser din första bild på modell.

Behöver jag ett kreditkort för att testa?+

Nya konton startar med testkrediter som du kan använda innan du betalar. När du är redo för produktion kan du prenumerera på en plan för att få ett högre månatligt kreditsaldo och snabbare rate limits.

Vilken slutpunkt ska jag testa först?+

Klädprovning (/api/v1/tryon/apparel) — den är mest använd, dokumentationen är mest komplett och den täcker mönstret med async + polling som alla andra Photta-slutpunkter återanvänder. När du känner dig bekväm där fungerar smycken och ghost mannequin på samma sätt.

Kan jag köra det från webbläsaren?+

Nej. Din API-nyckel måste stanna på serversidan — att skicka den till en webbläsare läcker den till varje besökare. Dirigera anrop via en enkel proxy på din egen backend (Next.js route handler, Express, Flask, Lambda) och låt webbläsaren prata med din proxy istället.

Snabbstart

Du är fem minuter ifrån din första bild

Hämta en API-nyckel →Utforska API:et