Seedream 5.5

Usa il modello doubao-seedream-5-5-261028 con POST https://apimaster.ai/v1/images/generations, un corpo JSON e Authorization: Bearer YOUR_API_KEY. Crea la tua chiave APIMaster nella console.

Supporta text-to-image, modifica con fino a dieci riferimenti, modifica successiva, output RGBA trasparente nativo, decomposizione in livelli e OCR di testo formattato. La generazione normale restituisce una singola immagine. La decomposizione restituisce una base e livelli separati. Lo streaming, la generazione sequenziale di immagini e la ricerca web non sono supportati. Usa l'endpoint sincrono; consenti almeno 300 secondi prima di un timeout del client ed evita reinvii ciechi.

Prezzi base ufficiali

Verificato rispetto ai prezzi di Volcengine il 2026-11-13. Il tasso di conversione configurato era di 7 CNY per USD.

Voce	CNY per immagine	Prezzo base approssimativo in USD
Ogni riferimento di input, incluso il primo	0.05	0.00714286
Output con larghezza × altezza ≤ 2,610,000 pixel	0.13	0.01857143
Output superiore a 2,610,000 pixel	0.23	0.03285714

La generazione e la decomposizione utilizzano le stesse tariffe di output. Addebita ogni base/livello separatamente utilizzando il suo effettivo data[].size; il lato più lungo non determina il livello. 2048x1024 è nel livello inferiore. Due input più un output di livello superiore costano CNY 0.33 prima dei moltiplicatori di account/canale. A differenza di Seedream 5.0 Pro, il primo riferimento non è gratuito. Gli addebiti effettivi dell'account includono i coefficienti applicabili di canale/gruppo utente e l'arrotondamento delle quote intere. Vedi la scheda del modello live e i log di utilizzo.

Da testo a immagine

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Parametri

Campo	Tipo / predefinito	Regole
model	stringa obbligatoria	doubao-seedream-5-5-261028.
prompt	stringa	Obbligatorio per la generazione; opzionale per la decomposizione. Descrivi contenuto, stile, proporzioni, testo o la posizione di modifica. Le linee guida ufficiali di scrittura raccomandano ≤300 caratteri cinesi o ≤600 parole inglesi; questa è una linea guida, non un limite di byte.
image	stringa o string[]	URL pubblico o data:image/png;base64,.... Fino a dieci riferimenti di generazione; esattamente un input per la decomposizione. I percorsi del filesystem locale non funzionano.
size	stringa	La generazione predefinita è 2K; 1K, 1.5K, 2K o esattamente WIDTHxHEIGHT. La decomposizione predefinita è auto, accetta solo auto e questi tre livelli.
output_format	stringa, png	png o jpeg. Per la decomposizione questo controlla solo la base; i livelli sono sempre PNG.
background	stringa, auto	auto, transparent o opaque, solo per la generazione. L'output trasparente richiede PNG; ometti completamente questo campo per la decomposizione.
response_format	stringa, url	url o b64_json. Leggi il campo corrispondente in ogni elemento data[].
watermark	booleano, true	Imposta false per omettere la filigrana visibile di generazione AI.
optimize_prompt_options	oggetto	Solo {"mode":"standard"} è supportato da 5.5; fast non è supportato.
layer_decomposition	booleano, false	Abilita la decomposizione di un'immagine PNG/JPEG.
layer_decomposition_options	oggetto	Opzioni di decomposizione di seguito.
layer_decomposition_options.max_images	intero, 30	2–100, inclusa la base. Un massimo, non un conteggio garantito.
layer_decomposition_options.text_recognition	booleano, false	Richiedi OCR di testo formattato per livelli di testo regolare.
safety_identifier	stringa	Identificatore utente stabile in inglese, al massimo 64 caratteri; usa un hash invece di informazioni di contatto personali.

Non utilizzare resolution, quality, n o seed di un altro modello per controllare questo modello. Questi non sono elencati come i suoi controlli di generazione corrispondenti nell'API ufficiale. Imposta i limiti di decomposizione con layer_decomposition_options.max_images.

Dimensioni e restrizioni di input

