Claude Opus 5.5 è disponibile su SeedRouter

Tutorial su Kling Image 4.0 Long Image

Crea layout web e schede prodotto ecommerce 2K con Kling Image 4.0 Long Image: due generazioni PNG reali, richieste curl, polling e tariffe live.

Leggi in Markdown

I normali modelli di generazione immagini producono un solo fotogramma alla volta. Quando chiedi loro una scheda prodotto completa o un intero sito di lancio, finisci per generare sei banner scollegati e passare ore in un editor di layout a rincorrere margini disallineati, font che cambiano e prodotti fuori scala. Kling Image 4.0 Long Image lavora in modo diverso: una sola richiesta API restituisce un unico PNG verticale continuo strutturato dall’alto verso il basso, con larghezza fissa 1K (1024 px) o 2K (2048 px) e altezza determinata dalle sezioni del tuo brief.

Il 19 novembre 2026 abbiamo eseguito due job 2K tramite l’endpoint /v1/images/generations di SeedRouter per mettere alla prova entrambe le modalità con brief di produzione reali. Il primo test ha usato la modalità webpage da solo testo e ha restituito una pagina di lancio da 2048 × 16.385 px per un marchio immaginario di cuffie da studio (17 MB, 169 secondi). Il secondo test ha usato la modalità ecommerce con lunghezza medium e due foto di gioielleria già esistenti, generando una scheda prodotto da 2048 × 19.533 px (25 MB, 261 secondi). Qui sotto puoi esaminare entrambe le pagine complete, provare i due brief direttamente nel playground di Kling Image 4.0 Long Image e verificare le tariffe esatte nella tabella aggiornata più avanti.

Scegli ecommerce o webpage prima di scrivere una riga

Il campo settings.skill è obbligatorio e cambia sia la grammatica visiva del layout sia i parametri accettati dall’API. Considera le due modalità come contratti distinti, non come semplici preset di stile.

Usa ecommerce quando disponi già di foto reali del prodotto e ti serve una scheda prodotto verticale (PDP) per uno store o un marketplace. In modalità ecommerce devi inviare da una a tre voci refer_image in contents e controlli il budget di sezioni verticali con settings.length (short, medium o long, con medium come predefinito). Le richieste prive di riferimenti prodotto vengono rifiutate prima dell’addebito.

Usa webpage quando stai progettando una landing page di brand, un sito di lancio o un layout web editoriale. In modalità webpage i riferimenti sono facoltativi: puoi partire dal solo testo oppure fornire al massimo un style_refer_image per guidare palette e ritmo della griglia e al massimo un subject_refer_image per fissare un oggetto protagonista. Non inviare refer_image né settings.length in modalità webpage: appartengono esclusivamente alle richieste ecommerce e generano un errore di validazione se mescolati tra modalità.

Impostazione o inputModalità ecommerceModalità webpage
settings.skill"ecommerce" (obbligatorio)"webpage" (obbligatorio)
settings.length"short", "medium" (predefinito) oppure "long"Da omettere completamente
settings.resolution"1k" (1024 px di larghezza) oppure "2k" (2048 px di larghezza)"1k" (1024 px di larghezza) oppure "2k" (2048 px di larghezza)
Voci refer_imageObbligatorie: da 1 a 3 URL pubblici JPEG/PNGNon consentite
style_refer_image / subject_refer_imageNon consentitiFacoltativi: fino a 1 ciascuno

Nessuna delle due modalità accetta 4k, conteggi batch (n) o proporzioni personalizzate. Ogni attività completata restituisce esattamente un URL PNG verticale in output.data[0].url.

Prova 1: un layout webpage 2K solo testo (2048 × 16.385)

Panoramica su quattro colonne della pagina web 2048 per 16.385 Solstice Audio S-01 Reference Planar

Qui sopra trovi affiancati tutti e quattro i quarti verticali della nostra generazione webpage in 2K. Il brief chiedeva una pagina di lancio in stile industriale svizzero color ossidiana scuro per un paio di cuffie planari aperte chiamate S-01 Reference Planar: barra superiore minimale, foto hero di tre quarti, fascia a tre colonne con i punti di forza acustici, spaccato della lavorazione CNC, tabella delle specifiche tecniche con valori elettrici reali e footer sobrio.

