Beschreiben Sie ein neues Outfit mit Text, um es auf KI-Modepuppen zu drapieren.

Prompt-Anprobe

Der Prompt-Anprobe-Endpunkt ermöglicht es Ihnen, ein neues Outfit mit Text zu beschreiben, um es nahtlos auf ein KI-Modell zu drapieren.

Modellname: prompt-tryon

Lebenszyklus: stable

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

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

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

Anfrage

Senden Sie Ihre Anprobe-Konfiguration an den universellen /v1/run-Endpunkt:

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

Anfragenbeispiele

Authentifizierung Sie können Ihren API-Schlüssel entweder als Bearer-Token (Authorization: Bearer YOUR_API_KEY) oder über den x-api-key-Header (x-api-key: YOUR_API_KEY) übergeben.

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

Antwort

Die Anprobe-Generierung erfolgt asynchron im Hintergrund. Ihre Anfrage gibt sofort einen 200 OK-Status mit einem Tracking-Objekt zurück.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Abfragen der Ergebnisse Sie müssen die zurückgegebene id verwenden, um den Status-Endpunkt (GET https://fititon.app/api/v1/status/{id}) abzufragen und Ihre generierten Bild-URLs abzurufen. Detaillierte Anweisungen finden Sie im API-Setup-Leitfaden.

Wenn die Generierung abgeschlossen ist, gibt der Abfrage-Endpunkt status: "success" mit dem folgenden output-Array zurück, das die finalen Bild-URLs enthält:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

Anfrageparameter

Erforderliche Parameter

personImageRequiredstring

Das Basisbild des Modells, das Sie anziehen möchten. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein. Unterstützte Formate: JPEG, PNG, WEBP. Maximale Größe: 25MB.

Profi-Tipp: Frontale Posen mit sichtbaren Armen erzeugen die realistischste Drapierung.

Formatierungsanforderung Beim Übermitteln eines Base64-Strings muss dieser das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,...). Der /v1/run-Endpunkt akzeptiert nur JSON-Payloads.

promptRequiredstring

Textbeschreibung des Outfits, das das Modell tragen soll.

Profi-Tipp: Geben Sie den Stofftyp (Seide, Baumwolle, Denim) und den Passformstil (schmal, oversized) an, um die besten Ergebnisse zu erzielen. Geben Sie Farben präzise an ("Marineblau" funktioniert besser als "Blau") und verweisen Sie explizit darauf, was das Modell bereits trägt, damit die KI genau weiß, was geändert werden soll.

Optionale Parameter

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

Ausgabeauflösungsstufe für Prompt-Anprobe (Gemini-Modelle). Höhere Auflösungen verbrauchen mehr Credits. Standard: 1k

sampleCountinteger

Anzahl der zu generierenden Bildvarianten pro Anfrage. Muss zwischen 1 und 4 liegen. Zusätzliche Bilder verbrauchen mehr Credits und erhöhen die Verarbeitungszeit linear. Standard: 1

ratiostring

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

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

modelImageUrlstring

Optional. URL eines menschlichen Referenzmodells, das anstelle der Beibehaltung der ursprünglichen Merkmale der Person verwendet werden soll.

Voreingestellte Modelle verfügbar:

styleIdstring

Optional. Wenden Sie einen bestimmten fotografischen Stil auf das Ausgabebild an.

Verfügbare Stile:

Style Name	Style ID (`styleId`)

Gültige Werte: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

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

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

Die Kosten hängen von der ausgewählten quality-Stufe ab und werden mit Ihrem sampleCount multipliziert.

Formel: Kosten = QualitätsCredits × sampleCount

Parameter	Credits pro Bild
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5