Introduzione
I livelli di Seedream 5.5 trasformano un PNG o JPEG finito in una base opaca ed elementi trasparenti separati. Usa la separazione in livelli quando hai già una grafica e vuoi lavorare sui singoli elementi. Questo endpoint accetta una sola sorgente, anziché la raccolta di riferimenti usata dalla modifica.
ByteDance descrive una base e fino a 99 livelli PNG trasparenti modificabili. Nei nostri test abbiamo separato una copertina, un menu e un poster con tre righe. I risultati mostrano perché il numero richiesto è un limite massimo: alcune immagini lo hanno raggiunto, mentre il poster ha restituito meno elementi di quelli consentiti.
Caratteristiche principali
Una base con elementi trasparenti
La base è opaca e gli elementi separati usano la trasparenza PNG. Scegliere jpeg come output_format cambia la codifica della base; i livelli arrivano comunque come PNG trasparenti. Ricorda questa distinzione quando salvi i file per una composizione. Base e livelli hanno ruoli diversi nell’insieme restituito.
Ogni livello include nome, riquadro di delimitazione e zIndex per l’ordine di sovrapposizione. La base non ha un riquadro. Conserva queste informazioni insieme ai file per disporre gli elementi separati in uno strumento di design. Ogni immagine restituita conserva le proprie proporzioni.
Un limite che conta anche la base
num_outputs accetta valori da 2 a 100 e parte da 10. Conta la base come un output quando pianifichi la separazione. Un limite di sei consente quindi una base e cinque livelli trasparenti. Un valore maggiore permette in genere una separazione più dettagliata, ma il risultato effettivo può contenere meno immagini.
Nei nostri test, un menu ha restituito una base e cinque livelli con un limite di sei. Un poster con tre righe ha restituito una base e tre livelli di testo con un limite di cinque. Il poster mostra che un limite maggiore non obbliga il modello a occupare tutti gli output disponibili.
Nomi in inglese su richiesta
Gli esempi della pagina chiedono ogni nome e descrizione dei livelli in inglese. I nostri test hanno restituito nomi in inglese quando richiesti così. Inserisci «Scrivi ogni nome e descrizione dei livelli in inglese» se il tuo flusso di design richiede questa lingua. Tieni la richiesta sui nomi distinta dall’elenco degli elementi da separare.
Controlli di sorgente e risoluzione
Fornisci un PNG o JPEG di almeno 512 x 512 pixel. Le risoluzioni disponibili sono auto, 1k, 1.5k e 2k, con auto come valore predefinito.
| Impostazione | Ruolo nella separazione |
|---|---|
image_url | Fornisce l’immagine sorgente finita |
| prompt | Indica facoltativamente elementi o un’area specifica |
| resolution | Seleziona auto, 1k, 1.5k o 2k |
num_outputs | Limita tutte le immagini restituite, base compresa |
output_format | Seleziona PNG o JPEG per la base |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Fornisci un PNG o JPEG di almeno 512 x 512 pixel. La sorgente è obbligatoria e non esiste un’immagine predefinita. almeno 1 caratteri |
prompt | No | Facoltativo. Indica gli elementi da separare entro 5.000 caratteri. almeno 3 caratteri · al massimo 5000 caratteri |
num_outputs | No | Limita il numero totale di immagini restituite, base compresa: da 2 a 100, con 10 come valore predefinito. |
resolution | No | Scegli auto, 1k, 1.5k o 2k; auto è il valore predefinito. Ogni immagine conserva le proprie proporzioni. |
output_format | No | Scegli png (predefinito) o jpeg per la base opaca. I livelli separati rimangono PNG trasparenti in entrambi i casi. |
Prezzi
Ogni immagine dei livelli Seedream 5.5, base compresa, viene addebitata in base al proprio numero di pixel. Il preventivo riserva il massimo per il limite richiesto, usando la tariffa 2k con auto. La somma non utilizzata viene sbloccata al conguaglio.
| Specifiche | Prezzo |
|---|---|
| $0.0195 / immagine |
| $0.0195 / immagine |
| $0.027 / immagine |
| $0.027 / immagine |
Casi d’uso
Separare una copertina nei suoi elementi grafici
La nostra copertina NOIR ha usato un limite di sei immagini e ne ha restituite sei: sfondo, persona, testata, riga giapponese, riga del numero e codice a barre. È un esempio concreto dei livelli di Seedream 5.5 su una copertina che combina fotografia e scritte.
Usa questo risultato per pianificare una grafica con elementi distinti da ottenere separatamente. Indica le parti rilevanti nell’istruzione facoltativa. Conserva la sorgente per confrontare gli elementi restituiti con il layout originale.
Scomporre un menu per nuove composizioni
L’esempio Kaze Ramen parte dal menu finito. Con un limite di sei immagini, i nostri test hanno restituito una base opaca e cinque livelli trasparenti. Salva l’intero insieme anziché un singolo elemento se intendi ricomporre successivamente le parti del menu.
Isolare le righe di testo di un poster
Il nostro test su un poster con tre righe ha prodotto un livello trasparente per ogni riga, oltre alla base. Il totale è stato di quattro immagini nonostante il limite richiesto di cinque. Conta gli elementi dopo il completamento, senza considerare il limite come un elenco di file garantiti.
Organizzare gli elementi con i metadati restituiti
Usa il nome per identificare il livello, il riquadro di delimitazione per comprenderne la posizione e zIndex per l’ordine di sovrapposizione. Mantieni questi valori collegati al file corrispondente. Richiedere nomi in inglese può agevolare l’organizzazione quando anche il resto del flusso di design usa etichette inglesi.
Consigli avanzati
Scegli una sorgente finita con elementi noti
Controlla che il file sia PNG o JPEG e rispetti il minimo di 512 x 512 pixel. Decidi gli elementi da separare prima di impostare il numero. Per una copertina, elenca sfondo, persona, titolo, testi di supporto e codice a barre quando sono le parti che ti servono.
Specifica la separazione richiesta
Il prompt è facoltativo: puoi inviare una sorgente senza elencare gli elementi. Quando conta una separazione precisa, scrivi una breve istruzione come «Separa testata, sottotitolo, riga del numero e codice a barre». Indicherai così allo strumento su cosa vuoi lavorare dopo la separazione.
Chiedi direttamente la lingua delle etichette
Aggiungi «Restituisci i nomi dei livelli in inglese» quando servono etichette inglesi. Gli esempi della copertina e del menu usano questo tipo di richiesta. La nostra osservazione sulla lingua riguarda i nomi restituiti: non significa che i testi stampati nella sorgente debbano essere tradotti o sostituiti.
Indica una regione con il tag del riquadro
Per identificare un’area, usa <bbox>x1 y1 x2 y2</bbox> con coordinate tra 0 e 1000. Per esempio, <bbox>0 0 1000 300</bbox> identifica una regione nella parte superiore dell’immagine. Fai seguire al tag la descrizione dell’elemento da separare, così area e scopo saranno chiari.
Scegli un numero adatto agli elementi necessari
Per una base e cinque livelli, scegli un limite di sei. Se ti servono elementi più dettagliati, un limite maggiore produce in genere livelli più fini. L’impostazione resta un limite, non un numero promesso. Confronta gli output effettivi con l’elenco previsto prima di iniziare la fase successiva del design.
Distingui il formato della base dalla trasparenza dei livelli
Scegli png o jpeg in base al file di base che ti serve. Questa scelta non trasforma i livelli separati in JPEG: conservano la codifica PNG trasparente in entrambi i casi. Mantieni la base opaca quando la composizione completa richiede l’immagine sottostante.
Comprendi il conteggio al conguaglio
Ogni immagine dei livelli Seedream 5.5, base compresa, viene addebitata in base al proprio numero di pixel. Il preventivo riserva il massimo per il limite richiesto, usando la tariffa 2k con auto. La somma non utilizzata viene sbloccata al conguaglio.
Salva il risultato completo della separazione
Scarica insieme base, PNG trasparenti e dettagli di posizionamento. Annota anche l’istruzione facoltativa e il limite di output. Conserverai il collegamento tra grafica sorgente, file separati, nomi e ordine di sovrapposizione per la composizione successiva.
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.5/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"num_outputs": 10,
"output_format": "png",
"resolution": "auto"
}
}'
# 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.
