Seedream 5.0 Pro

Seedream 5.0 Pro è il modello di immagini di ByteDance. Una richiesta crea un’immagine da un prompt, da un prompt più un massimo di 10 immagini di riferimento, oppure scompone un’immagine in un’immagine di fondo e fino a 16 livelli trasparenti. Invia la richiesta, conserva l’ID attività restituito e leggi le immagini finite dall’attività. Le immagini di riferimento vengono passate come URL.

ID modello

Consulta la pagina del modello per i prezzi attuali.

Esempio rapido

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Endpoint

POST https://api.seedrouter.ai/v1/images/generations

La risposta è un’attività ({"id": "task_...", "status": "processing"}), non l’immagine finita. Interroga GET /v1/tasks/{task_id} per ottenere il risultato. Conserva le chiavi API nel codice lato server. I riferimenti e la scomposizione in livelli vengono passati nella stessa richiesta tramite image; /v1/images/edits non viene usato per questo modello e restituisce 400.

Parametri

I campi non presenti in questo elenco vengono eliminati prima dell’inoltro della richiesta; non causano mai errori e non modificano mai l’output. n, stream, seed, response_format e la generazione sequenziale non sono disponibili. callback_url non è disponibile; interroga invece l’attività.

Dimensioni di output

Il livello di risoluzione imposta la scala e il prompt imposta le proporzioni. Indica le proporzioni in prompt (per esempio «un paesaggio in 16:9») e il modello sceglie l’inquadratura:

Per un’inquadratura fissa, invia dimensioni esatte in pixel invece di un livello di risoluzione. 1K e 1.5K costano uguale; 2K e qualsiasi dimensione oltre 2,61 milioni di pixel costano di più (vedi Fattori di costo).

Immagini di riferimento

Passa un’immagine per modificarla, oppure 2–10 per combinarle, e indica in prompt cosa conservare e cosa cambiare. Citale in base all’ordine («la giacca dell’immagine 1»).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Scomposizione in livelli

Invia esattamente un’immagine con layer_decomposition: true. L’attività restituisce prima l’immagine di fondo e poi ogni livello come PNG trasparente.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Ogni livello include z_index (l’immagine di fondo è 0; i numeri più alti si sovrappongono), name, description e bounding_box. bounding_box.absolute è [left, top, right, bottom] in pixel dell’immagine di fondo; bounding_box.normalized è lo stesso riquadro in millesimi della larghezza e dell’altezza dell’immagine di fondo. Per ricostruire l’immagine, ridimensiona ogni livello al suo riquadro e posizionalo sull’immagine di fondo in ordine crescente di z_index.

Con size: "auto" l’immagine di fondo e ogni livello mantengono le dimensioni che hanno nell’immagine di input. L’input deve essere PNG o JPEG con un numero totale di pixel (larghezza × altezza) compreso tra 262.144 (512 × 512) e 36.000.000 (6000 × 6000).

Sfondo trasparente

Invia un PNG con un canale alfa e background: "transparent" per ottenere un PNG con sfondo trasparente:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Input multimediali

Ogni riferimento è un URL HTTP(S) pubblico. I data URI in base64 non sono accettati: carica il file nel tuo storage e passa il suo URL. I formati accettati sono JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF, fino a 30 MB ciascuno, tra 1:16 e 16:1, con larghezza e altezza superiori a 14 pixel e al massimo 36.000.000 pixel in totale. La scomposizione in livelli accetta solo PNG o JPEG.

Fattori di costo

Consulta la sezione prezzi del modello per le tariffe attuali. Seedream 5.0 Pro ha un prezzo per immagine di output in base allo scenario e alla fascia di pixel, più ogni immagine di riferimento dopo la prima:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• La fascia inferiore copre le immagini fino a 2,61 milioni di pixel (1.5K e inferiori); tutto ciò che è più grande rientra nella fascia superiore.
• La scomposizione in livelli addebita l’immagine di fondo e ogni livello. L’intera richiesta usa una sola fascia: il prezzo inferiore si applica solo se ogni immagine restituita resta entro 2,61 milioni di pixel.
• L’importo riservato all’accettazione di un’attività copre il risultato massimo: un’immagine alla fascia richiesta, oppure 17 immagini per la scomposizione in livelli (auto conta come fascia superiore). L’attività viene poi addebitata per le immagini effettivamente restituite e la differenza viene sbloccata.

Consulta gli addebiti definitivi nella cronologia di utilizzo del tuo account. Le attività fallite non vengono addebitate.

Schema di output

L’invio restituisce l’attività:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Recuperare l’attività

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interroga ogni 10–20 secondi finché status non diventa completed o failed. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l’ID attività e riprendi il controllo. Non creare un’altra attività per verificare l’avanzamento.

Attività completata

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Un’attività di scomposizione in livelli elenca prima l’immagine di fondo e poi ogni livello:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

Nei nostri test un’immagine 1K ha richiesto circa 35–55 secondi e una scomposizione in livelli a 1K che ha restituito un’immagine di fondo più 13 livelli ha richiesto circa 140 secondi.

Errori

Le richieste rifiutate prima della creazione di un’attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un’attività che fallisce dopo l’accettazione restituisce HTTP 200 quando viene interrogata, con status: "failed" e un oggetto error.

Vedi il catalogo errori comune per codici, stati HTTP e indicazioni sui tentativi.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se l’invio stesso va in timeout, controlla le tue attività prima di inviare di nuovo: la prima richiesta potrebbe essere stata accettata.

Suggerimenti

• Inizia a 1K o 1.5K per fare prove; 1.5K costa quanto 1K.
• Indica le proporzioni nel prompt quando usi un livello di risoluzione, oppure invia dimensioni esatte in pixel per un layout fisso.
• Con più riferimenti, spiega cosa apporta ciascuno e citali in base all’ordine.
• Imposta watermark: false quando ti serve un’immagine senza filigrana; l’impostazione predefinita aggiunge una scritta.
• Per la scomposizione in livelli, elenca gli elementi da separare per mantenere basso il numero di livelli.

Correlati

• Playground e prezzi di Seedream 5.0 Pro
• Scarica l’OpenAPI
• Markdown copiabile