Skalieren und verbessern Sie die Auflösung und Details Ihrer generierten Modebilder.

Qualitätsverbesserer (Upscale)

Der Endpunkt "Qualitätsverbesserer" ermöglicht es Ihnen, die Auflösung und feineren Details von Bildern intelligent hochzuskalieren und zu verbessern, wobei bis zu 4K-Auflösung unterstützt wird.

Modellname: upscale

Lebenszyklus: stable

Verarbeitungszeit: ~8s–20s

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

Credits: 3 bis 4 pro Bild (2k: 3, 4k: 4)

Anfrage

Senden Sie Ihr Bild und die Zielauflösung an den universellen /v1/run Endpunkt:

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

Anwendungsbeispiele

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

Antwort

Da das Upscaling bis zu 20 Sekunden dauern kann, gibt der Endpunkt /v1/run sofort den Status 201 Created mit einer asynchronen Job-id zurück. Sie müssen die Status-API mit dieser id abfragen, um das endgültige Bild 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": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

Wenn der Job abgeschlossen ist (status: "success"), enthält das Feld output das Array der resultierenden URLs:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Anfrageparameter

Erforderliche Parameter

imageUrlRequiredstring

Das Quellbild, das Sie hochskalieren möchten. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein.

Formatierung & Payload-Anforderung Beim Übermitteln eines Base64-Strings muss dieser das Standard-Daten-URI-Präfix enthalten (z.B. data:image/jpeg;base64,...). Darüber hinaus empfehlen wir dringend, Standard-HTTP-URLs für Bilder zu verwenden, die größer als 3 MB sind, um globale JSON-Payload-Größenbeschränkungen (HTTP 413) zu vermeiden.

targetQualityRequired'2k' | '4k'

Die gewünschte Ausgabequalitätsstufe. Hinweis: Bilder, die größer als 4,25 Megapixel sind, können targetQuality="2k" nicht verwenden und müssen 4k als Ziel haben.

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 Credits

Für Developer API-Anfragen skalieren die Kosten je nach targetQuality.

Formel: Kosten = QualityCredits

Parameter	Credits pro Bild
`targetQuality="2k"`	3
`targetQuality="4k"`	4