Verwandeln Sie Flat-Lay- oder Geister-Mannequin-Produktfotos in professionelle On-Model-Fotografie.

Produkt zu Model

Der Produkt zu Model Endpunkt verwandelt Flat-Lay- oder Geister-Mannequin-Produktfotos in professionelle On-Model-Fotografie, wobei Sie das Aussehen des Models oder den fotografischen Stil festlegen können.

Modellname: product-to-model

Lebenszyklus: stabil

Verarbeitungszeit: ~10s–30s (erhöht sich bei Verwendung von Stil- oder Modellreferenzen)

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

Guthaben: 1 bis 5 pro Generierung (abhängig von der Qualität)

Anfrage

Senden Sie Ihr Produktbild an den universellen /v1/run Endpunkt:

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

Anfragebeispiele

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

Antwort

Da die Bilderzeugung bis zu 20 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 erzwingt. Ihr Server muss den Webhook innerhalb von 15 Sekunden mit einem 2xx-Statuscode bestätigen, andernfalls wird er als fehlgeschlagen betrachtet und später erneut versucht.

{
  "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 Feld output ein Array mit der URL, die auf Ihr generiertes Bild 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/product-model-123.png"
  ]
}

Anfrageparameter

Erforderliche Parameter

productImageRequiredstring

Das Produktbild, das auf ein Model drapiert werden soll (Flat-Lay oder Geister-Mannequin). Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein. Max. Größe: 25 MB.

Profi-Tipp: Flat-Lay-Fotos auf weißem Hintergrund liefern die konsistentesten On-Model-Ergebnisse. Mannequin-Fotos funktionieren ebenfalls gut. Entfernen Sie vor dem Fotografieren Etiketten, Preisaufkleber oder Accessoires, die nicht zum Kleidungsstück gehören. Stellen Sie sicher, dass das gesamte Kleidungsstück sichtbar und ungefaltet ist – keine abgeschnittenen Ärmel.

Formatierungsanforderung Beim Übermitteln eines Base64-Strings muss dieser das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,...).

Optionale Parameter

customPromptstring

Textliche Anweisungen, die das gewünschte Model (z.B. Geschlecht, Ethnizität, Pose) oder die Szene beschreiben. Max. Länge: 500 Zeichen.

modelImageUrlstring

Die URL eines menschlichen Referenzmodells, das für die Generierung verwendet werden soll. Wird dies weggelassen, wird ein zufälliges, diverses Modell generiert.

Verfügbare voreingestellte Modelle:

Hinweis: Die Angabe eines Referenzmodells erhöht die gesamte Verarbeitungszeit.

styleIdstring

Die anzuwendende ID des fotografischen Stils (z.B. "studio", "iphone", "editorial"). Wird dies weggelassen, wird standardmäßig eine neutrale Studio-Präsentation verwendet.

Verfügbare Stile:

Style Name	Style ID (`styleId`)

Hinweis: Komplexe Stile können die Generierungszeit erhöhen.

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

Ausgabeauflösungsstufe. 1k erzeugt eine Ausgabe von ~1 Megapixel, 2k ~4 Megapixel und 4k ~16 Megapixel. Standard: 1k

sampleCountinteger

Anzahl der zu generierenden Bildvariationen pro Anfrage. Muss zwischen 1 und 4 liegen. Standard: 1

ratiostring

Definiert das Breiten-Höhen-Verhältnis des generierten Bildes. Wenn leer, verwendet das System standardmäßig 3:4 für Modeaufnahmen.

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

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 Feld error enthält den spezifischen Fehlergrund.

Kosten für Guthaben

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

Formel: Kosten = Qualitätsguthaben × sampleCount

Qualitätsstufe	Guthaben pro Bild
1k (Standard)	1
2k	3
4k	5