Drehen Sie die virtuelle Kamera, um neue Blickwinkel von jedem Modebild zu generieren.

Winkelgenerierung

Der Endpunkt zur Winkelgenerierung ermöglicht es Ihnen, ein vorhandenes Bild zu nehmen und die virtuelle Kamera neu zu positionieren, um neue Blickwinkel (z. B. Vorder-, Rück-, Seitenprofile) zu generieren, während Modell, Kleidung, Texturen und Beleuchtung erhalten bleiben.

Modellname: angle-generation

Lebenszyklus: stabil

Verarbeitungszeit: ~10s–20s

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL, Base64 (Vorschau)

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

Anfrage

Senden Sie Ihr Bild und die gewünschten Winkel 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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Antwort

Da die Winkelgenerierung bis zu 20 Sekunden dauern kann, gibt der /v1/run-Endpunkt sofort einen 201 Created-Status 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 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 angleIds-Array, das in Ihrer ursprünglichen Anfrage bereitgestellt wurde:

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

Anfrageparameter

Erforderliche Parameter

imageUrlRequiredstring

Das Quellbild, das gedreht werden soll. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein.

Pro-Tipp: Frontalaufnahmen liefern die konsistentesten Ergebnisse aus mehreren Winkeln. Vermeiden Sie schräge oder seitliche Quellbilder – Frontalansichten bieten der KI die meisten Informationen, während schräge Aufnahmen die KI dazu zwingen, fehlende strukturelle Details zu halluzinieren.

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

angleIdsRequiredarray of strings

Ein Array von Winkel-Identifikatoren, die Sie generieren möchten. Verfügbare Optionen sind:

"front": Vorderansicht
"back": Rückansicht
"leftSide": Linke Seite (90°)
"rightSide": Rechte Seite (90°)
"left45": Links 45°
"right45": Rechts 45°

Optionale Parameter

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

Ausgabeauflösungsstufe. Standard: 1k

ratiostring

Überschreibung des Seitenverhältnisses (z. B. 16:9, 3:4). 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, ändert sich der status auf "error" 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 Winkel und hängen von der gewählten quality-Stufe ab.

Formel: Kosten = Qualitäts-Credits × Anzahl der Winkel

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

Beispiel: Die Anforderung von ["back", "leftSide", "rightSide"] in 1k-Qualität kostet insgesamt 3 Credits. Die Anforderung derselben 3 Winkel in 4k-Qualität kostet insgesamt 15 Credits.