Transformeer flat-lay of spook-mannequin productfoto's in professionele on-model fotografie.

Product naar Model

Het Product naar Model-eindpunt transformeert flat-lay of spook-mannequin productfoto's in professionele on-model fotografie, waardoor u het uiterlijk van het model of de fotografische stijl kunt specificeren.

Modelnaam: product-to-model

Levenscyclus: stable

Verwerkingstijd: ~10s–30s (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 uw productafbeelding in bij het universele /v1/run-eindpunt:

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

Voorbeelden van verzoeken

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Antwoord

Omdat het genereren van afbeeldingen tot 20 seconden kan duren, retourneert het /v1/run-eindpunt onmiddellijk een 201 Created-status met een asynchrone job id. U moet de Status API bevragen met GET /v1/status/{id} om de uiteindelijke resultaten op te halen. U kunt ook webhooks configureren om automatisch meldingen te ontvangen. Houd er rekening mee dat onze webhook dispatcher een strikte time-out van 15 seconden hanteert. Uw server moet de webhook binnen 15 seconden bevestigen met een 2xx-statuscode, anders beschouwen wij deze als mislukt en proberen we het later opnieuw.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Zodra de status verandert in "succeeded", zal het output-veld een array bevatten met de URL die verwijst naar uw gegenereerde afbeelding:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/product-model-123.png"
  ]
}

Verzoekparameters

Vereiste parameters

productImageRequiredstring

De productafbeelding om op een model te draperen (flat-lay of spookmannequin). Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks. Max. grootte: 25MB.

Pro Tip: Flat-lay foto's op een witte achtergrond leveren de meest consistente on-model resultaten op. Mannequin foto's werken ook goed. Verwijder labels, prijskaartjes of accessoires die geen deel uitmaken van het kledingstuk voordat u fotografeert. Zorg ervoor dat het hele kledingstuk zichtbaar en uitgevouwen is — geen afgesneden mouwen.

Opmaakvereiste Bij het indienen van een Base64-reeks moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...).

Optionele parameters

customPromptstring

Tekstuele instructies die het gewenste model (bijv. geslacht, etniciteit, pose) of de scène beschrijven. Max. lengte: 500 tekens.

modelImageUrlstring

De URL van een menselijk referentiemodel dat moet worden gebruikt voor de generatie. Indien weggelaten, wordt een willekeurig divers model gegenereerd.

Beschikbare vooraf ingestelde modellen:

Opmerking: Het opgeven van een referentiemodel verhoogt de totale verwerkingstijd.

styleIdstring

De fotografische stijl-ID die moet worden toegepast (bijv. "studio", "iphone", "editorial"). Indien weggelaten, wordt standaard een neutrale studiopresentatie gebruikt.

Beschikbare stijlen:

Style Name	Style ID (`styleId`)

Opmerking: Complexe stijlen kunnen de generatietijd verlengen.

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

Uitvoerresolutie-niveau. 1k produceert ~1 megapixel uitvoer, 2k ~4 megapixels en 4k ~16 megapixels. Standaard: 1k

sampleCountinteger

Aantal afbeeldingsvariaties dat per verzoek moet worden gegenereerd. Moet tussen 1 en 4 liggen. Standaard: 1

ratiostring

Definieert de breedte-hoogteverhouding van de gegenereerde afbeelding. Indien leeg, gebruikt het systeem standaard 3:4 voor modefoto's.

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

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

Voor Developer API-verzoeken zijn de kosten afhankelijk van het gekozen quality-niveau vermenigvuldigd met de sampleCount.

Formule: Kosten = KwaliteitCredits × aantalVoorbeelden

Kwaliteitsniveau	Credits per afbeelding
1k (Standaard)	1
2k	3
4k	5