Felo API PlatformFelo API Platform
Torna ai modelli

Ideogram 4.5 Replace Background API

Ideogram 4.5 Replace Background rimuove e sostituisce gli sfondi delle immagini preservando i soggetti principali, con output pronti alla produzione e risoluzione nativa 2K.

Ideogram 4.5 Replace Background è un modello di editing di immagini della famiglia Ideogram 4.5, sviluppato da Ideogram AI. La sua funzione principale è rimuovere e sostituire lo sfondo di un'immagine mantenendo intatti i soggetti in primo piano. Il modello produce risultati pronti per la produzione, con una struttura pulita e dettagli nitidi, e supporta la generazione a risoluzione nativa 2K. Durante le modifiche, i pixel non toccati vengono copiati dall'immagine originale senza spostamenti o variazioni di colore, e la dimensione originale viene mantenuta.

Il modello accetta fino a cinque immagini sorgente in un'unica richiesta di modifica e supporta una maschera opzionale per limitare gli interventi a regioni specifiche: i pixel neri vengono modificati, quelli bianchi preservati. È pensato per attività che richiedono precisione e ripetibilità, come la creazione di ritagli puliti di prodotti per gli annunci dei negozi online, il cambio di sfondo mantenendo il prodotto esatto per le campagne di marketing, la sostituzione dello sfondo per mostrare diversi ambienti in progetti di interior design e i flussi di restauro fotografico con modifiche sequenziali. Grazie alla capacità di editing senza artefatti su più round e alle solide capacità di rendering del testo ereditate dalla famiglia Ideogram, si integra in un flusso di lavoro di editing completo.

Aggiornato:

ID MODELLO

ideogram-4-5/replace-background
Contesto
2.048K
Input
text / image
Output
image

In evidenza

  • Editing senza artefatti su più round
  • Risoluzione nativa 2K
  • Fino a cinque immagini sorgente per richiesta
  • Maschera opzionale per editing mirato
  • Pixel non toccati preservati senza spostamenti
  • Forte rendering del testo dalla famiglia Ideogram

Fornitori

1 fornitori

Confronta i prezzi delle API tra fornitori. Seleziona un fornitore per vedere tutti i costi e le condizioni.

Fornitore · Dettagli dei prezzi
Disponibilità
$0.176

Avvio rapido

Invia un’attività immagine, controlla lo stato e salva le immagini. Gli esempi usano curl e la libreria standard di Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Imposta la chiave API

Crea una chiave dal tuo account Felo API Platform e impostala come variabile d'ambiente.

export FELO_API_KEY="YOUR_API_KEY"

2Invia la prima richiesta

I valori facoltativi dipendono dal modello e non sono impostati qui. Verificali nel Playground. I campi sono allo stesso livello di model e prompt, senza contenitore input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "ideogram-4-5/replace-background"
}'

3Interroga l'attività

L’invio restituisce task_id. Controlla ogni 3 secondi durante queued o running; termina con succeeded, failed o interrupted. Attesa massima: 30 minuti. Conserva created.json per continuare senza inviare nuovamente.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Scarica l'output

Dopo il successo, salva outputs da task.json. Sono supportati URL HTTPS, oggetti URL e b64_json. Scarica subito gli URL firmati; per il download non serve la chiave API.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY

Preferisci il riferimento completo?

Riferimento API →

Domande frequenti

Cos'è Ideogram 4.5 Replace Background?

Ideogram 4.5 Replace Background è un modello di editing di immagini della famiglia Ideogram 4.5, sviluppato da Ideogram AI. La sua funzione principale è rimuovere e sostituire lo sfondo di un'immagine mantenendo intatti i soggetti in primo piano. Il modello produce risultati pronti per la produzione, con una struttura pulita e dettagli nitidi, e supporta la generazione a risoluzione nativa 2K. Durante le modifiche, i pixel non toccati vengono copiati dall'immagine originale senza spostamenti o variazioni di colore, e la dimensione originale viene mantenuta. Il modello accetta fino a cinque immagini sorgente in un'unica richiesta di modifica e supporta una maschera opzionale per limitare gli interventi a regioni specifiche: i pixel neri vengono modificati, quelli bianchi preservati. È pensato per attività che richiedono precisione e ripetibilità, come la creazione di ritagli puliti di prodotti per gli annunci dei negozi online, il cambio di sfondo mantenendo il prodotto esatto per le campagne di marketing, la sostituzione dello sfondo per mostrare diversi ambienti in progetti di interior design e i flussi di restauro fotografico con modifiche sequenziali. Grazie alla capacità di editing senza artefatti su più round e alle solide capacità di rendering del testo ereditate dalla famiglia Ideogram, si integra in un flusso di lavoro di editing completo.

Come viene addebitato l'utilizzo?

La fattura dipende dal fornitore che usi, dai suoi prezzi e dal tuo utilizzo. Input più lunghi o altre condizioni possono avere prezzi diversi.

Quali tipi di input supporta Ideogram 4.5 Replace Background?

Il modello accetta immagini come input e produce immagini come output. È possibile fornire fino a cinque immagini sorgente in una singola richiesta di modifica.

Come funziona la maschera opzionale per limitare le modifiche?

La maschera consente di limitare l'editing a regioni specifiche: i pixel neri vengono modificati, mentre quelli bianchi vengono preservati.

Qual è la risoluzione di output del modello?

Ideogram 4.5 Replace Background supporta la generazione a risoluzione nativa 2K.

I pixel non modificati vengono preservati durante l'editing?

Sì, i pixel non toccati vengono copiati dall'immagine originale senza spostamenti o variazioni di colore, e la dimensione originale viene mantenuta.

In cosa si differenzia Ideogram 4.5 Replace Background rispetto a Ideogram 4.5?

Ideogram 4.5 Replace Background fa parte della famiglia Ideogram 4.5 e si concentra sulla rimozione e sostituzione dello sfondo preservando i soggetti principali, mentre Ideogram 4.5 è il modello di base della famiglia con capacità di editing precise.

Modelli correlati