Prompt Try-On

Het Prompt Try-On eindpunt stelt je in staat om een nieuwe outfit met tekst te beschrijven en deze naadloos op een AI-modellen te draperen.

Modelnaam: prompt-tryon

Levenscyclus: stabiel

Verwerkingstijd: ~15s–40s (neemt toe bij gebruik van stijl- of modelreferenties)

Uitvoerformaat: Auto (JPEG of PNG)

Leveringsmethoden: URL

Credits: 1 tot 5 per generatie (afhankelijk van kwaliteit)

Verzoek

Dien je try-on configuratie in bij het universele /v1/run eindpunt:

POSThttps://fititon.app/api/v1/run

Voorbeelden van verzoeken

Authenticatie Je kunt je API-sleutel doorgeven als een Bearer-token (Authorization: Bearer YOUR_API_KEY) of via de x-api-key header (x-api-key: YOUR_API_KEY).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

Antwoord

De Try-On generatie gebeurt asynchroon op de achtergrond. Je verzoek zal onmiddellijk een 200 OK status retourneren met een tracking object.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Resultaten opvragen Je moet de geretourneerde id gebruiken om het status-eindpunt (GET https://fititon.app/api/v1/status/{id}) te bevragen om je gegenereerde afbeeldings-URL's op te halen. Zie de API Setup gids voor gedetailleerde instructies.

Wanneer de generatie is voltooid, zal het polling-eindpunt status: "success" retourneren met de volgende output array die de uiteindelijke afbeeldings-URL's bevat:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

Verzoekparameters

Vereiste parameters

personImageRequiredstring

De basisafbeelding van het model dat je wilt aankleden. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks. Ondersteunde formaten: JPEG, PNG, WEBP. Maximale grootte: 25MB.

Pro Tip: Frontale poses met zichtbare armen produceren de meest realistische drapering.

Opmaakvereiste Bij het indienen van een Base64-string moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...). Het /v1/run eindpunt accepteert alleen JSON-payloads.

promptRequiredstring

Tekstuele beschrijving van de outfit die je het model wilt laten dragen.

Pro Tip: Voeg het stoftype (zijde, katoen, denim) en de pasvorm (slim, oversized) toe voor de beste resultaten. Specificeer kleuren nauwkeurig ("marineblauw" werkt beter dan "blauw") en verwijs expliciet naar wat het model al draagt, zodat de AI precies weet wat er moet veranderen.

Optionele parameters

quality'1k' | '2k' | '4k'

Uitvoerresolutieniveau voor Prompt Try-On (Gemini-modellen). Hogere resoluties verbruiken meer credits. Standaard: 1k

sampleCountinteger

Aantal afbeeldingsvariaties dat per verzoek moet worden gegenereerd. Moet tussen 1 en 4 liggen. Extra afbeeldingen verbruiken meer credits en verhogen de verwerkingstijd lineair. Standaard: 1

ratiostring

Definieert de breedte-hoogteverhouding van de gegenereerde afbeelding. Indien leeg, gebruikt het systeem standaard de aspectverhouding van de personImage.

Ondersteunde waarden: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

modelImageUrlstring

Optioneel. URL van een menselijk referentiemodel om te gebruiken in plaats van de originele kenmerken van de persoon te behouden.

Beschikbare vooraf ingestelde modellen:

styleIdstring

Optioneel. Pas een specifieke fotografische stijl toe op de uitvoerafbeelding.

Beschikbare stijlen:

Style Name	Style ID (`styleId`)

Geldige waarden: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

Opmerking: Complexe stijlen kunnen de totale generatietijd verlengen.

Runtimefouten

Runtimefouten voor deze functie gebruiken de gedeelde set die is gedocumenteerd in Foutafhandeling. Als er een fout optreedt tijdens de verwerking, wordt de status bijgewerkt naar "error" en bevat het error-veld de specifieke reden van de storing.

Creditkosten

De kosten zijn afhankelijk van het geselecteerde quality-niveau en worden vermenigvuldigd met je sampleCount.

Formule: Kosten = KwaliteitsCredits × sampleCount

Parameter	Credits per afbeelding
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5