
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 modello | Usalo per | Output |
|---|---|---|
kling-4.0-image | Text-to-image (senza image_urls), image-to-image con 1–10 riferimenti, elementi, serie di immagini | 1–9 immagini indipendenti, o una serie di 2–10, in 2K / 4K / 8K |
kling-4.0-long-image | Design di pagine con skill: "webpage", pagine prodotto con skill: "ecommerce" da 1–3 foto prodotto | Un'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:
POST https://api.poyo.ai/api/generate/submitconAuthorization: Bearer $POYO_API_KEYe un body JSON conmodelpiùinput.- Leggi
data.task_iddalla risposta. - Interroga
GET https://api.poyo.ai/api/generate/status/{task_id}finchéstatusnon èfinishedofailed, oppure passacallback_urlal 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
| Campo | Valori | Note |
|---|---|---|
prompt | 1–50,000 caratteri | Obbligatorio. Fai riferimento agli input come @Image1, @Element1 |
image_urls | 1–10 URL | Attiva image-to-image. Ogni immagine fino a 30 MB, almeno 300 px per lato, proporzioni 0.4–2.5 |
kling_elements | fino a 7 elementi | Ognuno {"element_input_urls": [...]} con 2–4 viste, la frontale per prima. Richiede image_urls. Immagini più elementi ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Predefinito auto |
resolution | 2K, 4K, 8K | Predefinito 2K. 8K è 8192×8192 in 1:1 |
enable_sequential | true / false | true restituisce una serie di immagini coerente |
n | 1–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
| Campo | Valori | Note |
|---|---|---|
skill | webpage (predefinito), ecommerce | Sceglie il tipo di pagina |
image_urls | 1–3 foto prodotto | Obbligatorio per ecommerce |
style_image_url / subject_image_url | un URL ciascuno | Solo webpage; @StyleImage, @SubjectImage |
length | short, medium (predefinito), long | Solo ecommerce: circa 2–5, 6–10 o 11–18 sezioni |
resolution | 1K (predefinito), 2K | Larghezza 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.
| Richiesta | Crediti | USD |
|---|---|---|
kling-4.0-image, 2K, per immagine | 13 | $0.065 |
kling-4.0-image, 4K, per immagine | 19 | $0.095 |
kling-4.0-image, 8K, per immagine | 32 | $0.16 |
Ogni voce di image_urls e ogni elemento di kling_elements, una volta per richiesta | 1 | $0.005 |
| Long image, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Long image, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Long image, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Long image, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Long image, ogni immagine in image_urls, style_image_url o subject_image_url | 1 | $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.
| Richiesta | Output | Costo | Tempo |
|---|---|---|---|
kling-4.0-image, text-to-image, 16:9, 8K, n: 1 | PNG 10880×6144, circa 128 MB | 32 crediti | circa 3.8 min |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | quattro immagini 2720×1536, stesso motociclista, moto e outfit dall'alba alla notte | 52 crediti | circa 4.9 min |
kling-4.0-long-image, skill: "webpage", 1K | una pagina 1024×4257 | 110 crediti | circa 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_urlse 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.