Osserva cosa ha retto in un unico passaggio continuo. Lungo 16.385 pixel verticali, lo sfondo antracite scuro, i titoli editoriali serif e la geometria in alluminio spazzolato delle cuffie sono rimasti coerenti dalla barra di navigazione iniziale fino alla fascia con le cinque colorazioni e alla tabella tecnica. Tutti i parametri elettrici richiesti sono risultati leggibili (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Un dettaglio emerso ispezionando il PNG al 100% di zoom: il prompt chiedeva una banda chiara color alabastro dietro la tabella delle specifiche, ma il modello ha mantenuto la tabella su sfondo ardesia scuro spostando la fascia grigio chiaro sul modulo newsletter subito sotto. Se un cambio di sfondo esatto su una singola sezione è vincolante per il passaggio allo sviluppo, usa l’output come direzione artistica visiva e ritaglia o ricostruisci quella sezione HTML partendo dalle fotografie generate.

Scrivere un buon brief webpage somiglia più a stendere lo schema di un wireframe che a scrivere il prompt di una foto singola. Metti in testa i token grafici globali (esadecimale dello sfondo, materiali delle superfici, colore d’accento, disciplina della griglia), poi numera ogni fascia dall’alto verso il basso indicando testi concreti per i titoli e numeri precisi. Titoli vaghi attirano quasi sempre testo riempitivo.

curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0-long-image",
    "contents": [{
      "type": "prompt",
      "text": "Design a vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
    }],
    "settings": {
      "skill": "webpage",
      "resolution": "2k"
    }
  }' -o solstice-task.json
jq -er '.id' solstice-task.json

Nota che in questo payload settings.length viene omesso e contents contiene soltanto la voce prompt. Puoi verificare il contratto completo dei parametri nel riferimento API di Kling Image 4.0 Long Image. [1]

Prova 2: una scheda prodotto ecommerce 2K con due riferimenti (2048 × 19.533)

Panoramica su quattro colonne della scheda prodotto ecommerce 2048 per 19.533 per l’orecchino botanico in oro

Per la seconda prova abbiamo impostato settings.skill su "ecommerce", settings.length su "medium", mantenuto resolution su "2k" e passato due foto di gioielleria già pronte come voci refer_image: un macro di un orecchino pendente in oro scolpito a forma di orchidea con id: "earring" e un ritratto editoriale in serra di una donna che indossa lo stesso orecchino con id: "model".

Nel prompt abbiamo richiamato quei due asset tramite @earring e @model dentro la descrizione di ciascuna sezione. L’API traduce automaticamente gli ID nominati in riferimenti posizionali, così non devi contare gli indici a mano. Ogni foto di riferimento deve essere un URL pubblico JPEG o PNG fino a 30 MB, con almeno 300 px per lato e un rapporto d’aspetto compreso tra 2:5 e 5:2.

Sezione illustrata Craft And Beauty con didascalie tratta dalla scheda prodotto ecommerce 2K

Quella singola chiamata 2K di lunghezza media ha prodotto 19.533 pixel verticali che coprono sei moduli ecommerce completi: un hero prodotto su seta champagne, una fascia narrativa sull’ispirazione del design, uno scontorno da studio pulito affiancato da una tabella di sei righe (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), un ritratto On The Ear fedele a @model, una griglia prodotto su sei angolazioni (Front, Side, Back, Core Detail, Hook Detail, Profile) e lo schema illustrato Craft And Beauty ingrandito qui sopra.

L’ispezione a piena risoluzione ha evidenziato anche un difetto che vale la pena segnalare prima di pubblicare una PDP generata direttamente in catalogo. Sebbene la tabella tecnica riportasse con esattezza il nome Phalaenopsis No. 4 Drop Earring e tutte le etichette dello schema fossero scritte correttamente, il banner hero iniziale ha accorciato Botanical Series in BOTA SERIES e BOTA — Drop Earring invece di stampare il nome del brand richiesto L'ORCHIDÉE. È un comportamento tipico nel rendering del testo su pagine lunghe: etichette brevi e righe di tabella reggono molto bene, mentre i logotipi stilizzati tutto maiuscolo nell’hero ogni tanto slittano. Controlla sempre il titolo dell’hero a larghezza reale e sovrapponi loghi registrati o note legali come vettori reali nel template del tuo negozio.

curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0-long-image",
    "contents": [
      {
        "type": "prompt",
        "text": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
      },
      {
        "type": "refer_image",
        "id": "earring",
        "url": "https://example.com/assets/gold-orchid-earring.png"
      },
      {
        "type": "refer_image",
        "id": "model",
        "url": "https://example.com/assets/editorial-portrait.png"
      }
    ],
    "settings": {
      "skill": "ecommerce",
      "length": "medium",
      "resolution": "2k"
    }
  }' -o orchidee-task.json
jq -er '.id' orchidee-task.json

Se invece usi riferimenti in modalità webpage, tieni presente una regola precisa: fornisci style_refer_image per l’indirizzo estetico e subject_refer_image per il prodotto protagonista, assegnando a ciascuno un id alfanumerico distinto (da 1 a 32 caratteri, senza spazi) e richiamandolo con @id nel prompt. Non duplicare mai gli ID dentro lo stesso array contents.

Fai polling con pazienza e gestisci download PNG 2K pesanti

I layout verticali lunghi richiedono molto più tempo delle normali generazioni a singolo fotogramma e restituiscono file parecchio più pesanti. Trattarli come un’API di miniature da cinque secondi è il modo più rapido per incappare in timeout lato client o doppi addebiti involontari.

