ByteDance

Seedream 4.5

seedream-4.5/text-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

seedream-4.5/image-to-image seedream-4.5/text-to-image

Prova seedream-4.5/text-to-image

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

seedream-4.5/text-to-image per image

Prezzo unitario	$0.045

Panoramica e posizionamento

La linea text-to-image di Seedream 4.5 è pensata per sviluppatori che necessitano di output visivi controllabili e riutilizzabili, generando immagini in stile realistico direttamente da un prompt testuale. Supporta due risoluzioni native, 2K e 4K, e otto rapporti d'aspetto da 1:1 a 21:9, con un limite di 3000 caratteri per il prompt. È adatta a task di generazione batch come immagini di prodotto per l'e-commerce, materiali di marketing, concept per cinema e design, dove qualità e composizione hanno requisiti precisi; l'integrazione nei flussi di generazione esistenti avviene tramite l'interfaccia unificata di HiAPI.ai.

Punti di forza principali

Output nativo diretto in 2K/4K ad alta risoluzione——è possibile scegliere l'uscita standard 2K o ultra HD 4K, eliminando il passaggio di upscaling dopo la generazione a bassa risoluzione.
Otto rapporti d'aspetto per i formati più diffusi——dal quadrato 1:1 al formato largo 21:9, specificabili direttamente, per adattarsi a layout diversi come e-commerce, social media e banner.
Illuminazione cinematografica e resa realistica——secondo le ricerche, simula la nebbia volumetrica e le ombre complesse della fotografia reale, con un risultato finale più vicino a uno scatto autentico.
Prompt più lunghi per descrizioni complesse——il limite di 3000 caratteri consente di descrivere in una singola richiesta scena, materiali e relazioni spaziali.

Descrizione delle capacità

Generazione text-to-image realistica: basta inserire una descrizione testuale per ottenere un'immagine in stile realistico, trasformando direttamente l'idea creativa in un elaborato visivo consegnabile, riducendo i costi di disegno manuale o di ripresa fotografica.

Risoluzione e formato controllabili: tramite i parametri resolution e aspect_ratio si specificano output 2K o 4K e otto rapporti larghezza-altezza; una singola chiamata restituisce un'immagine adatta al formato di destinazione, senza necessità di ritagli successivi.

Interpretazione di prompt complessi: prompt fino a 3000 caratteri possono contenere descrizioni stratificate di scena, soggetto e composizione; secondo le ricerche, questa versione migliora rispetto alla precedente nell'aderenza al prompt e nell'accuratezza dei dettagli.

Qualità di livello commerciale: le ricerche indicano che illuminazione, resa della pelle e rendering del testo sono vicini alla resa fotografica, adatti a una consegna diretta al cliente e non solo a bozze.

Scenari d'uso

Operazioni e-commerce: generazione batch di immagini di scena per prodotti——descrivendo con testo il prodotto e l'atmosfera della scena si producono immagini principali e di contesto ad alta risoluzione pubblicabili, per pagine di dettaglio prodotto e materiali pubblicitari.
Team marketing: poster promozionali con testo——inserendo requisiti di layout e copy si generano poster e banner con testo nitido e leggibile, utilizzabili direttamente sui social e negli spazi pubblicitari.
Cinema e gaming: concept e storyboard——generazione batch a partire da copioni o descrizioni di ambientazione per produrre concept design e tavole di storyboard, utili alle discussioni preliminari e alla definizione della direzione artistica.
Team di design: elaborati visivi multi-formato——grazie ai vari rapporti d'aspetto e alle risoluzioni 2K/4K si producono rapidamente elaborati adatti a terminali diversi, per presentazioni al cliente e iterazioni.

Limiti e consigli di scelta

Questa linea accetta solo input testuali; per modificare immagini esistenti o comporre con riferimenti occorre usare la linea image-to-image della stessa serie. Le ricerche segnalano che la generazione a livello 4K richiede molta potenza di calcolo e tempi più lunghi: per scenari sensibili alla latenza è necessario valutare il costo di attesa. Le capacità descritte sono per lo più miglioramenti rispetto a Seedream 4.0 e mancano confronti indipendenti con altri modelli contemporanei; in fase di scelta si consiglia di testare l'effettiva resa con campioni del proprio business prima di decidere.

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

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-4.5/text-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per seedream-4.5/text-to-image e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 4maxLength 3000

Prompt testuale che descrive il contenuto dell'immagine da generare, in formato stringa, lunghezza massima 3000 caratteri.

resolutionstringObbligatorioPredefinito: "2K"

Livello di nitidezza dell'immagine di output, in formato stringa; 2K è la qualità standard, 4K è ultra HD; predefinito 2K.

Opzioni:2K4K

aspect_ratiostringObbligatorioPredefinito: "1:1"

Rapporto di aspetto dell'immagine generata, in formato stringa; predefinito 1:1.

Opzioni:1:14:33:416:99:162:33:221:9

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-4.5/text-to-image",
  "input": {
    "prompt": "…",
    "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/text-to-image",
    input: {
      "prompt": "…",
      "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/text-to-image",
        "input": {
          "prompt": "…",
          "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à

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