Generieren Sie völlig einzigartige KI-Modelle oder laden Sie eigene Referenzbilder für Anproben hoch.

Modell erstellen

Mit Model Create können Sie realistische Fashion-Modelle mit einfachen, intuitiven Prompts oder Referenzbildern generieren oder bestehende Modellbilder in Ihren Arbeitsbereich hochladen.

Modellname: model-create

Lebenszyklus: stable

Verarbeitungszeit: ~10s–30s (erhöht sich bei Verwendung fortgeschrittener Referenzen wie Gesicht/Pose)

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

Credits: 1 bis 5 pro Modell (1k: 1, 2k: 3, 4k: 5)

Anfrage

Generieren oder laden Sie Fashion-Modelle hoch, indem Sie Ihre Konfiguration an den universellen /v1/run Endpunkt senden:

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

Anwendungsbeispiele für Anfragen

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

Antwort

Da die Modellgenerierung bis zu 30 Sekunden dauern kann, gibt der /v1/run Endpunkt sofort den Status 201 Created mit einer asynchronen Job-id zurück. Sie müssen die Status-API mit GET /v1/status/{id} abfragen, um die Endergebnisse abzurufen. Alternativ können Sie Webhooks konfigurieren, um Benachrichtigungen automatisch zu erhalten. Bitte beachten Sie, dass unser Webhook-Dispatcher ein striktes 15-Sekunden-Timeout durchsetzt. Ihr Server muss den Webhook innerhalb von 15 Sekunden mit einem 2xx Statuscode bestätigen, andernfalls betrachten wir ihn als fehlgeschlagen und versuchen es später erneut.

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

Sobald sich der status in "succeeded" ändert, enthält das output-Feld ein Array mit der URL, die auf Ihr generiertes Modell verweist:

{
  "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"
  ]
}

Anforderungsparameter

Erforderliche Parameter

typeRequired'generate' | 'upload'

Gibt an, ob ein neues Modell mittels KI (generate) generiert oder ein bestehendes Bild (upload) hochgeladen werden soll.

nameRequiredstring

Ein beschreibender Name für Ihr Modell. Dieser wird verwendet, um das Modell in Ihrem Studio zu identifizieren.

promptstring

Erforderlich für die Generierung Textbeschreibung des zu generierenden Modells. Beschreibt das gewünschte Fashion-Modell, Kleidung, Pose und Hintergrundszene.

Profi-Tipp: Wenn Sie eine Referenz wie faceModelId verwenden, priorisiert die KI die Identität der Referenz, verwendet aber Ihren Prompt, um die Umgebung, das Outfit und die Körpermerkmale zu bestimmen. Optional nur, wenn eine faceModelId angegeben wird.

imageBase64string

Erforderlich für den Upload Base64-kodierter Bildstring. Erforderlich, wenn type auf upload gesetzt ist.

Formatierungsanforderung Ihr Base64-String muss das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,... oder data:image/png;base64,...). Der Upload schlägt fehl, wenn nur der rohe kodierte String bereitgestellt wird.

Optionale Generierungsparameter

Diese Parameter gelten, wenn type auf generate gesetzt ist.

genderstring

Das Geschlecht des Modells. Hilft dem Generierungsmodell bei der Bestimmung physischer Attribute.

bodyTypestring

Der Körpertyp des Modells (z.B. "athletisch", "Übergröße", "schlank").

clothingstring

Spezifische Kleidungsdetails, die während der Generierung erzwungen werden sollen, um den Haupt-prompt zu ergänzen.

posestring

Textuelle Beschreibung der Pose (z.B. "stehend Hände in den Taschen", "gehend").

faceModelIdstring

UUID eines bestehenden Gesichtsmodells, um eine spezifische Identität über Generationen hinweg zu fixieren. Die Ausgabe passt sich dem Ziel-Prompt an, während das Referenzgesicht erhalten bleibt.

Hinweis: Die Bereitstellung einer Gesichtsreferenz verlängert die gesamte Verarbeitungszeit um mehrere Sekunden, da die KI die Identität abgleicht.

poseModelIdstring

UUID eines bestehenden Posenmodells. Erzwingt, dass die Generierung die Referenz für Körperhaltung und -pose strikt einhält.

Hinweis: Die Bereitstellung einer Posenreferenz erhöht die Verarbeitungszeit.

poseImageBase64string

Base64-kodierter Bildstring, der als Ad-hoc-Posenreferenz verwendet werden kann, anstatt eine gespeicherte poseModelId bereitzustellen.

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

Ausgabeauflösungsstufe. 1k erzeugt eine Ausgabe von ~1 Megapixel, 2k ~4 Megapixel und 4k ~16 Megapixel. Höhere Auflösungen verbrauchen mehr Credits. Standard: 1k

aspectRatiostring

Definiert das Breiten-Höhen-Verhältnis des generierten Bildes.

Unterstützte Werte: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Standard: 3:4

sampleCountinteger

Anzahl der Bildvariationen, die pro Anfrage generiert werden sollen. Zusätzliche Bilder verbrauchen mehr Credits und erhöhen die Verarbeitungszeit linear. Standard: 1

Laufzeitfehler

Laufzeitfehler für diese Funktion verwenden den gemeinsamen Satz, der unter Fehlerbehandlung dokumentiert ist. Tritt während der Verarbeitung ein Fehler auf, wird der status auf "error" aktualisiert und das error-Feld enthält den spezifischen Fehlergrund.

Kosten für Credits

Bei Developer API-Anfragen hängen die Kosten von der gewählten quality-Stufe der Ausgabe ab.

Qualitätsstufe	Credits pro Modell
1k (Standard)	1
2k	3
4k	5