Modelliere Models in exakte Posen mithilfe von Referenzbildern oder beschreibenden Textaufforderungen.

Posenkontrolle

Der Posenkontrolle-Endpunkt ermöglicht es Ihnen, ein vorhandenes Bild eines Models zu nehmen und neue Variationen zu generieren, bei denen das Model eine andere Körperhaltung einnimmt. Die KI bewahrt dabei sorgfältig die Gesichtszüge, Kleidung und den Hintergrund des Models.

Modellname: pose-control

Lebenszyklus: stabil

Verarbeitungszeit: ~15s–30s

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

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

Anfrage

Senden Sie Ihr Modellbild und eine Liste der gewünschten Posen an den universellen /v1/run-Endpunkt:

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

Anfragebeispiele

Sie können ein Model mithilfe eines Referenzbildes (Vorlage) oder einer Textbeschreibung (benutzerdefiniert) neu positionieren.

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Hands on hips"
               },
               {
                 "type": "custom",
                 "text": "Sitting on a chair with legs crossed"
               }
             ]
           }
         }'

Antwort

Da die Generierung 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 mithilfe von 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 von URLs, die auf Ihre generierten Bilder verweisen. Die Bilder werden in genau der gleichen Reihenfolge zurückgegeben wie das poses-Array in Ihrer ursprünglichen Anfrage:

{
  "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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

Anfrageparameter

Erforderliche Parameter

modelImageRequiredstring

Das Quellbild der Person, die Sie neu positionieren möchten. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein.

Pro-Tipp: Ganzkörperfotos von Kopf bis Fuß liefern die besten Ergebnisse – die KI muss den gesamten Körper sehen, um ihn richtig neu positionieren zu können. Eng anliegende Kleidung zeigt die Körperstruktur besser als voluminöse oder geschichtete Outfits. Einfache, aufgeräumte Hintergründe ermöglichen es der KI, sich sauber auf die Körperform zu konzentrieren.

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

posesRequiredarray of objects

Ein Array, das die Posen definiert, die Sie generieren möchten. Sie können Vorlagen- und benutzerdefinierte Posen in derselben Anfrage mischen.

Vorlagenpose: Verwendet ein Bild als strukturelle Referenz. Sie können jede gültige Bild-URL als Referenzpose angeben oder eine unserer offiziell unterstützten Vorlagen unten verwenden.
- type (string): Muss "template" sein.
- cdnUrl (string): URL des Referenzbildes, das die gewünschte Pose demonstriert.
- title (string, optional): Eine beschreibende Bezeichnung.
Benutzerdefinierte Pose: Verwendet eine Textaufforderung, um die Pose zu definieren.
- type (string): Muss "custom" sein.
- text (string): Text, der die neue Pose beschreibt (z.B. "stehend mit verschränkten Armen").

Offizielle Posen-Vorlagen

Obwohl Sie Ihre eigenen Referenzbilder über cdnUrl bereitstellen können, bieten wir ein kuratiertes Verzeichnis von hochoptimierten Posen-Vorlagen an. Klicken Sie auf eine beliebige URL unten, um die Pose in der Vorschau anzuzeigen.

Female Poses

Title	Template URL (`cdnUrl`)

Male Poses

Title	Template URL (`cdnUrl`)

Optionale Parameter

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

Ausgabeauflösungsstufe. Standard: 1k

ratiostring

Definiert das Breiten-Höhen-Verhältnis des generierten Bildes. Wenn leer, verwendet das System standardmäßig das Seitenverhältnis des Originalbildes.

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.

Credit-Kosten

Für Developer API-Anfragen skalieren die Kosten linear mit der Anzahl der angeforderten Posen und hängen von der gewählten quality-Stufe ab.

Formel: Kosten = QualityCredits × AnzahlDerPosen

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

Beispiel: Die Anforderung eines Arrays von 3 Posen in 1k-Qualität kostet insgesamt 3 Credits. Die Anforderung derselben 3 Posen in 4k-Qualität kostet insgesamt 15 Credits.