guides

Kling Image 4.0 API: cos'è Kling Image 4.0, ID modello e prezzi

Poyo.ai Team
8 min read
Share:

Kling Image 4.0 API su PoYo: immagini native in 8K, serie di immagini e design di pagine lunghe

La Kling Image 4.0 API offre agli sviluppatori il modello di immagini più recente di Kling AI tramite un unico endpoint PoYo: chiama kling-4.0-image per text-to-image, modifica e serie di immagini in 2K, 4K o 8K, e kling-4.0-long-image per design completi di pagine web o pagine ecommerce. Questa pagina spiega cos'è Kling Image 4.0, cosa fa ogni campo della richiesta, quali sono i limiti e quanto costa una chiamata su PoYo.

Cos'è Kling Image 4.0?

Kling Image 4.0 è il modello di immagini della famiglia Kling 4.0 di Kling AI, la piattaforma creativa IA di Kuaishou. È stato rilasciato il 17 novembre 2026. Nel suo post di lancio, Kling afferma che il modello:

  • genera immagini in 8K nativo, introdotto da Kling per la prima volta con questo modello;
  • crea fino a 10 immagini da un solo prompt con stile e contenuto coerenti;
  • rende fino a 2,000 caratteri di testo in un'immagine, in inglese, cinese semplificato, cinese tradizionale, giapponese, coreano, spagnolo e portoghese;
  • produce immagini in formato lungo per pagine prodotto ecommerce e web design.

Kling dichiara inoltre che il modello è attivo in Kling Creative Studio e disponibile via API per aziende e sviluppatori. PoYo ha aggiunto la Kling Image 4.0 API a novembre 2026, senza lista d'attesa e con la stessa chiave API che usi per ogni altro modello PoYo.

ID modello della Kling Image 4.0 API su PoYo

ID modelloUsalo perOutput
kling-4.0-imageText-to-image (senza image_urls), image-to-image con 1–10 riferimenti, elementi, serie di immagini1–9 immagini indipendenti, o una serie di 2–10, in 2K / 4K / 8K
kling-4.0-long-imageDesign di pagine con skill: "webpage", pagine prodotto con skill: "ecommerce" da 1–3 foto prodottoUn'immagine alta, larga 1024 px (1K) o 2048 px (2K)

Entrambi gli ID usano lo stesso endpoint di invio, lo stesso polling dei task e lo stesso webhook callback_url. Lo slug della landing page è kling-4-0-image; gli ID modello nella richiesta usano i punti (kling-4.0-image).

Endpoint e struttura della richiesta

Ogni richiesta alla Kling Image 4.0 API è un task asincrono:

  1. POST https://api.poyo.ai/api/generate/submit con Authorization: Bearer $POYO_API_KEY e un body JSON con model più input.
  2. Leggi data.task_id dalla risposta.
  3. Interroga GET https://api.poyo.ai/api/generate/status/{task_id} finché status non è finished o failed, oppure passa callback_url al livello superiore e ricevi una POST quando il task termina.

Una richiesta 4K minima, ricavata dalla struttura della documentazione:

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
    "size": "16:9",
    "resolution": "4K"
  }
}

Un task completato restituisce le immagini in data.files, ciascuna con file_url e file_type: "image". Le serie di immagini tornano in ordine. Controlla il campo code nel body oltre allo stato HTTP: PoYo può restituire HTTP 200 con code: 400 per un errore di validazione. La versione passo passo con cURL e Python è nella guida alla Kling Image 4.0 API.

Campi di input e limiti

kling-4.0-image

CampoValoriNote
prompt1–50,000 caratteriObbligatorio. Fai riferimento agli input come @Image1, @Element1
image_urls1–10 URLAttiva image-to-image. Ogni immagine fino a 30 MB, almeno 300 px per lato, proporzioni 0.4–2.5
kling_elementsfino a 7 elementiOgnuno {"element_input_urls": [...]} con 2–4 viste, la frontale per prima. Richiede image_urls. Immagini più elementi ≤ 10
sizeauto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9Predefinito auto
resolution2K, 4K, 8KPredefinito 2K. 8K è 8192×8192 in 1:1
enable_sequentialtrue / falsetrue restituisce una serie di immagini coerente
n1–9 (indipendenti) o 2–10 (serie)Predefiniti 1 e 4

Lo schema rifiuta i campi sconosciuti, quindi non inviare output_format, seed o negative_prompt. L'output è PNG.

kling-4.0-long-image

CampoValoriNote
skillwebpage (predefinito), ecommerceSceglie il tipo di pagina
image_urls1–3 foto prodottoObbligatorio per ecommerce
style_image_url / subject_image_urlun URL ciascunoSolo webpage; @StyleImage, @SubjectImage
lengthshort, medium (predefinito), longSolo ecommerce: circa 2–5, 6–10 o 11–18 sezioni
resolution1K (predefinito), 2KLarghezza 1024 o 2048 px; l'altezza segue il contenuto

