ByteDance
Seedream 4.5
seedream-4.5/image-to-image
Modello di immagini di livello commerciale di ByteDance, incentrato su illuminazione cinematografica, coerenza dei personaggi tra diverse inquadrature e modifica con riferimento a più immagini, ideale per immagini ad alta risoluzione destinate a e-commerce e materiali di marketing
Prova seedream-4.5/image-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
seedream-4.5/image-to-image per image
| Prezzo unitario | $0.045 |
|---|
Panoramica del posizionamento
Linea di editing immagini Seedream 4.5, pensata per gli sviluppatori che necessitano di una riscrittura controllata a partire da materiali esistenti. Riceve da 1 a 14 immagini di riferimento e un'istruzione di editing, e produce immagini a risoluzione 2K o 4K, con proporzioni selezionabili da 1:1 a 21:9. Ideale per flussi di lavoro di generazione immagini in batch nel settore e-commerce, marketing e concept cinematografico: occorre mantenere personaggi, prodotti o scene presenti nelle immagini di riferimento, adattando al contempo i dettagli dell'immagine secondo istruzioni testuali, per ottenere immagini ad alta risoluzione direttamente utilizzabili per la consegna.
Punti salienti
- Flusso di editing guidato da più immagini di riferimento — è possibile inviare fino a 14 immagini di riferimento in una sola volta, per fondere più elementi o mantenere la coerenza del soggetto prima di riscrivere l'immagine secondo le istruzioni.
- Risoluzione nativa 2K e 4K selezionabile — la risoluzione di output viene specificata direttamente nei parametri; il livello 4K è pensato per scenari di consegna commerciale che richiedono immagini ad alta risoluzione.
- Proporzioni che coprono formati orizzontali, verticali e panoramici — supporta otto formati tra cui 1:1, 4:3, 16:9 e 21:9; il layout può essere bloccato già prima della generazione, riducendo i ritagli successivi.
Descrizione delle capacità
Riscrittura dell'immagine guidata da istruzioni: si descrive l'effetto desiderato con un'istruzione di editing lunga fino a 3000 caratteri; il modello completa la riscrittura preservando il contenuto delle immagini di riferimento, riducendo i costi di iterazione dovuti a ridisegni ripetuti.
Fusione di più immagini e continuità del soggetto: con 1-14 immagini di riferimento in input simultaneo è possibile combinare più materiali in un'unica immagine, oppure mantenere forma e resa di personaggi e prodotti coerenti tra più inquadrature.
Risoluzione e formato selezionabili: l'output supporta due livelli, standard 2K e ultra HD 4K, e con otto rapporti d'aspetto produce direttamente immagini conformi ai requisiti di posizionamento e impaginazione.
Rendering del testo nell'immagine: buona capacità di riproduzione di etichette e testi presenti nell'immagine, adatta alla generazione di materiali in cui il testo deve essere leggibile.
Scenari applicativi
- Operazioni e-commerce: cambio di scenario con foto reali del prodotto — inserendo l'immagine di riferimento del prodotto e la descrizione dello scenario si producono immagini di scena del prodotto da più angolazioni, per pagine di dettaglio e materiali pubblicitari.
- Design marketing: estensione dei materiali a partire dalla key visual — prendendo come riferimento una key visual esistente, si generano in batch materiali in formato orizzontale e verticale per canali interni e social media.
- Cinema e storyboard: generazione di immagini con continuità del personaggio — inviando l'immagine di riferimento del personaggio e le istruzioni di storyboard si producono inquadrature consecutive coerenti nell'aspetto, utili per storyboard e discussioni di concept design.
Limiti e suggerimenti per la scelta
Le immagini di riferimento devono essere link jpeg, png o webp accessibili pubblicamente, con dimensione massima di 10MB per immagine; SVG non è supportato. La lunghezza dell'istruzione è limitata tra 4 e 3000 caratteri; in caso di superamento è necessario ridurla. L'output 4K e la combinazione di più immagini di riferimento aumentano la latenza di generazione, rendendo la linea inadatta a scenari interattivi in tempo reale sensibili alla velocità di risposta. Se l'esigenza è generare da zero senza materiali di riferimento, occorre scegliere la linea text-to-image della stessa famiglia; se serve un output in forma non fotografica, questa linea non è applicabile.
Domande frequenti
Vedi tutte le domande →-
Qual è la differenza tra image-to-image e text-to-image in Seedream 4.5?
L'endpoint image-to-image utilizza l'immagine caricata come base per la modifica, ed è adatto per cambiare colori, sostituire lo sfondo, ricalibrare l'illuminazione, convertire lo stile e comporre più immagini; il text-to-image, invece, genera l'immagine da zero basandosi solo sul testo. Quando è necessario preservare il soggetto, la composizione o il testo all'interno dell'immagine, è consigliabile utilizzare il modello image-to-image corrente.
-
Quante immagini di riferimento supporta al massimo Seedream 4.5?
Ogni richiesta può caricare da 1 a 14 immagini JPEG, PNG o WebP, con una dimensione massima di 10 MB per file; SVG non è supportato. Per le attività con più immagini, è possibile specificare esplicitamente lo scopo di ciascuna immagine nel Prompt usando “image 1” e “image 2”; l'ordine deve corrispondere a quello dell'array image_urls.
-
Come viene tariffata la modifica delle immagini con Seedream 4.5? Il numero di immagini di riferimento influisce sul prezzo?
La tariffazione si basa sulle immagini di output generate con successo, non sul numero di immagini di riferimento. Attualmente 2K e 4K utilizzano la stessa tariffa pubblica; l'importo esatto è determinato dal prezzo in tempo reale nella pagina del modello e dal registro delle attività.
-
Come si può far sì che Seedream 4.5 preservi il soggetto, la composizione o il testo presente in un'immagine?
Nel prompt occorre indicare chiaramente sia "cosa deve cambiare" sia "cosa deve rimanere invariato", ad esempio il contorno del soggetto, l'angolazione della fotocamera, l'ombra di contatto, la disposizione del negozio o il testo calligrafico. Verifica prima il risultato nel Playground; per materiali con testo di marca e requisiti di impaginazione rigorosi, si consiglia di mantenere una fase di revisione manuale.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: seedream-4.5/image-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per seedream-4.5/image-to-image e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 4maxLength 3000Istruzione di modifica che descrive l'effetto visivo desiderato in output, lunghezza massima 3000 caratteri.
image_urlsarrayObbligatoriominItems 1maxItems 14Array di immagini di riferimento in input, supporta da 1 a 14 immagini; ciascuna deve essere un URL accessibile pubblicamente, in formato jpeg/png/webp, con dimensione massima di 10MB per immagine; SVG non supportato.
Array [ string ]
resolutionstringObbligatorioPredefinito: "2K"Risoluzione dell'immagine di output; 2K è la qualità standard, 4K è ultra HD; predefinito 2K.
2K4Kaspect_ratiostringObbligatorioPredefinito: "1:1"Rapporto larghezza-altezza dell'immagine generata; predefinito 1:1.
1:14:33:416:99:162:33:221:9callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-4.5/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedream-4.5/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "seedream-4.5/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "2K",
"aspect_ratio": "1:1"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
FLUX.2 Black Forest Labs $0.035 /immagine -
BRIA Product Shot Bria $0.058 /immagine -
Ideogram V4.5 Ideogram $0.011 /immagine -
Recraft Crisp Upscale Recraft $0.004 /immagine -
Qwen Image 2.1 Alibaba $0.020 /immagine -
Krea 2 Medium Turbo Krea $0.021 /immagine -
Seedream 5.0 ByteDance $0.025 /immagine -
Nano Banana Google $0.021 /immagine -
Recraft V4.1 Recraft $0.010 /immagine -
Muse Image 1.0 Meta $0.015 per task -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Google Virtual Try-On Google $0.107 /immagine







