ByteDance

Seedream 5.0

seedream-5.0-flash

Modello di generazione di immagini di livello produttivo di ByteDance, che supporta ricerca online e ragionamento logico in più passaggi, output in 4K e modifica basata su esempi, ideale per la creazione di immagini di prodotto e infografiche

seedream-5.0-flash seedream-5.0-lite/image-to-image seedream-5.0-lite/text-to-image seedream-5.0-pro/image-to-image seedream-5.0-pro/text-to-image

Prova seedream-5.0-flash

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

seedream-5.0-flash per image

Prezzo unitario	$0.025

Panoramica e posizionamento

Seedream 5.0 Flash è il modello di generazione immagini rapido della serie Seedream 5.0 di ByteDance e supporta sia la generazione da testo sia la generazione da immagine. Accetta fino a 10 immagini di riferimento, consente di specificare dimensioni 1K, 1.5K, 2K o larghezza e altezza personalizzate, e supporta lo sfondo trasparente e la scelta del formato di output JPEG/PNG. È adatto agli sviluppatori che necessitano di produrre in serie immagini di prodotto, materiali di marketing e visual di serie; tramite l'interfaccia unificata di HiAPI.ai è possibile integrarlo e completare generazione e modifica con immagini di riferimento e prompt.

Punti di forza principali

Generazione da immagine con più riferimenti — è possibile inviare un singolo URL, una stringa Base64 o un array di massimo 10 immagini, usando un insieme di riferimenti per vincolare personaggi, stile e composizione.
Controllo flessibile delle dimensioni di output — supporta preset 1K, 1.5K, 2K oppure larghezza e altezza personalizzate, con rapporti d'aspetto da 1:16 a 16:1, adatti a materiali orizzontali e verticali.
Output opzionale con sfondo trasparente — durante la modifica di una singola immagine è possibile specificare lo sfondo trasparente e produrre in PNG, così da sovrapporre direttamente il materiale a un layout o a una pagina.
Interruttore di ottimizzazione del prompt — integra una modalità standard di ottimizzazione del prompt che migliora la stabilità della generazione senza modificare la logica delle chiamate.

Descrizione delle capacità

Doppio percorso testo-immagine e immagine-immagine: genera un'immagine solo da un prompt oppure, combinando immagini di riferimento, indica posizione e contenuto delle modifiche; un'unica interfaccia copre la creazione di nuovi materiali e la modifica di immagini esistenti.

Riferimenti multipli e fusione: la generazione da immagine supporta fino a 10 immagini di riferimento, di cui è possibile specificare nel prompt il ruolo di ciascuna, per uniformare lo stile e combinare più elementi.

Output con dimensioni e formato controllabili: è possibile specificare da 1K a 2K o larghezza e altezza personalizzate, con output JPEG o PNG; in caso di modifica con sfondo trasparente l'input viene automaticamente vincolato a una singola immagine e al formato PNG.

Interruttore della filigrana di generazione: il parametro watermark è disattivato per impostazione predefinita ed è possibile attivare esplicitamente la filigrana di generazione AI, per adeguarsi ai requisiti di conformità dei diversi canali di pubblicazione.

Scenari di utilizzo

Produzione in serie di immagini di prodotto per sviluppatori e-commerce — usando le foto reali del prodotto come riferimento e un prompt, si generano versioni con sfondi e composizioni diversi, ottenendo materiali direttamente utilizzabili nelle pagine di dettaglio e nelle campagne.
Estensione di visual di serie per team di marketing — inviando un'immagine di riferimento del visual principale e descrivendo i requisiti delle varianti, si producono in serie poster, banner e altri materiali con dimensioni e stile coerenti.
Chiamate contestuali di immagini in strumenti di design — all'interno del prodotto è possibile chiamare l'interfaccia con input testuali o immagini, offrendo agli utenti la possibilità di generare e modificare immagini in tempo reale.

Limiti e suggerimenti per la scelta del modello

In quanto modello Flash, è orientato alla generazione di immagini ordinarie e alla modifica con immagini di riferimento, con una dimensione massima di output di 2K e nessuna opzione per risoluzioni superiori. Lo sfondo trasparente è limitato alla modifica di una singola immagine e richiede obbligatoriamente l'output PNG, quindi negli scenari con più immagini di riferimento in batch questa funzione non può essere usata contemporaneamente. Se servono risoluzioni più elevate, infografiche complesse o modifiche di precisione a livello di pixel, è opportuno valutare le versioni più potenti della stessa serie; anche per scenari con requisiti di qualità molto elevati e tempi di attesa più lunghi è consigliabile una valutazione dedicata della scelta del modello.

Novità

Vedi il changelog →

Nuovo modello seedream-5.0-pro/image-to-image è ora disponibile Nov 3, 2026
Nuovo modello Nuovo modello disponibile: seedream-5.0-pro/text-to-image Nov 3, 2026
Nuovo modello Il modello text-to-image seedream-5.0-lite è ora disponibile Nov 3, 2026

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: seedream-5.0-flash

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per seedream-5.0-flash e la route default — vedi la tabella dei parametri sotto.

sizestringOpzionalePredefinito: "2K"pattern ^(1K|1\.5K|2K|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$

Controlla le dimensioni dell'immagine generata; è possibile specificare 1K, 1.5K, 2K oppure una dimensione personalizzata nel formato "larghezzaxaltezza"; per le dimensioni personalizzate il numero totale di pixel deve essere compreso tra 921600 e 4624220 e il rapporto larghezza/altezza deve essere compreso tra 1:16 e 16:1. Il valore predefinito è 2K.

imageanyOpzionaleminLength 1minItems 1maxItems 10pattern ^(https?://|data:image/)

Input immagine di riferimento: è possibile passare un singolo URL, un'immagine Base64 o un array di massimo 10 immagini, utilizzate per guidare la generazione o la modifica. Obbligatorio quando background è impostato su transparent.

promptstringObbligatoriominLength 1maxLength 5000

Descrive il contenuto dell'immagine che si desidera generare; se usato insieme a un'immagine di riferimento, può indicare le posizioni e i contenuti da modificare.

watermarkbooleanOpzionalePredefinito: false

Controlla se aggiungere all'immagine di output la filigrana di generazione AI; passare true per attivarla. Disattivata per impostazione predefinita (false).

backgroundstringOpzionalePredefinito: "opaque"

Controlla il tipo di sfondo dell'output; il valore predefinito è opaque (opaco); se impostato su transparent si applica solo alla modifica di una singola immagine con canale di trasparenza e il formato di output deve essere PNG o non specificato.

Opzioni:opaquetransparent

output_formatstringOpzionale

Specifica il formato file dell'immagine di output; se omesso è solitamente JPEG, mentre con sfondo trasparente è PNG. Quando background è transparent è supportato solo png.

Opzioni:jpegpng

optimize_prompt_optionsobjectOpzionale

Gruppo di impostazioni per l'ottimizzazione del prompt, che controlla le opzioni relative all'ottimizzazione del prompt.

modestringOpzionalePredefinito: "standard"

Controlla la modalità di ottimizzazione del prompt; utilizza la modalità di ottimizzazione standard. Il valore predefinito è standard.

Opzioni:standard

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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-5.0-flash",
  "input": {
    "size": "2K",
    "prompt": "…",
    "watermark": false,
    "background": "opaque"
  }
}'

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-5.0-flash",
    input: {
      "size": "2K",
      "prompt": "…",
      "watermark": false,
      "background": "opaque"
    }
  }),
});
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-5.0-flash",
        "input": {
          "size": "2K",
          "prompt": "…",
          "watermark": False,
          "background": "opaque"
        }
    },
)
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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}