Nelle nostre prove del 19 novembre, la webpage 2048 × 16.385 si è conclusa in 169 secondi (17 MB) e la scheda ecommerce media 2048 × 19.533 in 261 secondi (25 MB). Le pagine ecommerce long in 2K possono superare i sette minuti e oltrepassare i 50 MB. Salva subito l’ID attività appena POST /v1/images/generations risponde, interroga GET /v1/tasks/{id} ogni 15–20 secondi e non inviare mai una seconda POST solo perché è caduto il terminale o il client è andato in timeout. [2]

TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.json

Quando status diventa completed, estrai l’unico URL PNG da output.data[0].url e scrivilo direttamente su disco con un timeout di trasferimento generoso:

IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.png

Nei worker di backend evita di caricare l’intero PNG in un piccolo buffer di memoria fisso prima di salvarlo su disco o su object storage. Scrivi il body HTTP in streaming direttamente su file, verifica le dimensioni prima di suddividere le fasce per lo store mobile e converti le anteprime in WebP conservando il PNG originale per stampa o esportazioni ritagliate.

Gestisci il budget su tutte le otto fasce e sui riferimenti

Il prezzo di Kling Image 4.0 Long Image dipende da tre scelte: skill (ecommerce o webpage), length (short, medium o long in modalità ecommerce) e resolution (1k o 2k). Ogni immagine di riferimento in ingresso (refer_image, style_refer_image o subject_refer_image) aggiunge un addebito per immagine in ingresso fin dalla prima foto, senza soglia gratuita.

Da qui nasce una strategia di bozza molto lineare. Quando stai ancora mettendo a punto l’ordine delle sezioni, il ritmo dei titoli e la gerarchia cromatica per un catalogo ecommerce, fai i primi test in 1k short o medium, controlla lo scorrimento verticale e passa al 2k solo quando il brief funziona. Per i layout webpage, la differenza tra 1k e 2k è abbastanza contenuta da rendere conveniente il 2k fin da subito se ti servono tabelle tecniche con testo piccolo ben nitido. La nostra prima prova è stata addebitata esattamente alla tariffa webpage 2K; la seconda alla tariffa ecommerce medium 2K più due addebiti per immagini in ingresso. Una richiesta non riuscita non viene addebitata. Controlla i valori aggiornati qui sotto oppure inserisci i tuoi parametri esatti nel calcolatore prezzi di Kling Image 4.0 Long Image. [3]

Quanto costa Kling Image 4.0 Long Image

CategoriaPrezzi (USD)
Ecommerce · 1K · short0,2269 USD
Ecommerce · 2K · short0,2723 USD
Ecommerce · 1K · medium0,4538 USD
Ecommerce · 2K · medium0,5294 USD
Ecommerce · 1K · long0,7563 USD
Ecommerce · 2K · long0,8319 USD
Webpage · 1K0,5294 USD
Webpage · 2K0,5748 USD
Immagine di riferimento0,003025 USD

Domande frequenti

Come scelgo tra short, medium e long in modalità ecommerce?

Conta i moduli distinti di cui il tuo prodotto ha realmente bisogno prima di scegliere length. Una pagina short ospita tre o quattro fasce mirate, come hero, benefici principali e un blocco specifiche compatto. Una pagina medium gestisce bene sei sezioni come nella prova di gioielleria sopra (hero, racconto, scontorno da studio, tabella specifiche, foto indossata, griglia multi-angolo e schema con didascalie). Riserva long all’hardware tecnico o alle schede multi-SKU in cui servono tabelle comparative, pannelli d’uso passo passo e dettaglio del packaging senza comprimere la tipografia.

Perché la mia richiesta webpage ha restituito HTTP 400?

I due errori di validazione più comuni sono inviare settings.length insieme a skill: "webpage" e taggare una foto di riferimento con type: "refer_image" invece di style_refer_image o subject_refer_image. Entrambi i campi sono esclusivi della modalità ecommerce. Verifica inoltre che il prompt resti entro il limite ponderato di caratteri (en / 166000 + non_en / 71000 <= 1, calcolato dopo la mappatura dei richiami @id) e che resolution sia "1k" o "2k".

Conviene suddividere il PNG finale per uno store online reale?

Sì. Un PNG da 2048 × 19.533 pesa tra 17 e 25 MB non compresso ed è troppo pesante per essere servito come singolo tag <img> su rete mobile. Ritaglia la pagina finita lungo i confini orizzontali delle sezioni, comprimi ciascuna fascia in WebP o AVIF per un caricamento progressivo rapido e sostituisci marchi legali critici, prezzi o pulsanti d’acquisto con vero testo HTML. Puoi testare i prompt e ispezionare gli output a tutta altezza direttamente nel playground di Kling Image 4.0 Long Image prima di automatizzare la pipeline.

Fonti

  1. Riferimento API SeedRouter per Kling Image 4.0 Long Image
  2. Guida SeedRouter al polling delle attività e al recupero dei risultati
  3. Prezzi live e calcolatore di Kling Image 4.0 Long Image

Guide correlate