Guide · Virtuel try-on

Hvad er et virtuelt try-on-API? og hvad det returnerer

I én sætning

Et virtuelt try-on-API tager et fotografi af en beklædningsgenstand og returnerer et billede af tøjet båret af en model. Du sender et POST-request med billedet sammen med en mannequin og en positur, poller jobbet og downloader derefter resultatet.

Hent en API-nøgleLæs dokumentationen
  • Typisk tid: 1.5–4 min
  • Credits: 5 credits ved 2K · 6 credits ved 4K
  • Behandling: async, polling

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket

Det korte svar

Et virtuelt try-on-API er et HTTP-endpoint, der renderer en beklædningsgenstand over på en model. Du sender et fotografi af produktet — typisk det flat-lay- eller ginebillede, du allerede har — og tjenesten returnerer et billede af tøjet båret af en model. Intet studie, ingen modelbooking, ingen genoptagelser, når farvevarianten ændrer sig.

Kaldet er asynkront, fordi rendering tager længere tid, end en anmodning bør vente. Du foretager et POST-kald med beklædningsgenstanden samt den ønskede model og positur, API'et accepterer jobbet og returnerer et id, og du poller et status-endpoint, indtil jobbet melder, at det er færdigt. Det færdige billede leveres som en URL, du selv downloader og gemmer.

De typiske brugere er katalogteams, der har brug for on-model-billeder til produkter, der aldrig rammer et studie, markedspladser, der modtager flade fotografier fra sælgere, og apps, der lader kunden se tøjet på en anden kropstype end brandets faste fitting-model.

Endpointet, der udfører det

Aflæst fra Phottas API-dokumentation, ikke skrevet i hånden.

Kort fortalt

Endpoint
POST /api/v1/tryon/apparel
Autentifikation
Bearer API-nøgle
Behandling
Asynkron — poll status-endpointet
Typisk tid
1.5–4 min
Credits
5 credits ved 2K · 6 credits ved 4K
Billedformater
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Inputgrænser
Op til 10 MB pr. billede; JPEG, PNG, WebP
Idempotent
Nej

Hvad du skal kigge efter i ethvert try-on-API

  • Hvad du sender

    Et fotografi af beklædningsgenstanden som en https-URL eller en base64-data-URI samt den ønskede model og positur. Photta understøtter JPEG, PNG og WebP op til 10 MB pr. billede.

  • Hvor lang tid det tager

    Længe nok til, at det ikke kan klares i en enkelt webrequest. Photta oplyser en typisk behandlingstid pr. endpoint og forventer polling hvert 3. sekund — der er ingen webhooks.

  • Hvad det koster

    Photta afregner i credits pr. kald: 5 ved 2K og 6 ved 4K for apparel try-on, som trækkes, når jobbet starter, og automatisk refunderes, hvis det fejler.

  • Hvilke grænser der gælder

    En officiel rate limit på 600 anmodninger i minuttet pr. nøgle samt et abonnementsspecifikt loft over, hvor meget der kan renderes samtidigt. Begge dele er værd at læse før et kørsel i katalogstørrelse.

Det første request

Det samme kald i cURL, Node.js og Python.

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

Spørgsmål om virtuelle try-on-API'er

Hvad returnerer et try-on-API?

Et billede af tøjet båret af den model, du valgte, leveret som en URL i det afsluttede job. Download og gem det — en leverings-URL er ikke permanent hosting.

Behøver jeg et billede af en model?

Nej. Photta leveres med et ginekatalog, du kan vælge fra, og du kan generere din egen model ud fra attributter eller uploade en. Beklædningsfotografiet er det eneste billede, du behøver levere.

Hvordan adskiller dette sig fra et virtuelt prøverum?

Et prøverum er en feature rettet mod forbrugeren. Et try-on-API er det underliggende rendering-trin: ét kald ind, ét billede ud. Du kan bygge et prøverum ovenpå eller udelukkende bruge det til at producere katalogfotos.

Hvad koster et try-on-kald?

Hos Photta koster det 5 credits ved 2K og 6 ved 4K. Fejlede jobs refunderes, så omkostningen ved et retry er blot selve det nye kald.

Hvor lang tid tager ét billede?

Endpointet angiver sin typiske behandlingstid, og jobbet rapporterer sin egen status. Foretag polling hvert 3. sekund i stedet for at gætte på varigheden.

Læs videre

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket

Prøv det på dit eget produktbillede

Én anmodning, ét poll, ét billede.

Opret en konto og hent en API-nøgleSe endpointet
  • 1.5–4 min
  • 5 credits ved 2K · 6 credits ved 4K
  • async, polling