Per la generazione ordinaria, scegli un livello (1K, 1.5K, 2K) e descrivi le proporzioni nel prompt, oppure fornisci dimensioni esatte. L'area di output esatta deve essere 921,600–4,624,220 pixel, con proporzioni 1:16–16:1, soddisfacendo entrambi i vincoli. 2880x1440 è valido; 512x512 è troppo piccolo. Non esiste un livello 4K.

La decomposizione non accetta dimensioni esatte. Con auto, le dimensioni di base/livello all'interno dell'intervallo supportato mantengono le loro dimensioni originali ove possibile; gli elementi più piccoli/più grandi si ridimensionano verso 1K/2K preservando le loro proporzioni. I livelli restituiti possono occupare livelli di fatturazione diversi.

Vincolo di input	Generazione/modifica	Decomposizione
Conteggio	Fino a 10	Esattamente 1
Formati	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Dimensione file per immagine	≤30 MB	≤30 MB
Area in pixel	196–36,000,000; entrambi i lati >14 px	262,144–36,000,000
Proporzioni	1:16–16:1	1:16–16:1

Usa tipi MIME minuscoli negli URL dei dati. Gli URL di input remoti devono essere accessibili al servizio.

Modifica e immagini trasparenti

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Per un input, image può essere una stringa. Per modifiche successive, passa esplicitamente l'output precedente come input successivo: questa non è una conversazione con stato, e ogni richiesta viene fatturata separatamente. Descrivi coordinate/riquadri/frecce nel prompt o disegna segni sul riferimento; non esiste un parametro di posizionamento mask documentato separato per questa interfaccia.

Per la generazione trasparente nativa, ometti image se non necessario e imposta background: "transparent", output_format: "png", con un prompt come “una farfalla di vetro blu traslucido, asset isolato, sfondo trasparente”. La modifica può utilizzare fino a dieci riferimenti; non devono necessariamente avere già canali alfa. transparent più jpeg non è valido. Il background di una risposta descrive la trasparenza effettiva (transparent o opaque).

Decomposizione e OCR di testo formattato

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Supporta una base più fino a 99 livelli. max_images: 4 include la base. Ometti background; ogni livello è PNG trasparente. Il fallimento di un singolo livello fa fallire l'intera richiesta invece di restituire un successo parziale.

Leggi tutte le voci data[]:

• url/b64_json, size e output_format identificano l'artefatto e le sue dimensioni effettive; background è disponibile ove applicabile.
• z_index: 0 identifica la base; gli indici più grandi appaiono sopra quelli più piccoli.
• name e description descrivono il livello.
• bounding_box.absolute è [left,top,right,bottom] in pixel della base di output. Ridimensiona un livello a (right-left) × (bottom-top) e posizionalo a (left,top); le dimensioni del file del livello possono differire dalla sua impronta sulla tela.
• bounding_box.normalized utilizza coordinate 0–1000. Moltiplica le coordinate orizzontali/verticali per la larghezza/altezza della tela di destinazione e dividi per 1000.
• text_recognition appare solo quando richiesto e il livello contiene testo regolare riconosciuto. Scrittura a mano, lettering artistico e livelli non di testo possono ometterlo.

L'OCR contiene text e lines[]; ogni riga ha il proprio bounding_box e runs[] formattato. Ogni run ha text e style, che possono contenere similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow e translucent. Queste sono interpretazioni visive approssimative, non proprietà esatte del design originale; il riconoscimento dei font può restituire unknown.

Risposta, archiviazione e fallimenti

La risposta contiene created, model, data[], usage.input_images e usage.generated_images. Il conteggio generato include base e livelli. Conserva i metadati completi della risposta. Gli URL di download originali del provider scadono dopo 24 ore; scarica/archivia prontamente i tuoi asset.

Correggi dimensioni non valide, conteggi di riferimenti o opzioni di trasparenza incompatibili prima di riprovare. Gestisci autenticazione, autorizzazioni, moderazione, limiti di velocità e fallimenti a monte separatamente; non interpretare mai un errore come una generazione riuscita. I limiti IPM contano le immagini generate per account/versione del modello; la decomposizione riserva max_images e restituisce la capacità inutilizzata dopo il completamento, mentre la fatturazione utilizza le immagini effettivamente prodotte.

Fonti ufficiali: Seedream 5.5, API di generazione immagini, prezzi. Parametri verificati il 2026-11-13.