Ogni richiesta long image restituisce un'immagine.

Prezzi della Kling Image 4.0 API su PoYo

PoYo fattura per immagine generata (1 credito = $0.005). I crediti vengono addebitati solo quando il task va a buon fine.

RichiestaCreditiUSD
kling-4.0-image, 2K, per immagine13$0.065
kling-4.0-image, 4K, per immagine19$0.095
kling-4.0-image, 8K, per immagine32$0.16
Ogni voce di image_urls e ogni elemento di kling_elements, una volta per richiesta1$0.005
Long image, webpage, 1K / 2K110 / 120$0.55 / $0.60
Long image, ecommerce short, 1K / 2K47 / 57$0.235 / $0.285
Long image, ecommerce medium, 1K / 2K94 / 110$0.47 / $0.55
Long image, ecommerce long, 1K / 2K157 / 173$0.785 / $0.865
Long image, ogni immagine in image_urls, style_image_url o subject_image_url1$0.005

Il dettaglio dei prezzi contiene le tabelle per le long image ed esempi di calcolo.

Cosa abbiamo misurato il giorno del lancio

Il team PoYo ha eseguito queste richieste sull'API di produzione il 19 novembre 2026. I tempi vanno dall'invio al risultato come li vede un client in polling, quindi considerali approssimativi.

RichiestaOutputCostoTempo
kling-4.0-image, text-to-image, 16:9, 8K, n: 1PNG 10880×6144, circa 128 MB32 crediticirca 3.8 min
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4quattro immagini 2720×1536, stesso motociclista, moto e outfit dall'alba alla notte52 crediticirca 4.9 min
kling-4.0-long-image, skill: "webpage", 1Kuna pagina 1024×4257110 crediticirca 1.7–2.2 min

Due note di integrazione dalla stessa sessione. I download erano file PNG con canale alfa (RGBA) anche per immagini opache, quindi converti esplicitamente se la tua pipeline si aspetta RGB o JPEG. E un lungo prompt webpage in inglese che non indicava la lingua del testo della pagina è tornato con testo in cinese; aggiungere "All text on the page is in English." ha risolto. Maggiori dettagli su entrambi in 8K e immagini lunghe.

Quali richieste dovrebbero andare alla Kling Image 4.0 API?

  • Stampa, cartelloni e lavori con molti ritagli che richiedono più di 4K: è l'unico modello di immagini su PoYo con un livello 8K.
  • Storyboard, angolazioni di prodotto e slide in cui un personaggio o un prodotto deve restare identico in tutti i frame: usa enable_sequential.
  • Inserire un prodotto o un personaggio noto in una nuova scena: passa la scena in image_urls e il soggetto come elemento con più angolazioni.
  • Mockup di landing page e pagine prodotto ecommerce come un'unica immagine: kling-4.0-long-image.

Per bozze rapide in 1K–2K al prezzo più basso, Kling O3 Image costa meno per immagine; vedi Kling Image 4.0 API vs Kling O3 Image. Per confrontarlo con altri fornitori, leggi Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.

Domande frequenti

Cos'è la Kling Image 4.0 API? È l'accesso REST di PoYo al modello Kling Image 4.0 di Kling AI, con gli ID modello kling-4.0-image (immagini standard, modifiche e serie di immagini) e kling-4.0-long-image (pagine web lunghe e pagine ecommerce). Entrambi usano POST /api/generate/submit e la stessa chiave API.

Quanto costa la Kling Image 4.0 API? 13 crediti ($0.065) per immagine in 2K, 19 crediti ($0.095) in 4K e 32 crediti ($0.16) in 8K, più 1 credito ($0.005) per immagine di riferimento o elemento, una volta per richiesta. Le long image costano da 47 a 173 crediti per pagina. I task falliti non vengono addebitati.

La Kling Image 4.0 API supporta l'image-to-image? Sì. Passa da 1 a 10 URL in image_urls con kling-4.0-image e richiamali nel prompt come @Image1, @Image2. Aggiungi fino a 7 kling_elements per personaggi od oggetti coerenti; immagini più elementi hanno un limite di 10.

Quanto tempo richiede una richiesta alla Kling Image 4.0 API? Nel nostro test del giorno del lancio, un'immagine 16:9 in 8K ha richiesto circa 3.8 minuti, una serie 2K di quattro immagini circa 4.9 minuti e una pagina web 1K circa 2 minuti. Per i job grandi usa callback_url invece di tenere aperta una richiesta.

Dove si trova la documentazione della Kling Image 4.0 API? Il riferimento dei campi è nella documentazione di Kling Image 4.0 e nella documentazione long image. La pagina del modello ha un playground che mostra il JSON delle tue impostazioni.

Share: