Isolieren Sie ein Motiv und generieren Sie einen völlig neuen, realistischen Hintergrund.

Hintergrund ersetzen

Der Hintergrund ersetzen Endpunkt ermöglicht es Ihnen, ein Motiv aus einem Bild zu isolieren und einen völlig neuen, realistischen Hintergrund basierend auf einer Textaufforderung zu generieren.

Modellname: background-replace

Lebenszyklus: stable

Verarbeitungszeit: ~5s–15s

Ausgabeformat: Auto (JPEG oder PNG)

Liefermethoden: URL

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

Anfrage

Senden Sie Ihre Hintergrundersetzungs-Konfiguration 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": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

Antwort

Gibt einen 201 Created Status mit dem anfänglichen Tracking-Objekt zurück. Die Generierung läuft asynchron ab.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Sobald sich der status auf "succeeded" ändert (durch Abfragen des GET-Endpunkts), enthält das output-Feld ein Array mit der URL, die auf Ihren generierten Hintergrund 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/bg-replace-123.png"
  ]
}

Anfrageparameter

Erforderliche Parameter

subjectImageRequiredstring

Das Bild, das das Motiv enthält, das Sie isolieren möchten. Kann eine öffentlich zugängliche URL oder ein Base64-kodierter Bildstring sein. Maximale Größe: 25MB.

Profi-Tipp: Motive mit klaren, scharfen Kanten vor einem kontrastierenden Hintergrund erhalten die saubersten Ausschnitte. Vermeiden Sie Bilder, bei denen das Motiv mit dem Hintergrund verschmilzt (z.B. weißes Hemd an weißer Wand). Eine kontrastreiche Beleuchtung hilft der KI, sich auf die Kantenerkennung zu verlassen, um das Motiv perfekt zu trennen.

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

scenePromptRequiredstring

Eine textuelle Beschreibung der neuen Hintergrundszene, die Sie hinter dem Motiv generieren möchten.

Optionale Parameter

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

Ausgabeauflösungsstufe. Definiert die Auflösung des final generierten Bildes. Standard: 1k

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.

Credit-Kosten

Für Developer API-Anfragen hängen die Kosten vollständig von der gewählten quality-Stufe der Ausgabe ab.

Formel: Cost = QualityCredits

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