how-tos

Kling Image 4.0 API: immagini native in 8K e design di pagine web lunghe

Poyo.ai Team
8 min read
Share:

Kling Image 4.0 API: immagini native in 8K e pagine web ed ecommerce lunghe

Due funzioni distinguono la Kling Image 4.0 API: un livello di risoluzione 8K su kling-4.0-image, l'unico modello di immagini su PoYo che lo offre, e un modello separato, kling-4.0-long-image, che progetta un'intera pagina web o pagina prodotto ecommerce come un'unica immagine alta. Questo articolo mostra i body di richiesta, cosa è tornato quando li abbiamo eseguiti il giorno del lancio e come gestire i file. Parti dalla pagina del modello Kling Image 4.0 se vuoi provarli prima nel playground.

8K nativo con la Kling Image 4.0 API

Kling afferma nel suo post di lancio che Kling Image 4.0 introduce la generazione nativa di immagini in 8K, cioè l'immagine viene generata a quella dimensione invece di essere ingrandita in seguito. Su PoYo è un solo campo:

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "A rider on a vintage motorbike crossing a desert highway at sunrise, long shadows, dust in the air, cinematic photography",
    "size": "16:9",
    "resolution": "8K",
    "n": 1
  }
}

Cosa restituisce una richiesta in 8K

Il team PoYo ha eseguito questa struttura di richiesta (text-to-image, size: "16:9", resolution: "8K", n: 1) sull'API di produzione il 19 novembre 2026:

RisultatoValore
OutputPNG 10880×6144
Dimensione del filecirca 128 MB
Costo32 crediti ($0.16)
Dall'invio al risultatocirca 3.8 minuti
Formato pixelRGBA (PNG con canale alfa), anche se l'immagine è opaca

Come riferimento, la documentazione PoYo indica per l'1:1 le dimensioni 2048×2048 in 2K e 8192×8192 in 8K, e 5440×3072 in 16:9 per il 4K, con dimensioni tipiche dei PNG di circa 7.5 MB, 27 MB e 100 MB per 2K, 4K e 8K. Le nostre immagini 2K in 16:9 della stessa sessione erano 2720×1536.

I livelli di risoluzione a confronto

resolutionDimensioni di esempioPrezzo per immagineQuando usarlo
2K2048×2048 (1:1), 2720×1536 (16:9, misurato)13 crediti ($0.065)Web, social, bozze
4K5440×3072 (16:9)19 crediti ($0.095)Schermi grandi, ritagli moderati
8K8192×8192 (1:1), 10880×6144 (16:9, misurato)32 crediti ($0.16)Stampa, cartelloni, ritagli stretti da un unico frame

I riferimenti aggiungono 1 credito ciascuno, una volta per richiesta.

Gestire i file 8K nella tua pipeline

Un PNG 8K è troppo grande per trattarlo come una miniatura. Modifiche pratiche:

  • Usa callback_url. Una richiesta che richiede minuti non dovrebbe tenere aperta una richiesta web. PoYo invia in POST il risultato del task al tuo URL quando termina o fallisce.
  • Scarica in streaming su disco o su object storage. Non leggere in memoria un body da 128 MB in una funzione serverless con poca memoria, e aumenta il timeout di lettura del client HTTP.
  • Elimina il canale alfa se non ti serve. I nostri download erano RGBA anche per immagini opache. La conversione in RGB, o in JPEG o WebP per la distribuzione, è un passaggio che aggiungi tu; l'API non ha un campo per il formato di output.
  • Conserva il master 8K, distribuisci le versioni derivate. Genera una volta in 8K, poi ridimensiona per il web. Una seconda generazione 8K dello stesso prompt è un'immagine nuova e un nuovo addebito.
  • Pianifica con attenzione il budget delle serie. n moltiplica il prezzo per immagine: una serie 8K di 10 immagini costa 320 crediti ($1.60). La documentazione PoYo stima circa 30 minuti per una serie 8K di 10 immagini, quindi qui servono i webhook.

Portare un'immagine esistente in 8K

Passa l'immagine in image_urls, imposta resolution su 8K e indica cosa non deve cambiare:

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "Recreate @Image1 at full detail. Keep the composition, subject, colors and lighting of @Image1 unchanged.",
    "image_urls": ["https://example.com/product-hero.png"],
    "resolution": "8K"
  }
}

Si tratta di una nuova generazione guidata dal riferimento, non di un upscaler di pixel, quindi descrivi tutto ciò che deve restare esattamente uguale. Costo: 32 + 1 = 33 crediti ($0.165).

Pagine lunghe con kling-4.0-long-image

Kling descrive la generazione in formato lungo per pagine prodotto ecommerce e web design, con un layout completo in un'unica immagine. Su PoYo è un ID modello separato con un campo skill. L'output è un PNG largo 1024 px in 1K o 2048 px in 2K, con l'altezza determinata dal contenuto.

Design di pagine web

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "A landing page for a specialty coffee roastery: hero with coffee beans, story section, three featured blends with prices, brewing guide, customer reviews and footer. Warm earthy palette. All text on the page is in English.",
    "skill": "webpage",
    "resolution": "1K"
  }
}

Input facoltativi per webpage:

CampoTag nel promptEffetto
style_image_url@StyleImageIl design ne segue lo stile visivo e il layout
subject_image_url@SubjectImageIl design viene costruito attorno al soggetto mostrato

Cosa abbiamo misurato: una richiesta webpage in 1K ha restituito una pagina 1024×4257, a 110 crediti ($0.55), in circa 1.7–2.2 minuti (API di produzione PoYo, 19 novembre 2026).

Indica la lingua del testo della pagina

È l'unica cosa da aggiungere a ogni prompt long image. Nel nostro test, la prima richiesta webpage usava un prompt in inglese che non specificava la lingua del testo della pagina, e la pagina è tornata con testo in cinese. Aggiungere al prompt la frase "All text on the page is in English." ha risolto alla successiva esecuzione. Poiché ogni nuova esecuzione è un addebito completo (110 crediti per una pagina web 1K), inserisci la riga sulla lingua nel tuo template di prompt fin dall'inizio, per qualunque lingua serva alla tua pagina. Kling elenca inglese, cinese semplificato e tradizionale, giapponese, coreano, spagnolo e portoghese per il rendering del testo.

Pagine prodotto ecommerce

skill: "ecommerce" crea una pagina prodotto da 1 a 3 foto prodotto, richiamate come @Image1 fino a @Image3:

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "Design a product detail page for the insulated water bottle in @Image1: hero shot, key features, capacity and size, materials, and lifestyle scenes. All text on the page is in English.",
    "skill": "ecommerce",
    "image_urls": ["https://example.com/water-bottle.png"],
    "length": "medium",
    "resolution": "1K"
  }
}

length stabilisce quante sezioni ha la pagina, e il prezzo:

lengthSezioni (circa)1K2K
short2–547 crediti ($0.235)57 crediti ($0.285)
medium (predefinito)6–1094 crediti ($0.47)110 crediti ($0.55)
long11–18157 crediti ($0.785)173 crediti ($0.865)

Ogni foto prodotto aggiunge 1 credito. La documentazione PoYo cita una pagina long in 2K come esempio di quanto possano diventare alte: fino a 2048×54,941 px, circa 87 MB.

Visualizzare e suddividere le immagini lunghe

Una pagina larga 1024 px e alta diverse migliaia di pixel non entra in una normale anteprima di immagine. Suddividila in sezioni o in riquadri alti quanto lo schermo per la revisione, e conserva l'originale per il download. Tratta il risultato come un mockup di design: testi, prezzi e pulsanti sono pixel, non HTML.

Checklist dei prompt per 8K e pagine lunghe

  • Indica la lingua di qualsiasi testo nell'immagine.
  • Per le pagine, elenca le sezioni in ordine: hero, funzionalità, specifiche, recensioni, footer.
  • Metti il testo esatto tra virgolette e indica dove va; secondo Kling il modello rende fino a 2,000 caratteri per immagine.
  • Per l'8K, descrivi texture e dettagli fini che devono sopravvivere a un ritaglio.
  • Per i riferimenti, assegna un compito a ogni tag: "@Image1 is the product, keep its shape and label".

Riferimento completo delle richieste e codice di polling: guida alla Kling Image 4.0 API. Costi: prezzi della Kling Image 4.0 API. Contesto su entrambi gli ID modello: cos'è Kling Image 4.0.

Domande frequenti

La Kling Image 4.0 API genera davvero in 8K? Sì. Con resolution: "8K", il nostro test 16:9 ha restituito un PNG 10880×6144, e la documentazione PoYo indica 8192×8192 in 1:1. Kling lo descrive come generazione nativa in 8K.

Quanto tempo richiede una richiesta 8K alla Kling Image 4.0 API? Circa 3.8 minuti per un'immagine 16:9 in 8K nel nostro test del giorno del lancio. Le serie più grandi richiedono molto più tempo, quindi usa callback_url.

Quanto costa un'immagine 8K con la Kling Image 4.0 API? 32 crediti ($0.16) per immagine su PoYo, più 1 credito per riferimento.

Quali dimensioni restituisce la long image API di Kling Image 4.0? Larghezza 1024 px in 1K o 2048 px in 2K; l'altezza segue il contenuto. La nostra pagina web 1K era 1024×4257.

Perché il testo della mia pagina lunga di Kling Image 4.0 è nella lingua sbagliata? Il prompt non ne indicava una. Aggiungi una riga come "All text on the page is in English."

Share: