Guida all'API Seedream 5.0 Lite: generazione di immagini da testo e modifica delle immagini

Riepilogo dei contenuti

• Seedream 5.0 Lite è il modello di immagini di ByteDance. Su HiAPI ha due endpoint: seedream-5.0-lite/text-to-image e seedream-5.0-lite/image-to-image, entrambi a $0.035 per immagine, stesso prezzo per 2K o 4K.
• È particolarmente abile nel rendere il testo in modo preciso all'interno delle immagini e nelle modifiche mirate: cambiare un singolo oggetto, sostituire il testo su un'insegna o comporre fino a 14 immagini di riferimento mantenendo invariato il resto della scena.
• Ogni chiamata deve fornire aspect_ratio e resolution. Apri la pagina del modello text-to-image per provarlo; i nuovi account ricevono 200 crediti gratuiti.

Testo-immagine o immagine-immagine

	Testo-immagine	Immagine-immagine
ID modello	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
Campi obbligatori	prompt, aspect_ratio, resolution	Come sopra, più image_urls (1–14)
Prezzo	$0.035 per immagine	$0.035 per immagine, indipendentemente dal numero di immagini di riferimento
Casi d'uso	Poster, menu, packaging, infografiche	Cambio colore, sostituzione testo, composizione di prodotti in scena

Prezzo in tempo reale di HiAPI, verificato il 19 ottobre 2026. Le attività non riuscite non vengono addebitate.

Il 4K costa quanto il 2K, quindi richiedi direttamente il 4K quando ti servono dimensioni da stampa. Con $1 puoi generare circa 28 immagini.

Testo-immagine: resa accurata del testo

Metti tra virgolette ogni parola che vuoi venga renderizzata e specifica la posizione di ogni stringa:

Un poster in stile serigrafia disegnato a mano per un festival gastronomico notturno immaginario, grande titolo in calligrafia cinese "夜市食堂" in alto, sottotitolo inglese "NIGHT MARKET CANTEEN" subito sotto in un sans-serif condensato, riga con la data "OCT 17-19 · RIVERSIDE PIER" in basso, caldo bagliore di lanterne sui banchi di cibo affollati, vapore che sale dai cestini di bambù, palette limitata di vermiglio, crema e blu inchiostro, grana di stampa visibile, composizione da poster vintage

Genera questo poster →

seedream-5.0-lite/text-to-image, 2K, $0.035.

Il titolo in cinese, il sottotitolo in inglese e la riga con la data appaiono esattamente come scritti. Lo stesso schema vale per lavagne dei menu, cartellini dei prezzi e packaging; mantieni il testo entro circa sei righe. Per altri cinque schemi (incluso un menu con ogni prezzo corretto) vedi Ricette di prompt per Seedream 5.0 Lite.

Immagine-immagine: cambia una sola cosa, preserva il resto

Schema: una frase che descrive la modifica, poi elenca tutto ciò che deve restare invariato.

Cambio colore localizzato. Immagine originale:

Cambia questa tazza in ceramica bianca opaca in una tazza smaltata blu cobalto intenso, con riflessi lucidi, mantieni invariati il vapore, il tavolo di quercia, il quaderno aperto, la penna, la piantina grassa, l'illuminazione e l'angolazione della fotocamera, fotorealistico

seedream-5.0-lite/image-to-image, un'immagine di riferimento, 3:2, 2K, $0.035.

Sostituzione del testo su un'insegna.

Sostituisci il testo sull'insegna in legno sopra la porta con "BAKERY CORNER", mantenendo lo stesso stile di carattere dorato con grazie e la stessa dimensione, mantieni invariati la forma dell'insegna e la texture del legno, la facciata in mattoni, le finestre illuminate, l'olivo e la luce di una giornata nuvolosa, fotorealistico

seedream-5.0-lite/image-to-image, un'immagine di riferimento, 3:2, 2K, $0.035.

Composizione di due immagini. Fai riferimento alle immagini nell'ordine in cui compaiono in image_urls:

Prendi lo zaino in pelle della prima immagine e appoggialo sul masso piatto di granito nella scena del campeggio della seconda immagine, appoggiato naturalmente con una leggera angolazione, riluminalo per adattarlo alla calda luce dell'ora d'oro e proietta un'ombra morbida sulla roccia, mantieni invariati il cerchio di pietre per il fuoco, la pineta e le cime delle montagne, composizione fotorealistica

seedream-5.0-lite/image-to-image, due immagini di riferimento, 3:2, 2K, $0.035.

Imposta aspect_ratio in modo che corrisponda all'input. Se richiedi un formato diverso, parte dell'effetto della modifica viene consumata dal ritaglio.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

Riceverai un taskId. Esegui il polling di GET https://api.hiapi.ai/v1/tasks/{taskId} finché data.status non è success, poi scarica data.output[0].url. I link scadono, quindi salva subito il file.

Per eseguire una modifica, cambia il modello in seedream-5.0-lite/image-to-image e aggiungi "image_urls": ["https://your-cdn.example.com/input.jpg"].

Python: prima genera, poi modifica

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

Se prevedi di riutilizzare i risultati in seguito, scaricali subito non appena ciascuno è pronto; i link di output scadono.

Parametri

Campo	Obbligatorio	Valori	Descrizione
prompt	Sì	4–3.000 caratteri	Metti tra virgolette il testo da renderizzare
aspect_ratio	Sì	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	Per le modifiche, mantienilo coerente con l'input
resolution	Sì	2K, 4K	Maiuscolo; il prezzo è lo stesso
image_urls	Solo immagine-immagine	1–14 URL	jpeg, png o webp, massimo 10 MB ciascuna

Non esistono seed, negative_prompt né output_format.

Errori comuni

Gli errori seguenti vengono tutti restituiti al momento dell'invio con HTTP 400, quindi non creano attività e non comportano addebiti:

• aspect_ratio: missing required field / resolution: missing required field: entrambi sono obbligatori, anche se la documentazione elenca dei valori predefiniti.
• resolution: value must be one of '2K', '4K': non esiste 1K. Usa le maiuscole.
• image_urls: maxItems: got 15, want 14: massimo 14 immagini di riferimento.
• prompt: minLength: got 2, want 4: il prompt richiede almeno 4 caratteri.
• additional properties 'output_format' not allowed: questo campo non esiste su Lite.

Lite, Flash o Pro?

Modello	Prezzo per immagine	Caso d'uso
Seedream 5.0 Flash	$0.025	Quando contano di più volume e velocità
Seedream 5.0 Lite	$0.035 sia per 2K sia per 4K	Testo nelle immagini, modifiche di precisione, 4K senza costi aggiuntivi
Seedream 5.0 Pro	$0.05 (1K) / $0.10 (2K)	Quando gli asset finali richiedono il massimo dettaglio

Per un confronto con lo stesso prompt tra i due livelli più economici vedi Confronto tra Seedream 5.0 Flash e Lite. Per i prezzi completi vedi Prezzi dell'API Seedream 5.0.

Domande frequenti

Ogni immagine di riferimento ha un costo aggiuntivo?

No. Immagine-immagine costa $0.035 per output, indipendentemente dal fatto che invii 1 o 14 immagini di riferimento.

Può renderizzare testo in cinese?

Sì. Il poster qui sopra contiene sia un titolo in cinese sia un sottotitolo in inglese nella stessa immagine. Basta mettere tra virgolette ogni stringa e ancorarne la posizione.

Mantiene il mio prodotto esattamente identico?

Preserva ciò che elenchi. Elenca tutti gli elementi che devono restare invariati (forma, etichetta, illuminazione, angolazione della fotocamera); tutto ciò che non viene menzionato può cambiare.

Meglio 2K o 4K?

Il prezzo è lo stesso. Il 2K ha il lato lungo di circa 2.300 px, il 4K di circa 4.096 px. I file 2K sono più piccoli e più comodi da esaminare durante le iterazioni; passa al 4K quando ti serve la stampa.