Model Aanmaken
Model Aanmaken stelt u in staat om realistische fashionmodellen te genereren met eenvoudige, intuïtieve prompts of referentieafbeeldingen, of om bestaande modelafbeeldingen naar uw werkruimte te uploaden.
Modelnaam: model-create
Levenscyclus: stable
Verwerkingstijd: ~10s–30s (neemt toe bij gebruik van geavanceerde referenties zoals gezicht/houding)
Uitvoerformaat: Auto (JPEG of PNG)
Leveringsmethoden: URL
Credits: 1 tot 5 per model (1k: 1, 2k: 3, 4k: 5)
Verzoek
Genereer of upload fashionmodellen door uw configuratie in te dienen bij het universele /v1/run eindpunt:
https://fititon.app/api/v1/runVoorbeelden 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": "model-create",
"inputs": {
"type": "generate",
"name": "Summer Collection Model",
"prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
"gender": "female",
"quality": "2k",
"sampleCount": 1
}
}'Antwoord
Omdat het genereren van modellen tot 30 seconden kan duren, retourneert het /v1/run eindpunt onmiddellijk een 201 Created status met een asynchrone taak id. U moet de Status API bevragen met GET /v1/status/{id} om de uiteindelijke resultaten op te halen. Als alternatief kunt u webhooks configureren om automatisch meldingen te ontvangen. Houd er rekening mee dat onze webhook dispatcher een strikte 15-seconden timeout hanteert. Uw server moet de webhook binnen 15 seconden bevestigen met een 2xx statuscode, anders beschouwen wij het 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 naar "succeeded", zal het output veld een array bevatten met de URL die naar uw gegenereerde model verwijst:
{
"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/model-123.png"
]
}Verzoekparameters
Verplichte parameters
typeRequired'generate' | 'upload'Specificeert of een nieuw model via AI (generate) moet worden gegenereerd of een bestaande afbeelding (upload) moet worden geüpload.
nameRequiredstringEen beschrijvende naam voor uw model. Deze wordt gebruikt om het model in uw studio te identificeren.
promptstringVerplicht voor generatie Tekstuele beschrijving van het te genereren model. Beschrijft het gewenste fashionmodel, kleding, houding en achtergrondscène.
Pro Tip: Als u een referentie zoals faceModelId gebruikt, zal de AI de identiteit van de referentie prioriteren, maar uw prompt gebruiken om de setting, outfit en lichaamskenmerken te bepalen. Optioneel alleen als een faceModelId is opgegeven.
imageBase64stringVerplicht voor upload
Base64-gecodeerde afbeeldingsreeks. Verplicht wanneer type is ingesteld op upload.
Opmaakvereiste
Uw Base64-reeks moet het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,... of data:image/png;base64,...). De upload mislukt als alleen de ruwe gecodeerde reeks wordt opgegeven.
Optionele generatieparameters
Deze parameters zijn van toepassing wanneer type is ingesteld op generate.
genderstringHet geslacht van het model. Helpt het generatiemodel bij het bepalen van fysieke kenmerken.
bodyTypestringHet lichaamstype van het model (bijv. "atletisch", "plus size", "slank").
clothingstringSpecifieke kledingdetails die tijdens de generatie moeten worden afgedwongen, ter aanvulling van de hoofd prompt.
posestringTekstuele beschrijving van de houding (bijv. "staand met handen in zakken", "lopend").
faceModelIdstringUUID van een bestaand gezichtsmodel om een specifieke identiteit vast te leggen over generaties heen. De uitvoer zal zich aanpassen aan de doelprompt met behoud van het referentiegezicht.
Opmerking: Het opgeven van een gezichtsreferentie voegt enkele seconden toe aan de totale verwerkingstijd, aangezien de AI de identiteit uitlijnt.
poseModelIdstringUUID van een bestaand houdingsmodel. Dwingt de generatie om strikt overeen te komen met de referentie voor lichaamshouding en -positie.
Opmerking: Het opgeven van een houdingsreferentie verhoogt de verwerkingstijd.
poseImageBase64stringBase64-gecodeerde afbeeldingsreeks om te gebruiken als een ad-hoc houdingsreferentie in plaats van een opgeslagen poseModelId op te geven.
quality'1k' | '2k' | '4k'Uitvoerresolutieniveau. 1k produceert ~1 megapixel uitvoer, 2k ~4 megapixels en 4k ~16 megapixels. Hogere resoluties verbruiken meer credits.
Standaard: 1k
aspectRatiostringDefinieert de breedte-hoogteverhouding van de gegenereerde afbeelding.
Ondersteunde waarden: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.
Standaard: 3:4
sampleCountintegerAantal afbeeldingsvariaties dat per verzoek moet worden gegenereerd. Extra afbeeldingen verbruiken meer credits en verhogen de verwerkingstijd lineair.
Standaard: 1
Runtimefouten
Runtimefouten voor deze functie maken gebruik van de gedeelde set die is gedocumenteerd in Foutafhandeling. Als er een fout optreedt tijdens de verwerking, wordt de status bijgewerkt naar "error" en zal het error veld de specifieke reden van de storing bevatten.
Creditkosten
Voor Developer API-verzoeken zijn de kosten afhankelijk van het gekozen uitvoer quality niveau.
| Kwaliteitsniveau | Credits per model |
|---|---|
| 1k (Standaard) | 1 |
| 2k | 3 |
| 4k | 5 |
