LogoDocumentazione Wan API
Pagina iniziale
X (Twitter)
Pagina iniziale

Per iniziare

PanoramicaGuida all’integrazioneControlla il saldoElimina un’attività

Modelli Wan

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Modelli Seedance

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modelli per immagini

Seedream 5.0 ProAPI Seedream 5.5

Modelli linguistici

API ClaudeClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2API GPTGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

API Seedream 5.5

Genera, modifica o scomponi immagini con Seedream 5.5. Parametri di richiesta, attività asincrone, metadati delle immagini e prezzi attuali per immagine.

Seedream 5.5 genera un'immagine da testo o da fino a 10 immagini di riferimento. La scomposizione in livelli riceve un'immagine e restituisce una base più livelli trasparenti, con un risultato facoltativo di riconoscimento del testo stampato.

Prova il Playground · JSON OpenAPI · Tutorial di integrazione

Autenticazione ed endpoint

Usa la tua chiave Wan API come token Bearer. Una chiave accede a tutti i modelli e gruppi disponibili; non selezioni un gruppo sulla chiave.

MetodoURLScopo
POSThttps://api.wanapi.app/seedream55/v1/images/generationsInvia un'attività immagine
GEThttps://api.wanapi.app/seedream55/v1/tasks/{id}Leggi l'attività

L'ID modello è seedream-5-5. Questi endpoint sono asincroni. Invia una sola volta, salva l'ID attività ed esegui il polling fino a completed o failed. Una risposta di rete incerta non autorizza un nuovo invio.

Genera un'immagine

curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'

Una richiesta accettata restituisce un'attività anziché i byte dell'immagine:

