
Seedream 5.0 Pro: cosa restituisce la separazione in livelli e come viene addebitata
Come separare immagini in livelli con l'API Seedream 5.0 Pro: regole di input, dimensioni, dati restituiti e costi per livello da verificare prima.
La separazione in livelli di Seedream 5.0 Pro riceve un'immagine PNG o JPEG finita e restituisce un'immagine di base più un massimo di 16 livelli PNG trasparenti, ciascuno con ordine di sovrapposizione, posizione, nome e descrizione. L'addebito è per immagine restituita, non per richiesta: ogni livello costa la tariffa dei livelli corrispondente alle proprie dimensioni in pixel. Nell'API la funzione si chiama scomposizione in livelli e si attiva con layer_decomposition: true. 1 2
ByteDance ha introdotto questa funzione con il rilascio di Seedream 5.0 Pro l'8 luglio 2026, mostrando un poster suddiviso in più di dieci livelli, tra cui testo, soggetto principale e sfondo. Le aree nascoste dietro il soggetto vengono riempite, così un livello può essere spostato senza lasciare un buco. 3 Questa guida spiega cosa inviare, cosa viene restituito e come stimare il costo prima dell'esecuzione. Puoi provare la funzione nel Playground di Seedream 5.0 Pro, passando alla modalità di scomposizione in livelli.
Cosa inviare
La separazione in livelli usa lo stesso endpoint delle immagini della normale generazione, con regole di input più restrittive. 1
| Campo | Regola per la separazione in livelli |
|---|---|
image | Esattamente un'immagine. PNG o JPEG, fino a 30 MB, da 512×512 a 6000×6000 pixel totali (da 262.144 a 36.000.000), rapporto d'aspetto da 1:16 a 16:1. Una seconda immagine viene rifiutata. |
prompt | Facoltativo. Indica gli elementi da separare, come il testo del titolo e il pappagallo. Senza un prompt, il modello separa da solo gli elementi principali. |
size | 1K, 1.5K, 2K o auto (predefinito). Questa modalità non accetta dimensioni esatte in pixel. |
output_format | jpeg (predefinito) o png, applicato solo all'immagine di base. I livelli sono sempre PNG. |
auto mantiene l'immagine di base e ogni livello alle dimensioni originali quando rientrano tra 921.600 e 4.624.220 pixel, ingrandisce gli elementi più piccoli fino a 1K e riduce quelli più grandi a 2K, conservando il rapporto d'aspetto di ciascun elemento. Con un formato predefinito fisso, l'immagine di base corrisponde alle dimensioni scelte e ogni livello viene restituito a una risoluzione vicina a esse. 1
Su Wan API non è possibile combinare la separazione in livelli con background: "transparent"; i livelli hanno già una trasparenza reale e la richiesta viene rifiutata prima di qualsiasi addebito.
Cosa viene restituito
La risposta elenca prima l'immagine di base (z_index: 0) e poi ogni livello:
| Campo | Significato |
|---|---|
url | Il livello PNG oppure l'immagine di base nel formato scelto. |
size | Dimensioni in pixel dell'output, per esempio 1273x265 per un livello del titolo. |
z_index | Ordine di sovrapposizione; 0 è l'immagine di base e i numeri più alti si trovano sopra. |
bounding_box.absolute | Posizione in pixel all'interno dell'immagine di base. |
bounding_box.normalized | La stessa posizione su una scala da 0 a 1000, indipendente dalla risoluzione. |
name, description | Cosa ha identificato il modello in quel livello, come il testo del titolo nell'esempio ufficiale, con una breve descrizione. |
Questi campi bastano per ricostruire la composizione in uno strumento di grafica: posiziona ogni PNG nel proprio riquadro di delimitazione, nell'ordine indicato da z_index. 1
Abbiamo eseguito la funzione su un poster di un festival generato con Seedream 5.0 Pro, chiedendo di separare il titolo, la riga con la data, i nomi degli artisti, il sassofonista e lo sfondo. A 1.5K ha restituito l'immagine di base e cinque livelli. L'immagine di base a sinistra non contiene più il testo né il musicista; lo sfondo dietro di loro è stato riempito.

