Introduzione
Seedream 5.0 Pro Separazione in livelli scompone un’immagine finita in una base e fino a sedici livelli PNG trasparenti. Ogni livello arriva con un riquadro di posizione e un nome, così puoi ricostruire la composizione originale o riorganizzarla su una tela.
Sviluppato da ByteDance (ID modello dola-seedream-5-0-pro-260628). Usalo quando i livelli devono tornare esattamente dove stavano.
Scegli la modalità in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Un’immagine finita di cui ti servono le parti separate | Seedream 5.0 Pro Separazione in livelli |
| Una direzione artistica o un brief di design scritto | Seedream 5.0 Pro Testo in immagine |
| Un’immagine sorgente approvata da rivedere | Seedream 5.0 Pro Modifica immagine |
| La stessa separazione, anch’essa con nomi e riquadri di posizione, a un prezzo più basso per immagine | Seedream 5.0 Flash Separazione in livelli |
Pro o Flash per i livelli
Entrambe le fasce restituiscono boundingBox e name per ogni livello. Sullo stesso poster cinematografico, senza prompt, Pro ha restituito nove immagini e Flash otto. Le differenze sono il prezzo e un limite di contenuto. Pro costa $0.042 per immagine in uscita in 1K e 1.5K e $0.084 in 2K; Flash costa $0.026 a ogni fascia. Pro rifiuta le immagini sorgente di livello Molto forte, mentre Flash ha scomposto lo stesso tipo di immagine nelle sue figure. Nelle nostre prove nessuno dei due è stato più veloce in modo affidabile.
Caratteristiche principali
Riquadri di posizione e nomi
Ogni livello restituisce boundingBox come [x1, y1, x2, y2] in pixel della base e un name come «Woman in red trench coat». Nella nostra prova sul poster, impilando i livelli nei loro riquadri si è ottenuto di nuovo il poster originale. Il PNG di un livello è spesso più grande del riquadro che occupa (a un riquadro di 671 per 139 corrispondeva un PNG di 1233 per 256), quindi scalalo nel riquadro quando lo rimetti a posto.
Base pulita
Gli elementi separati vengono rimossi e lo sfondo viene completato. Separando la pubblicità del profumo è rimasta una superficie di marmo nero vuota dove c’erano bottiglia, nastro e scritte.
Guidalo con le parole o con le coordinate
Indica gli elementi, oppure fissali con le coordinate <bbox>. Senza prompt il modello sceglie da solo gli elementi principali.
Livelli PNG trasparenti
I livelli sono sempre PNG trasparenti, qualunque output_format tu scelga. Quell’impostazione cambia solo la base.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Un’immagine da scomporre: png, jpeg, webp, bmp, tiff o gif, fino a 30 MB, da 262.144 a 36.000.000 di pixel totali, rapporto d’aspetto tra 1:16 e 16:1. HEIC non è supportato. almeno 1 caratteri |
prompt | No | Facoltativo, di qualsiasi lunghezza. Lascialo vuoto e il modello sceglie da solo gli elementi principali; indica gli elementi e separa quelli. almeno 1 caratteri · al massimo 5000 caratteri |
resolution | No | auto, 1k, 1.5k o 2k. La base mantiene il rapporto d’aspetto dell’input e ogni livello mantiene le proporzioni del suo elemento. |
output_format | No | jpeg o png solo per la base. I livelli sono sempre PNG trasparenti, qualunque cosa tu scelga. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.042 / immagine |
| $0.042 / immagine |
| $0.084 / immagine |
| $0.084 / immagine |
Casi d’uso
Cambiare le parole su un poster
Estrai il livello del titolo, sostituiscilo o ridisegnalo e impila tutto di nuovo nei riquadri restituiti.
Cambiare lo sfondo di un prodotto
Stacca da una pubblicità il prodotto e le sue scritte, tieni la base o sostituiscila e ricomponi per una nuova campagna.
Costruire risorse per parallasse o animazione
Trasforma un’illustrazione in livelli ordinati con posizioni note, pronti per il movimento in profondità o per un rig.
Isolare una persona da una scena
Chiedi solo la persona e ottieni un livello trasparente più la scena senza di lei.
Consigli avanzati
Indica i pezzi che vuoi
Per un poster elencali con parole semplici: «Separate the diner building, the tagline, the LATE SHIFT title, the woman in the red trench coat and the ADMIT ONE ticket stub.» Quella prova ha restituito sei immagini: la base e proprio quei cinque livelli.
Cerchia un elemento con un bounding box
Aggiungi <bbox>x1 y1 x2 y2</bbox> dopo il nome dell’elemento. Le coordinate sono normalizzate a 0-1000 dall’angolo in alto a sinistra, quindi non dipendono dalla dimensione in pixel dell’immagine.
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
Scegli una risoluzione
1k e 1.5k costano uguale per immagine in uscita; 2k e auto sono al prezzo del 2K perché auto può produrre un output 2K. Usa 1k o 1.5k quando ti serve solo una separazione di lavoro.
Tieni conto della riserva
Una richiesta riserva il costo di 17 immagini e rimborsa la differenza quando si conosce il numero effettivo di livelli. I risultati tipici sono poche immagini.
Limiti dei contenuti
Seedream 5.0 Pro · Separazione in livelli. SpicyAPI non aggiunge filtri di contenuto lato piattaforma su questo endpoint. Le restrizioni proprie del modello restano valide e i risultati non sono garantiti. Nei nostri test ha separato tutte le immagini sorgente non filtrate che abbiamo provato, tranne quelle di livello Molto forte, che il modello ha rifiutato senza addebiti. Sei responsabile del rispetto della nostra policy sui contenuti.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
