Tøj · Kapabilitet

Virtuel Try-On API — Photta

Ét REST-kald forvandler et flat-lay tøjbillede til et on-model billede klar til kampagner. Asynkron, 1.5–4 minutter pr. generering, 5 credits ved 2K eller 7 credits ved 4K.

Kort fortalt

Phottas virtuelle try-on API accepterer et flat-lay tøjbillede, et mannequin_id og et pose_id, og returnerer derefter et 2K eller 4K on-model foto. Du autentificerer med `Authorization: Bearer photta_live_xxx`, laver en POST til `/api/v1/tryon/apparel`, poller det samme endpoint med det returnerede generations-ID hvert 3–5 sekund, og downloader resultatet, når status skifter til `completed`.

Hent en API-nøgle→Læs dokumentationen

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/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"
  }'

Hvad kan man forvente

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Kode, ende-til-ende

Vælg dit sprog

Samme endpoint, tre køreklare gennemgange. Hver stump matcher den officielle Photta-dokumentation.

SDK

→

Node.js

Native fetch i Node 18+ · Klar til Next.js server actions

SDK

→

Python

requests + en wrapper på 30 linjer · Django / FastAPI / Celery

SDK

→

cURL

To-minutters shell-test · jq-pipelines · nul installation

Sådan virker det

Fire API-kald, ét produktbillede

Vælg en mannequin og en positur, indsend jobbet, polle indtil det er færdigt, download resultatet.

01
Trin 1
Generer en API-nøgle
Opret dig på ai.photta.app, åbn fanen Developers, klik på Generate API key. Live-nøgler starter med `photta_live_`. Læg nøglen i `PHOTTA_API_KEY` — commit den aldrig.
02
Trin 2
Vælg en mannequin og en positur
GET `/api/v1/mannequins` og `/api/v1/poses` for at se tilgængelige muligheder. Vælg ID'er, der matcher dit brand — kropsstørrelse, udtryk, etnicitet og positurkategori kan alle filtreres.
03
Trin 3
POST try-on jobbet
Send en POST til `/api/v1/tryon/apparel` med `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. API'et returnerer 202 Accepted med et generations-ID.
04
Trin 4
Polle indtil jobbet er færdigt
GET `/api/v1/tryon/apparel/:id` hvert 3 sekund. Når `data.status` skifter til `completed`, indeholder payloaden `output_url` og `thumbnail_url`. Sæt en øvre grænse, så et fastlåst job ikke hænger din request.
05
Trin 5
Download og persistér
Hent bytes fra `output_url` og gem dem i din egen object storage. CDN-URL'en er stabil, men dit produkt bør ikke afhænge af den til rendering.

Spørgsmål fra andre udviklere

Spørgsmål udviklere stiller før implementering af try-on til tøj

Hvad er Phottas virtuelle try-on API?+

Et REST-endpoint, der tager et flat-lay produktbillede og et par ID'er (mannequin + positur) og returnerer et fotorealistisk on-model billede. Samme pipeline som Phottas forbruger-app. Seks produkttyper understøttes: top, bottom, top+bottom, dress, one-piece, jumpsuit.

Hvad koster det pr. kald?+

5 credits for et 2K resultat, 7 credits for 4K. Kreditter følger med dit abonnement og kan tankes op. Fejlede genereringer koster ikke kreditter — de refunderes.

Hvor lang tid tager en generering?+

Typisk færdiggørelse er 1.5 til 4 minutter, målt fra start til slut. POST returnerer et generations-ID på under et sekund; GPU-arbejdet sker i baggrunden, mens du poller.

Hvilke produkttyper understøttes?+

Seks: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Hver forventer en forskellig `product_images` struktur — for eksempel vil `top_and_bottom` have både `top_image` og `bottom_image` URL'er.

Kan jeg bruge min egen mannequin?+

Ja. Upload et mannequin-foto til `/api/v1/mannequins/upload` eller generer en ny AI-mannequin med `/api/v1/mannequins/generate-model`. Det returnerede ID kan bruges direkte i try-on requesten.

Hvordan poller jeg for resultatet?+

GET `/api/v1/tryon/apparel/:id` hvert 3 til 5 sekund, indtil `data.status` er `completed` eller `failed`. Sæt en øvre grænse for forsøg — 120 × 3s dækker det dokumenterede vindue med god margin.

Relateret