Isoleer een onderwerp en genereer een volledig nieuwe, realistische achtergrond.

Achtergrond Vervangen

Het Achtergrond Vervangen eindpunt stelt u in staat om een onderwerp uit een afbeelding te isoleren en een volledig nieuwe, realistische achtergrond te genereren op basis van een tekstprompt.

Modelnaam: background-replace

Levenscyclus: stable

Verwerkingstijd: ~5s–15s

Uitvoerformaat: Auto (JPEG of PNG)

Leveringsmethoden: URL

Credits: 1 tot 5 per generatie (afhankelijk van kwaliteit)

Verzoek

Dien uw achtergrondvervangingsconfiguratie in bij het universele /v1/run eindpunt:

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

Voorbeelden van verzoeken

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"
           }
         }'

Antwoord

Retourneert een 201 Created status met het initiële trackingobject. De generatie wordt asynchroon uitgevoerd.

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

Zodra de status verandert naar "succeeded" (via polling van het GET-eindpunt), zal het output veld een array bevatten met de URL die verwijst naar uw gegenereerde achtergrond:

{
  "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"
  ]
}

Verzoekparameters

Vereiste parameters

subjectImageRequiredstring

De afbeelding met het onderwerp dat u wilt isoleren. Kan een openbaar toegankelijke URL zijn of een Base64-gecodeerde afbeeldingsreeks. Max. grootte: 25 MB.

Pro Tip: Onderwerpen met duidelijke, scherpe randen tegen een contrasterende achtergrond krijgen de schoonste uitsneden. Vermijd afbeeldingen waarbij het onderwerp opgaat in de achtergrond (bijv. wit shirt op witte muur). Hoog contrast in belichting helpt de AI om te vertrouwen op randdetectie om het onderwerp perfect te scheiden.

Opmaakvereiste Bij het indienen van een Base64-string moet deze het standaard data URI-voorvoegsel bevatten (bijv. data:image/jpeg;base64,...).

scenePromptRequiredstring

Een tekstuele beschrijving van de nieuwe achtergrondscène die u achter het onderwerp wilt genereren.

Optionele parameters

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

Uitvoerresolutieniveau. Bepaalt de resolutie van de uiteindelijk gegenereerde afbeelding. Standaard: 1k

Runtimefouten

Runtimefouten voor deze functie maken gebruik van de gedeelde set die is gedocumenteerd in Foutafhandeling. Als er een fout optreedt tijdens de verwerking, wordt de status bijgewerkt naar "error" en zal het error veld de specifieke reden van de storing bevatten.

Creditkosten

Voor Developer API-verzoeken zijn de kosten volledig afhankelijk van het gekozen quality-niveau.

Formule: Kosten = KwaliteitCredits

Kwaliteitsniveau	Credits per afbeelding
1k (Standaard)	1
2k	3
4k	5