# Seedream 5.0 Pro (https://wanapi.app/it/docs/seedream-5-0-pro)
Seedream 5.0 Pro genera un'immagine da un prompt, modifica o combina fino a 10 immagini di riferimento e scompone un'immagine in un'immagine di base più un massimo di 16 livelli trasparenti. L'output è a 1K, 1.5K, 2K o con dimensioni esatte in pixel. [Dettagli del modello e Playground](/it/models/seedream-5-0-pro).
## Collegarsi a Wan API [#collegarsi-a-wan-api]
Usa `https://api.wanapi.app` come URL di base dell'API. Crea una chiave con la famiglia di modelli **Wan** nelle [impostazioni delle chiavi API](/it/settings/apikeys) e inviala come `Authorization: Bearer YOUR_API_KEY`. Conserva le chiavi sul tuo server. Il Playground usa la sessione del sito e addebita lo stesso saldo dell'account.
`GET /v1/models` elenca i modelli disponibili per la tua chiave. Seedream 5.0 Pro usa l'API OpenAI Images: `POST /v1/images/generations` con JSON oppure `POST /v1/images/edits` con JSON o caricamenti multipart. La richiesta restituisce la risposta quando l'immagine è pronta; non ci sono attività da interrogare periodicamente.
| Impostazione | Seedream 5.0 Pro |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| ID modello | `bytedance/seedream-5.0-pro` |
| `size` | `1K`, `1.5K`, `2K` (predefinito) oppure `WIDTHxHEIGHT` con 921.600–4.624.220 pixel e un rapporto d'aspetto da 1:16 a 16:1. |
| `image` | Fino a 10 immagini di riferimento. |
| Output | Un'immagine per richiesta oppure un'immagine di base più un massimo di 16 livelli con `layer_decomposition`. |
## Generare un'immagine [#generare-unimmagine]
Imposta `WAN_API_KEY` con la tua chiave sul server. Invia la richiesta una sola volta; la generazione termina di solito entro un minuto, quindi imposta un timeout del client di almeno quattro minuti.
```bash
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'
```
La risposta segue il formato OpenAI Images. I valori di esempio sono illustrativi:
```json
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}
```
Gli URL delle immagini restano disponibili per 30 giorni. Salva i file nel tuo spazio di archiviazione se ti servono più a lungo. Invia `"response_format": "b64_json"` per ricevere anche ogni immagine in Base64 in `b64_json`.
## Prezzi di Seedream 5.0 Pro [#prezzi-di-seedream-50-pro]
Ogni immagine generata viene addebitata in base alle dimensioni in pixel, con uno sconto del 30% sulla tariffa ufficiale: fino a 2,61 milioni di pixel (1K e 1.5K) si applica la tariffa inferiore, alle immagini più grandi la tariffa superiore. La prima immagine di riferimento è gratuita; per ogni immagine di riferimento aggiuntiva si applica la tariffa dei riferimenti. Una richiesta rifiutata prima che venga generata un'immagine non viene addebitata.
La scomposizione in livelli addebita l'immagine di base e ogni livello restituito. Quando tutte le immagini restituite non superano 2,61 milioni di pixel, ciascuna costa il 30% in meno rispetto alla tariffa ufficiale dei livelli. Quando un'immagine restituita è più grande, come accade sempre a `2K`, tutte le immagini vengono addebitate alla tariffa ufficiale dei livelli per le rispettive dimensioni. Il tuo saldo deve coprire il massimo di 17 immagini; paghi solo le immagini restituite.
## Campi della richiesta [#campi-della-richiesta]
Invia un oggetto JSON. `model` è obbligatorio; `prompt` è obbligatorio a meno che `layer_decomposition` non sia `true`. I campi sconosciuti vengono rifiutati.
| Campo | Tipo | Specifica |
| ------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | string | Obbligatorio: `bytedance/seedream-5.0-pro`. |
| `prompt` | string | Cosa generare oppure quali elementi separare nella scomposizione in livelli. Supporta inglese, cinese e altre lingue; mantenerlo sotto circa 600 parole in inglese dà i risultati migliori. |
| `image` | string o string\[] | Fino a 10 immagini di riferimento come URL HTTP(S) o `data:image/;base64,...` con il formato in minuscolo. Formati: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF; fino a 30 MB ciascuna; rapporto d'aspetto da 1:16 a 16:1. |
| `size` | string | Generazione di immagini: `1K`, `1.5K`, `2K` (predefinito) o `WIDTHxHEIGHT`. Scomposizione in livelli: `1K`, `1.5K`, `2K` o `auto` (predefinito). |
| `layer_decomposition` | boolean | Valore predefinito: `false`. `true` scompone esattamente un'immagine PNG o JPEG in un'immagine di base e fino a 16 livelli. |
| `optimize_prompt_options` | object | `{"mode": "standard"}` (predefinito) o `{"mode": "fast"}`. La modalità fast riduce i tempi di generazione con una qualità leggermente inferiore. |
| `output_format` | string | `jpeg` (predefinito) o `png`. Nella scomposizione in livelli imposta il formato dell'immagine di base; i livelli sono sempre PNG. |
| `background` | string | `opaque` (predefinito) o `transparent`. La trasparenza richiede esattamente un'immagine di input con canale alfa e output PNG; non è possibile combinarla con la scomposizione in livelli. |
| `watermark` | boolean | Valore predefinito: `true`; aggiunge una piccola etichetta che segnala un contenuto generato con IA. Invia `false` per rimuoverla. |
| `nsfw_checker` | boolean | Il valore predefinito `true` mantiene attivo il controllo dei contenuti. `false` invia la richiesta senza quel controllo; il prezzo è lo stesso. |
| `response_format` | string | `url` (predefinito) o `b64_json`. |
| `n` | integer | Facoltativo; deve essere `1`. |
`stream`, `sequential_image_generation`, `tools`, `seed`, `guidance_scale` e `mask` non sono supportati da questo modello e vengono rifiutati.
## Modificare e combinare immagini di riferimento [#modificare-e-combinare-immagini-di-riferimento]
Passa un'immagine con un'istruzione di modifica oppure più immagini da combinare:
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}
```
`POST /v1/images/edits` accetta gli stessi campi. Con multipart, carica i file nei campi `image` o `image[]` e invia `optimize_prompt_options` come stringa JSON.
## Scomposizione in livelli [#scomposizione-in-livelli]
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "2K"
}
```
La risposta elenca prima l'immagine di base. Ogni livello aggiunge il proprio ordine di sovrapposizione, la posizione e la descrizione:
```json
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}
```
Se la generazione di un livello non riesce, l'intera richiesta non riesce. Se il prompt richiede un numero di livelli superiore al limite, parte del contenuto dei livelli potrebbe essere omessa.
## Errori [#errori]
Gli errori usano la struttura OpenAI `{"error": {"message", "type", "code"}}`.
| HTTP | `code` | Significato |
| ---- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| 400 | `invalid_request` o un messaggio di validazione | Un campo o una combinazione non sono supportati. Correggi la richiesta; non è stato addebitato nulla. |
| 400 | `content_policy_violation` | Il prompt, un'immagine di input o l'output sono stati rifiutati in base alle norme sui contenuti. Non è stato addebitato nulla. |
| 402 | quota insufficiente | Aggiungi fondi prima di inviare di nuovo. |
| 429 | `rate_limited` | Troppe richieste. Riprova più tardi. |
| 502 | `submission_unknown` | Il risultato non è stato ricevuto e la richiesta non è stata addebitata. Controlla il registro dei consumi prima di inviarla di nuovo. |
| 503 | `upstream_unavailable` | La generazione di immagini è temporaneamente non disponibile; la richiesta non è stata addebitata. |
Non ripetere mai automaticamente una richiesta dopo un timeout senza aver prima controllato il registro dei consumi.