{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"

Esegui il polling dello stesso ID ogni pochi secondi. Conservalo se l'applicazione smette di attendere, così potrà riprendere in seguito. Gli ID attività e i timestamp di questa guida sono illustrativi.

Parametri

ParametroTipoPredefinitoRegole
modelstringaobbligatorioseedream-5-5
promptstringaobbligatorio per la generazioneFacoltativo per la scomposizione in livelli.
imageURL o array di URLnessunoFino a 10 riferimenti; esattamente uno per i livelli. Ogni riferimento viene addebitato.
sizestringa2K, o auto per i livelliVedi le regole sulle dimensioni sotto.
output_formatstringapngpng o jpeg. Per i livelli controlla solo l'immagine di base.
backgroundstringaautoauto, opaque, transparent. La trasparenza richiede PNG. Ometti completamente questo campo nella modalità livelli.
layer_decompositionbooleanofalseSepara un riferimento in un'immagine di base e livelli PNG trasparenti.
layer_decomposition_options.max_imagesintero30Limite totale di 2–100 immagini, base inclusa. Solo per la modalità livelli.
layer_decomposition_options.text_recognitionbooleanofalseRichiedi metadati del testo stampato nei livelli. Solo per la modalità livelli.
optimize_prompt_options.modestringastandardL'unica modalità supportata è standard.
watermarkbooleanofalseRichiedi una filigrana di contenuto generato con IA.
content_filterbooleanotrueL'API clienti accetta false. Nel Playground solo gli amministratori possono disattivarlo.

I parametri n, seed, stream, resolution, aspect_ratio, image_urls e response_format non sono supportati. I campi non documentati vengono scartati e non attivano queste funzioni. Caricamenti multipart, Base64 e URI data vengono rifiutati.

Dimensioni di output

La generazione accetta 1K, 1.5K, 2K o dimensioni esatte in pixel WIDTHxHEIGHT. Le dimensioni esatte devono totalizzare 921.600–4.624.220 pixel e avere un rapporto d'aspetto da 1:16 a 16:1. Per esempio, 2048x1152 è valido. Un rapporto come 16:9 non è un valore di dimensione.

La scomposizione in livelli accetta auto, 1K, 1.5K o 2K; questa modalità non supporta dimensioni esatte in pixel. auto segue l'input e riserva la tariffa di output superiore. Il modello non offre dimensioni predefinite 3K o 4K.

Immagini di riferimento e modifica

Fornisci URL HTTP(S) pubblici ospitati da te, senza credenziali incorporate. I formati supportati sono JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF, fino a 30 MB per immagine e al massimo 36.000.000 pixel totali. AVIF e JP2 non sono supportati. Un URL deve fornire direttamente un'immagine senza accesso o verifica del browser.

{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}

Per più riferimenti, passa un array di URL e spiega il ruolo di ciascuna immagine nel prompt. Il risultato resta una sola immagine. Gli URL di riferimento negli esempi sono segnaposto: sostituiscili con i tuoi file raggiungibili.

Scomposizione in livelli e riconoscimento del testo

{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}

Il limite include l'immagine di base; 4 significa al massimo quattro immagini restituite, non quattro livelli più una base. Il modello può restituirne meno. Ometti prompt per la separazione automatica o indica gli elementi da separare. Un prompt può sopprimere il testo che esclude.

I livelli sono file PNG trasparenti. Ricostruisci l'immagine in ordine z_index crescente, con la base a 0. Se viene fornito un riquadro di delimitazione, ridimensiona il livello a quel riquadro prima di posizionarlo: le dimensioni in pixel del file possono differire dalle dimensioni di posizionamento.

Il campo facoltativo text_recognition contiene il text completo e lines. Ogni riga può includere un bounding_box e segmenti runs con stile. Lo style di un segmento può includere similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow e translucent. Sono stime del modello. Scritte artistiche o manoscritte potrebbero non produrre testo; considera il campo facoltativo.

Risposta completata

{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}

Ogni immagine ha url e size. Altri campi possono includere output_format, background, z_index, name, description, bounding_box e text_recognition. bounding_box.absolute è [left, top, right, bottom] in pixel dell'immagine di base. bounding_box.normalized usa le stesse coordinate riportate sulla scala 0–1000. Non presumere che i metadati facoltativi esistano per ogni immagine.

Tratta gli URL delle immagini come link privati di download e salva i file necessari. Un URL con token access può essere aperto senza esporre la chiave API dell'account.

Prezzi

Immagine fatturabileUSD per immagine
Output fino a 2,61 MP (1K / 1.5K)0,017 USD
Output oltre 2,61 MP (2K)0,02975 USD
Ogni immagine di riferimento, inclusa la prima0,0068 USD

Le tariffe si aggiornano automaticamente. Una chiave API funziona con tutti i modelli e gruppi.

La soglia di pixel di output è 2.610.000 pixel. Calcola l'addebito così:

lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate

Ogni riferimento viene addebitato, inclusi il primo e l'immagine sorgente per i livelli. Generazione e livelli usano le stesse tariffe di output. L'invio riserva un output, oppure il limite max_images dei livelli, più i riferimenti. Il completamento usa le dimensioni in pixel proprie di ogni immagine restituita e rilascia la prenotazione inutilizzata. L'attività accettata mantiene la propria istantanea dei prezzi anche se cambiano durante l'esecuzione. Le attività fallite vengono rimborsate.

Errori e nuovi tentativi

I parametri non validi vengono rifiutati prima dell'invio. Saldo o quota della chiave insufficienti impediscono la generazione. I controlli di autenticazione e proprietà si applicano sia all'invio sia al polling. Un'attività fallita restituisce status: "failed" con un oggetto error.

Riprova una lettura dello stato fallita con lo stesso ID attività. Non ripetere automaticamente un POST di generazione, nemmeno dopo un timeout: potrebbe essere già stato accettato. Finché il sistema a monte segnala un avanzamento normale, l'attività resta in attesa. Un'attività senza stato normale a monte o consegna riuscita per tre ore consecutive fallisce e viene rimborsata.

Consulta il tutorial Seedream 5.5 per un ciclo applicativo che salva e riprende l'ID attività.

Seedream 5.0 Pro

Guida API di Seedream 5.0 Pro: da testo a immagine, modifica con riferimenti, livelli, PNG trasparenti, campi delle richieste, risposte e prezzi.

API Claude

Usa Claude con Anthropic Messages o OpenAI Chat Completions. ID dei modelli, esempi in streaming e prezzi di input, output e cache per gruppo.

Indice

Autenticazione ed endpointGenera un'immagineParametriDimensioni di outputImmagini di riferimento e modificaScomposizione in livelli e riconoscimento del testoRisposta completataPrezziErrori e nuovi tentativi