curl-X POST 'https://pollo.ai/api/platform/v1/generation/kling-ai/kling-v3-image/image'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "aspectRatio": "1:1", "resolution": "1K" }}'
È possibile includere facoltativamente l'URL del webhook per ricevere una notifica in caso di successo o fallimento dell'attività.
Campo di richiesta facoltativo
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","aspectRatio":"1:1","resolution":"1K"},"webhookUrl":"https://example.com/webhooks/pollo"}
Schema
Campi di input per l'endpoint e la modalità selezionati.
Campo
Tipo
Necessario
Descrizione
prompt
string
Sì
Text prompt describing the content to generate.
aspectRatio
string
NO
Output aspect ratio, as width:height (e.g. 16:9).
resolution
string
NO
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
Fornisci a Kling 3.0 diverse immagini di riferimento e manterrà costanti un personaggio, un outfit e uno stile artistico in ogni fotogramma, rendendolo adatto a set di immagini che devono appartenere allo stesso insieme.
Con Kling Image 3.0 su Pollo API, gli sviluppatori possono aggiungere alle proprie app funzioni text-to-image, editing con riferimento singolo e composizione multi-immagine, con rendering fino a 2K su rapporti d’aspetto che vanno dall’ultrawide 21:9 al verticale 9:16.
Funzionalità principali della API di Kling Image 3.0
Composizione multi-immagine
Combina più immagini di riferimento in una sola richiesta, così un personaggio, un prodotto e un’ambientazione possono essere fusi in un’unica scena coerente invece che in rendering separati.
Coerenza di personaggio e stile
I soggetti ricorrenti mantengono volto, abbigliamento e aspetto tra una generazione e l’altra, permettendoti di creare una sequenza collegata invece di un gruppo di immagini scollegate e isolate.
Ampia gamma di rapporti d’aspetto
L’output copre panorami ultrawide 21:9, rapporti standard orizzontali e verticali, quadrato e verticale 9:16, così un solo modello copre banner, poster e formati mobile-first.
Dettaglio 2K
I rendering arrivano a risoluzione 2K, mantenendo texture fini su volti, tessuti e tipografia, così le immagini restano adatte a layout di stampa e formati di grandi dimensioni senza upscaling.
Editing guidato da riferimento
Abbina un prompt a un’immagine esistente per cambiarne stile, estenderla o rimetterla in scena, ottenendo un controllo preciso su una composizione già definita invece di ripartire da zero per ogni idea.
Casi d’uso della API di Kling Image 3.0
Fotogrammi storyboard: Genera una serie di pannelli che condividono un unico protagonista e la stessa ambientazione, utile per strumenti di previsualizzazione e app di pianificazione delle inquadrature.
Pagine illustrate e vignette di fumetti: Mantieni un personaggio ricorrente fedele al modello da una pagina all’altra, così le piattaforme di illustrazione possono produrre arte sequenziale coerente.
Schede personaggio per videogiochi: Renderizza un eroe da più angolazioni e con outfit diversi mantenendo fissi volto e proporzioni per le pipeline di design.
Compositing prodotto-in-scena: Unisci l’immagine di un prodotto con il riferimento di un modello o di un ambiente in uno scatto allestito per strumenti di creazione di schede ecommerce.
Concept art e ambientazioni: Trasforma descrizioni dense di scene in location e oggetti di scena dettagliati per flussi di lavoro di worldbuilding e level design.
Set immagini di brand: Produci una serie coordinata di visual marketing che condividono palette, soggetto e layout per strumenti di automazione delle campagne.
Restyling da riferimento: Prendi una foto caricata e renderizzala di nuovo con un nuovo stile o una nuova illuminazione tramite editing image-to-image.
Come usare la API di Kling Image 3.0
Ottieni una API Key: Crea un account Pollo API e genera la tua API key dalla dashboard sviluppatori.
Scegli il modello: Invia le richieste all’endpoint immagine di Kling 3.0 su /generation/kling-ai/kling-v3-image/image.
Aggiungi gli input: Fornisci un prompt per text-to-image, aggiungi imageUrl per editing con riferimento singolo, oppure passa un array images per la composizione multi-immagine, poi imposta aspectRatio e resolution (1k o 2k).
Genera e recupera: Invia il task, interroga il taskId e lo status restituiti, quindi scarica l’immagine finale una volta completata con successo.
Best practice di prompting per la API di Kling Image 3.0
Descrivi chiaramente il soggetto, l’inquadratura e la relazione con i riferimenti. Quando combini immagini, specifica cosa apporta ciascun riferimento, così il modello sa quale elemento mantenere e quale modificare.
Una formula semplice per i prompt
Soggetto e suoi tratti distintivi + contributo di ciascun riferimento + composizione e inquadratura + stile e illuminazione + intento del rapporto d’aspetto
Cosa dovresti notare
Ancora il personaggio: Indica i tratti identitari che vuoi preservare, come capelli, abbigliamento o età, così la coerenza si mantiene lungo una serie.
Assegna ogni riferimento: Quando usi più immagini, specifica quale è il soggetto, il prodotto o lo sfondo per evitare errori di fusione.
Definisci l’inquadratura con intenzione: Scegli un rapporto d’aspetto adatto all’uso finale, perché 21:9 e 9:16 cambiano la composizione più di un semplice ritaglio.
Scrivi prompt ricchi: Il modello interpreta descrizioni lunghe e dettagliate, quindi dedica parole a layout, materiali e atmosfera invece di una sola riga vaga.
Riserva il 2K ai dettagli: Scegli 2K quando texture o tipografia sono importanti, e 1K per bozze più veloci mentre iteri sul look.
Esempi di prompt
Pannello sequenziale per libro illustrato
"Una curiosa bambina dai capelli rossi con impermeabile giallo si inginocchia accanto a una pozza di marea luminosa al crepuscolo, osservando una stella marina. Illustrazione ad acquerello morbida, luce di contorno calda, profondità di campo delicata, inquadratura 4:3 per allinearsi alla pagina precedente del libro illustrato."
Composito prodotto multi-riferimento
"Metti la sneaker della prima immagine sulla modella della seconda immagine, allacciata e indossata mentre è seduta su gradini di cemento. Luce naturale diffusa da cielo coperto, stile catalogo editoriale, prodotto nitido in primo piano, ritratto 3:4 per una scheda prodotto."
Turnaround personaggio di gioco
"Un ranger del deserto stoico con mascella segnata da cicatrici, cappotto di pelle consumato dalla polvere e bussola in ottone, mostrato in posa frontale a tre quarti. Volto e outfit coerenti, stile concept art pittorico, sfondo neutro da studio, inquadratura 2:3 da scheda personaggio."
Concept ambientale ultrawide
"Una serra abbandonata riconquistata dalle viti, pannelli di vetro infranti che diffondono la luce del pomeriggio su sentieri di pietra muschiosi e fioriere arrugginite. Ambientazione artistica dettagliata, profondità stratificata, palette verde fredda, panorama 21:9 per un establishing shot."
Kling Image 3.0 vs Seedream 4.0 vs GPT Image 1
Capacità
Kling Image 3.0
Seedream 4.0
GPT Image 1
Composizione multi-immagine
✅ Unisce più riferimenti in una richiesta
✅ Forte fusione dei riferimenti
✅ Supporta input multipli
Coerenza del personaggio tra i fotogrammi
✅ Mantiene il soggetto lungo una serie
✅ Buona conservazione del soggetto
✅ Affidabile, meno focalizzato sulle serie
Risoluzione massima
Fino a 2K
Fino a 4K
Alta, gestita dal modello
Gamma di rapporti d’aspetto
Da 21:9 a 9:16, otto rapporti
Ampia gamma
Set fisso di dimensioni
Lunghezza prompt
Prompt lunghi e dettagliati
Prompt lunghi
Prompt lunghi
Consigliato per
Set di immagini sequenziali coerenti
Editing di riferimenti ad alta risoluzione
Rendering di testo ed editing conversazionale
Perché scegliere la API di Kling Image 3.0?
Kling Image 3.0 è adatto ai prodotti che hanno bisogno di immagini correlate, non isolate, mantenendo coerenza di personaggio e stile tra storyboard, pagine di libri, schede personaggio e set per campagne.
Attraverso Pollo API, puoi accedere a Kling Image 3.0 con una sola API key insieme a oltre 300 modelli leader per immagini e video, con documentazione chiara, polling dello stato dei task e generazione a costo inferiore rispetto a Fal AI.
Integra l’endpoint Kling Image 3.0 per rilasciare funzionalità immagine coerenti e multi-riferimento, poi confrontalo con Seedream, GPT Image e Midjourney senza riscrivere l’integrazione.
FAQ sulla API di Kling Image 3.0
Cos’è Kling Image 3.0?
Kling Image 3.0 è il modello di generazione immagini di Kling AI che supporta text-to-image, image-to-image e composizione multi-immagine, con focus sulla coerenza dei personaggi in un set di immagini correlate.
La API di Kling Image 3.0 supporta più immagini di riferimento?
Sì. Puoi passare diversi URL immagine in una sola richiesta, permettendo al modello di fondere soggetto, prodotto o sfondo in un’unica scena coerente.
Quali risoluzioni e rapporti d’aspetto sono disponibili?
Renderizza in 1K o 2K su otto rapporti d’aspetto, dall’ultrawide 21:9 passando per quadrato e ritratto fino al verticale 9:16, selezionati per richiesta.
Come mantiene coerenti i personaggi?
Lavorando da immagini di riferimento e prompt dettagliati, preserva tratti identitari come volto, abbigliamento e stile, aiutandoti a creare pannelli sequenziali invece di immagini non correlate.
Può modificare un’immagine esistente?
Sì. Fornisci un URL immagine con un prompt per cambiarne stile, rimetterla in scena o estenderla, ottenendo modifiche controllate a una composizione già definita tramite image-to-image.
Perché eseguire Kling Image 3.0 tramite Pollo API?
Pollo API offre un’unica integrazione per Kling Image 3.0 e oltre 300 altri modelli, con documentazione, tracciamento task e generazione a costo inferiore rispetto a provider comparabili.
