Sostituzione Sfondo

L'endpoint Sostituzione Sfondo ti permette di isolare un soggetto da un'immagine e generare uno sfondo completamente nuovo e realistico basato su un prompt testuale.

Model Name: background-replace

Ciclo di vita: stabile

Tempo di elaborazione: ~5s–15s

Formato di output: Auto (JPEG o PNG)

Metodi di consegna: URL

Crediti: Da 1 a 5 per generazione (dipende dalla qualità)

Richiesta

Invia la tua configurazione di sostituzione dello sfondo all'endpoint universale /v1/run:

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

Esempi di Richiesta

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

Risposta

Restituisce uno stato 201 Created con l'oggetto di tracciamento iniziale. La generazione viene eseguita in modo asincrono.

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

Una volta che lo status cambia in "succeeded" (tramite polling dell'endpoint GET), il campo output conterrà un array con l'URL che punta al tuo sfondo generato:

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

Parametri della Richiesta

Parametri Obbligatori

subjectImageRequiredstring

L'immagine contenente il soggetto che desideri isolare. Può essere un URL pubblicamente accessibile o una stringa immagine codificata in Base64. Dimensione massima: 25MB.

Suggerimento Pro: I soggetti con bordi chiari e nitidi su uno sfondo contrastante ottengono i ritagli più puliti. Evita immagini in cui il soggetto si fonde con lo sfondo (es. camicia bianca su parete bianca). L'illuminazione ad alto contrasto aiuta l'IA a fare affidamento sul rilevamento dei bordi per separare perfettamente il soggetto.

Requisito di Formattazione Quando si invia una stringa Base64, deve includere il prefisso URI di dati standard (es. data:image/jpeg;base64,...).

scenePromptRequiredstring

Una descrizione testuale della nuova scena di sfondo che desideri generare dietro il soggetto.

Parametri Opzionali

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

Livello di risoluzione dell'output. Definisce la risoluzione dell'immagine finale generata. Predefinito: 1k

Errori di Runtime

Gli errori di runtime per questa funzionalità utilizzano il set condiviso documentato in Gestione degli Errori. Se si verifica un errore durante l'elaborazione, lo status si aggiornerà a "error" e il campo error conterrà la ragione specifica del fallimento.

Costo dei Crediti

Per le richieste API per sviluppatori, il costo dipende interamente dal livello di quality dell'output scelto.

Formula: Costo = CreditiQualità

Livello di Qualità	Crediti per Immagine
1k (Predefinito)	1
2k	3
4k	5