curl-X POST 'https://pollo.ai/api/platform/v1/generation/kling-ai/kling-v1/video'\-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", "negativePrompt": "blurry, low quality, distorted, watermark, text", "aspectRatio": "16:9", "duration": 5, "mode": "std" }}'
È 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","negativePrompt":"blurry, low quality, distorted, watermark, text","aspectRatio":"16:9","duration":5,"mode":"std"},"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.
negativePrompt
string
NO
Text describing elements to avoid in the generated output.
aspectRatio
string
NO
Output aspect ratio, as width:height (e.g. 16:9).
duration
number
NO
The duration of the generated video, in seconds.
mode
string
NO
Generation mode of the model (e.g. a faster or higher-quality tier).
La possibilità di controllare la telecamera è ciò che distingue Kling 1.0 . È possibile richiamare panoramiche, inclinazioni, rotazioni, zoom e movimenti preimpostati, controllando la traiettoria dell'inquadratura anziché affidarsi al caso.
Con Kling 1.0 su Pollo API, gli sviluppatori possono aggiungere alle proprie Apps la conversione di testo in video e di immagine in video, scegliendo clip da 5 o 10 secondi, modalità standard o pro e regolando l'intensità del messaggio vocale per ogni richiesta.
Caratteristiche principali dell'API Kling 1.0
Controllo direzionale della telecamera
Le inquadrature possono effettuare panoramiche, inclinazioni, rotazioni, zoom o movimenti orizzontali e verticali, e le mosse preimpostate, come quella in avanti e verso l'alto, consentono di comporre movimenti intenzionali anziché accettare una deriva predefinita.
Guida del primo e dell'ultimo fotogramma
Basta fornire un'immagine iniziale e un'immagine finale, e Kling 1.0 le unisce, dandoti il controllo su dove inizia e dove termina una clip.
Punti di partenza per testo e immagini
Parti da un suggerimento scritto o anima un'immagine statica esistente: lo stesso modello si adatta sia a script che partono dalle idee, sia a flussi di lavoro che partono dalle risorse, senza bisogno di cambiare strumento.
Intensità del prompt regolabile
Un controllo di intensità permette di bilanciare la fedeltà con cui l'output segue il prompt rispetto all'immagine sorgente, consentendo di scegliere tra un movimento fedele e risultati più liberi e creativi.
Modalità di qualità
Le modalità Standard, Pro e 4K sacrificano la velocità a favore della fedeltà, consentendoti di lavorare rapidamente sulle bozze e poi di rielaborare l'inquadratura scelta con un livello di dettaglio superiore.
Casi d'uso dell'API Kling 1.0
Inquadrature dirette dalla telecamera: Crea uno script per uno zoom lento o un'inclinazione progressiva di una scena, utile per strumenti in cui gli utenti desiderano controllare l'obiettivo, non solo il soggetto.
Clip incorniciate: Imposta un'immagine fissa iniziale e una finale in modo che una transizione o una rivelazione cada esattamente sul fotogramma finale scelto.
Animazione di foto statiche: Trasforma una foto di prodotto, un'illustrazione o un ritratto in una breve sequenza animata mantenendo intatta l'inquadratura originale.
Prototipazione da prompt a video: Genera bozze rapide basate su testo per visualizzare in anteprima un'idea prima di dedicare tempo a una versione più dettagliata.
Pubblicazione con proporzioni: Produci clip in formato 16:9, 9:16 o 1:1 in modo che una singola integrazione alimenti lettori orizzontali, feed verticali e posizionamenti quadrati.
Cicli di bozza iterativi: Utilizza la modalità standard per ripetizioni veloci, quindi passa alla pro o 4K per l'esportazione finale di una ripresa preferita.
Pulizia guidata da elementi negativi: Orienta l'output lontano da elementi o artefatti indesiderati utilizzando suggerimenti negativi per mantenere le scene brevi.
Come utilizzare l'API Kling 1.0
Ottieni una chiave API: Crea un account Pollo API e genera la tua chiave API dalla dashboard per sviluppatori.
Scegli il modello: Invia le richieste all'endpoint Kling 1.0 all'indirizzo /generation/kling-ai/kling-v1.
Aggiungi i tuoi input: Per la conversione da testo a video, passa un prompt e un aspectRatio; per la conversione da immagine a video, passa un URL image e un imageTail facoltativo, quindi imposta length (5 o 10), mode e strength.
Generazione e recupero: Invia l'attività, verifica lo stato dell'attività restituita e scarica il video completato una volta che l'elaborazione è andata a buon fine.
Suggerimenti sulle migliori pratiche per l'API Kling 1.0
Considera il prompt come la descrizione di un'inquadratura. Indica il soggetto, l'azione e il movimento di camera desiderati, poiché Kling 1.0 risponde bene quando il comportamento dell'obiettivo viene specificato esplicitamente.
Una semplice formula di richiesta
Soggetto + azione + movimento della telecamera (panoramica, inclinazione, zoom, rotazione) + ambientazione e illuminazione + stile
Cosa dovresti notare
Chiama la telecamera: Indica il movimento esatto, ad esempio zoom lento in avanti o inclinazione verso l'alto, in modo che il controllo integrato della telecamera abbia un obiettivo chiaro.
Utilizzare i fotogrammi di chiusura: Quando una clip necessita di una conclusione precisa, fornire un'immagine di inizio e di fine anziché descrivere la conclusione a parole.
Intensità della sintonizzazione: Abbassare l'intensità del prompt per mantenere un'immagine più fedele alla sorgente, aumentarla per accentuare il movimento e il cambiamento descritti.
Concentrati su un'unica azione: Un singolo movimento chiaro si mantiene più coerente per 5 o 10 secondi rispetto a diversi movimenti concorrenti.
Aggiungi elementi negativi: Elenca gli elementi da evitare affinché il modello sia privo di confusione, distorsioni o dettagli non pertinenti.
Rapporto di corrispondenza con la piattaforma: Scegli 9:16 per i feed verticali, 16:9 per i giocatori o 1:1 per i posizionamenti quadrati in primo piano.
Esempi di richieste
Interni con telecamera integrata
"Una silenziosa sala di lettura in biblioteca al crepuscolo, la polvere che si solleva nella luce, una lampada che brilla su un tavolo di legno. Lenta zoomata della telecamera su un libro aperto, calda illuminazione ambrata, stile calmo e realistico."
Transizione a libro
"Una gru di origami chiusa su una scrivania si dispiega e si appiattisce su un singolo foglio di carta. Telecamera dall'alto stabile, luce naturale soffusa, stile pulito e minimalista, che si risolve sul foglio piatto come inquadratura finale."
Animazione di foto statiche
"Anima questa foto della facciata di un bar: vapore che sale dalle tazze sui tavolini all'aperto, una tenda a righe che sventola, passanti sullo sfondo. Una leggera panoramica orizzontale della telecamera, luce di mezzogiorno, stile naturale e realistico."
Test di movimento direzionale
"Un kayakista solitario attraversa in canoa un tranquillo lago di montagna all'alba, la nebbia sull'acqua, le creste di pini sullo sfondo. La telecamera si alza dal kayak verso le cime, la fresca luce del mattino, uno stile nitido e realistico."
Kling 1.0 contro Runway Gen-3 Alpha contro Luma Dream Machine
✅ Pennello di movimento e movimenti della telecamera
✅ Parole chiave della telecamera, meno granulari
Controllo fotogramma iniziale e finale
✅ Immagine iniziale più immagine finale
✅ Primo e ultimo fotogramma
✅ Supporto fotogrammi chiave
Inserimento di testo e immagini
✅
✅
✅
Controllo rapido della forza
✅ Regolabile
❌ Non esposto
❌ Non esposto
Durata della clip
5 o 10 secondi
Brevi clip dirette
Brevi clip dirette
Modalità di qualità
Standard, Pro, 4K
Livello singolo
Livello singolo
Consigliato per
Inquadrature dirette dalla telecamera e con cornice
Montaggio con pennello dinamico
Bozze rapide ed espressive
Perché scegliere l'API Kling 1.0 ?
Kling 1.0 è adatto a prodotti che necessitano di un controllo a livello di inquadratura, dai movimenti di macchina diretti alle clip che si aprono e si chiudono su fotogrammi selezionati, sia per il testo che per le immagini.
Tramite Pollo API, puoi accedere a Kling 1.0 con una sola chiave API, insieme a oltre 300 modelli di video e immagini leader del settore, con documentazione chiara, monitoraggio dello stato delle attività e una generazione a un costo inferiore rispetto a Fal AI.
Integra l'endpoint Kling 1.0 nell'API Pollo per implementare funzionalità video gestite dalla fotocamera, quindi testale rispetto alle versioni più recenti Kling e ai modelli concorrenti senza modificare l'integrazione.
Domande frequenti sull'API Kling 1.0
Cos'è Kling 1.0?
Kling 1.0 è il modello video originale Kling AI per la generazione di video da testo e da immagine, caratterizzato dal controllo direzionale della telecamera, dalla guida dei fotogrammi iniziali e finali e dalla forza di suggerimento regolabile.
L'API Kling 1.0 supporta l'inserimento di testo e immagini?
Sì. Puoi generare un'animazione a partire da un testo con un rapporto d'aspetto a tua scelta, oppure animare un URL di un'immagine e, facoltativamente, aggiungere un'immagine finale per dare forma all'animazione.
Quali sono le durate e le modalità dei video disponibili?
Kling 1.0 produce clip da 5 o 10 secondi e offre modalità standard, pro e 4K, consentendo di bilanciare la velocità di generazione con il livello di dettaglio dell'output.
Come funziona il controllo della telecamera?
È possibile richiedere movimenti come panoramica, inclinazione, rotazione, zoom e tracciamento orizzontale o verticale, oltre a movimenti preimpostati, che consentono un controllo preciso sulla traiettoria di ogni ripresa.
Che cosa fa la forza di risposta immediata?
L'intensità del prompt determina quanto il risultato segua fedelmente il prompt rispetto all'immagine di origine, consentendo di scegliere tra un movimento fedele e una reinterpretazione più libera.
Perché eseguire Kling 1.0 tramite l'API Pollo ?
Pollo API offre un'integrazione per Kling 1.0 e oltre 300 altri modelli, con documentazione, tracciamento delle attività e generazione a costi inferiori rispetto ai fornitori comparabili.