Ogni livello è stato restituito con un name in inglese, come "BLUE HOUR JAZZ headline", coerente con il prompt. Gli elementi piccoli vengono consegnati a dimensioni maggiori di quelle con cui appaiono nel poster: il livello con i nomi degli artisti misura 2011×202 pixel.
Due comportamenti sono importanti per integrare questa funzione. Se la generazione di un livello non riesce, l'intera richiesta non riesce; non viene restituito un risultato parziale. E se il prompt richiede più livelli del limite di 16, parte del contenuto dei livelli potrebbe essere omessa invece di far fallire la richiesta. 1
Come viene addebitata la separazione in livelli
La tariffa ufficiale per la scomposizione in livelli di Seedream 5.0 Pro è per immagine di output: 0,0225 USD per un'immagine fino a 2,61 milioni di pixel e 0,045 USD oltre tale soglia. 2 Su Wan API, un risultato in cui tutte le immagini restituite non superano 2,61 milioni di pixel costa il 30% in meno, 0,01575 USD per immagine. Un risultato che include un'immagine più grande, come accade per ogni richiesta a 2K, viene addebitato alla tariffa ufficiale per ogni immagine. I valori aggiornati si trovano nella tabella dei prezzi.
Poiché il modello decide quanti livelli restituire, il costo dipende dal risultato:
| Risultato | Tariffa ufficiale | Wan API |
|---|---|---|
| Immagine di base 2K + 8 livelli piccoli (ciascuno fino a 2,61 MP) | 0,045 USD + 8 × 0,0225 USD = 0,225 USD | 0,225 USD |
| Immagine di base 2K + 8 livelli oltre 2,61 MP | 9 × 0,045 USD = 0,405 USD | 0,405 USD |
Risultato massimo possibile con auto o 2K: 17 immagini oltre 2,61 MP | 17 × 0,045 USD = 0,765 USD | 0,765 USD |
Risultato massimo possibile a 1K o 1.5K: 17 immagini fino a 2,61 MP | 17 × 0,0225 USD = 0,3825 USD | 0,26775 USD |
Un elemento piccolo resta nella fascia inferiore anche in una richiesta a 2K: il livello del titolo di 1273×265 pixel nell'esempio ufficiale è di circa 0,34 milioni di pixel. 1
Nella nostra esecuzione riportata sopra, tutte e sei le immagini erano pari o inferiori a 2,61 milioni di pixel: l'immagine di base misurava 1344×1792 (circa 2,41 milioni di pixel) e il livello più grande 1216×1662. Il costo alla tariffa ufficiale è quindi 6 × 0,0225 USD = 0,135 USD e il nostro gateway ha addebitato esattamente l'importo previsto in base alle dimensioni restituite. Al prezzo Wan API lo stesso risultato costa 6 × 0,01575 USD = 0,0945 USD.
Su Wan API, il tuo saldo deve coprire il risultato massimo possibile prima che la richiesta inizi, poi paghi solo l'immagine di base e i livelli effettivamente restituiti. Scegliere 1K o 1.5K abbassa questo tetto da 0,765 USD a 0,26775 USD e di solito mantiene tutte le immagini nella fascia inferiore scontata.
Controlla come un piano conteggia i livelli
Leggi le condizioni di fatturazione prima di acquistare un piano immagini per questa funzione. In un post di agosto 2026, un cliente BytePlus ha riferito di aver acquistato un piano immagini Seedream 5.0 Pro per la separazione in livelli, scoprendo che le richieste di livelli venivano addebitate per livello alle tariffe a consumo invece di utilizzare la quota di immagini del piano; l'assistenza ha riconosciuto che la distinzione "potrebbe non essere stata comunicata chiaramente". 4 Qualunque servizio tu usi, verifica se i livelli vengono conteggiati nel pacchetto e quanto costa ciascuno.
Eseguire la richiesta su Wan API
Invia la richiesta una sola volta a POST https://api.wanapi.app/v1/images/generations con la tua chiave API. La risposta viene restituita quando tutti i livelli sono pronti.
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "1.5K"
}'Scarica i livelli entro 30 giorni. La guida API di Seedream 5.0 Pro elenca tutti i campi, la struttura completa della risposta e i codici di errore.
Quando usare la separazione in livelli
Usala quando hai già un'immagine finita e ti servono parti modificabili: per sostituire il titolo di un poster, spostare una foto di prodotto o consegnare una grafica a livello unico a chi lavora con i livelli. Usa la normale generazione o la modifica con riferimenti quando vuoi una nuova immagine; usa la modalità sfondo trasparente quando ti serve un soggetto su sfondo trasparente anziché un'intera pila di livelli.
Inizia nel Playground: carica un'immagine, scegli la scomposizione in livelli e controlla la stima prima di generare.
Fonti
- BytePlus ModelArk: image generation API,
layer_decomposition,size,output_formate campi della risposta per Seedream 5.0 Pro. Verificato il 23 ottobre 2026.
- BytePlus ModelArk: model pricing, tariffe per singola immagine e scomposizione in livelli di Seedream 5.0 Pro. Verificato il 23 ottobre 2026.
- ByteDance Seed: Introducing Seedream 5.0 Pro, annuncio del rilascio dell'8 luglio 2026, sezione sulla separazione in livelli. Verificato il 23 ottobre 2026.
- Reddit r/generativeAI: "PSA: Why BytePlus Seedream 5.0 Pro's Layer Separation marketing felt misleading", resoconto di un cliente pubblicato il 31 agosto 2026. Verificato il 23 ottobre 2026.
Altri articoli

Seedance 2.5 vs Seedance 2.0: quale scegliere per la tua scena?
Confronta durata, limiti dei riferimenti e impostazioni degli esempi di Seedance 2.5 e 2.0. Prepara un test senza presumere un vincitore per qualità o velocità.


Seedance 2.0 Fast vs Mini: quale conviene provare?
Confronta limiti di Seedance 2.0 Fast e Mini, costi dei video di riferimento ed esempi. Usa lo stesso brief per valutare qualità, tempi e costo per ripresa.


Guida all'API Wan 3.0: modelli, input e primo video
Confronta gli input API e le specifiche di output di Wan 3.0, Wan 3.0 Prime, Wan 3.0 Pro e Wan 3.0 Prime Pro e prepara il tuo primo test video.

Novità di Wan API
Aggiornamenti sul servizio e novità sui modelli
Iscriviti per ricevere novità sui modelli, aggiornamenti sul servizio e informazioni sull'integrazione API.