Kuaishou
Kling 3.0 Turbo
kling-3.0-turbo/image-to-video
Modello di generazione video pensato per anteprime rapide e iterazioni ad alta frequenza, supporta sia la generazione video da testo che da immagine, può produrre clip da 1 a 15 secondi in 480p–1080p, con un massimo di 7 immagini di riferimento per la generazione da immagine
Prova kling-3.0-turbo/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
kling-3.0-turbo/image-to-video per second
| Specifiche | Prezzo unitario |
|---|---|
| 720P | $0.130 |
| 1080P | $0.160 |
Panoramica della posizione
kling-3.0-turbo/image-to-video è la linea image-to-video della serie Kling 3.0 Turbo di Kuaishou, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Utilizza una singola immagine del primo frame come punto di ancoraggio e, combinata con un prompt testuale, genera video da 3 a 15 secondi, con output selezionabile a 720p o 1080p. Il prompt può contenere fino a 2500 caratteri e supporta l'indicazione dei dialoghi tra virgolette per generare battute con sincronizzazione labiale. Si posiziona sulla produzione rapida e sull'iterazione di più versioni: è adatto agli sviluppatori che necessitano di ottenere rapidamente un'anteprima dinamica da un'immagine statica e di testare i movimenti di camera e la direzione del movimento del soggetto, non alla produzione diretta di un prodotto finale ad alta completezza.
Punti di forza principali
- Guida tramite singolo primo frame, risultato controllabile——è sufficiente un'immagine del primo frame in jpeg/png più un prompt per ottenere il video; soggetto e composizione sono fissati dall'immagine, riducendo la casualità della descrizione testuale.
- Battute con sincronizzazione labiale nel prompt——il prompt supporta l'indicazione dei dialoghi tra virgolette, generando segmenti parlati con sincronizzazione labiale ed eliminando i passaggi preliminari di doppiaggio e allineamento aggiuntivi.
- Durata e risoluzione regolabili in base alle esigenze——la durata dell'output è regolabile da 3 a 15 secondi e la risoluzione è commutabile tra 720p e 1080p; anteprima e quasi-finale possono essere realizzati con lo stesso modello.
Descrizione delle capacità
Image-to-video dal primo frame: passando una singola immagine del primo frame in jpeg/png (massimo 10MB, SVG non supportato) e un prompt, il modello genera il movimento successivo seguendo soggetto e composizione dell'immagine, garantendo che il punto di partenza della scena corrisponda alle aspettative.
Sincronizzazione di battute e labiale: nel prompt è possibile inserire i dialoghi tra virgolette; il segmento generato presenterà i corrispondenti movimenti labiali, adatto a materiali brevi di parlato con persone in scena.
Controllo di durata e risoluzione: la durata è impostabile con valori interi tra 3 e 15 secondi, con valore predefinito di 5 secondi; la risoluzione è selezionabile tra 720p e 1080p, scegliendo il livello di nitidezza in base alla destinazione di pubblicazione.
Risposta a prompt dettagliati: il prompt ha un limite di 2500 caratteri e può descrivere completamente le azioni del soggetto, l'atmosfera della scena e la direzione della camera; descrizioni più lunghe consentono risultati di movimento più vicini alle aspettative.
Scenari applicabili
- Team di design e marketing che verificano la direzione creativa——usando immagini di prodotto o di scena come primo frame, generano rapidamente più versioni di anteprima dinamica per la revisione interna e la conferma della direzione prima delle proposte ai clienti.
- Produzione di prova in batch di varianti di video brevi per i social——partendo dalla stessa immagine di una persona o di un prodotto come primo frame, si modificano i prompt per produrre più segmenti brevi, da selezionare prima della pubblicazione per scegliere la versione con le prestazioni migliori.
- Test dei movimenti di camera e della direzione del movimento del soggetto——usando un'immagine statica come punto di partenza, si testano gli effetti di movimento con diverse descrizioni della camera per definire le riprese e lo storyboard della produzione ufficiale successiva.
- Materiali di parlato con persone e battute——usando un'immagine di un ritratto come primo frame e inserendo dialoghi tra virgolette nel prompt, si generano segmenti brevi di parlato con labiale corrispondente, da usare come hook pubblicitari o materiali per il feed informativo.
Limiti e suggerimenti di selezione
La posizione è la produzione rapida e l'iterazione di anteprime; i dettagli dell'immagine e la coerenza tra inquadrature non sono adatti come prodotto finale ad alta completezza. I progetti che richiedono uno storyboard rigoroso e la coerenza dei personaggi dovrebbero valutare i modelli di livello Pro. Le informazioni reperite non confermano un output audio nativo; la musica o il missaggio del prodotto finale devono essere gestiti separatamente. I risultati sono sensibili al livello di dettaglio del prompt e descrizioni troppo brevi offrono una stabilità limitata. Il primo frame supporta solo una singola immagine, senza riferimento multi-immagine. I parametri effettivamente disponibili sono quelli della configurazione attuale della linea HiAPI.ai.
Domande frequenti
Vedi tutte le domande →-
Kling 3.0 Turbo text-to-video richiede il caricamento di un'immagine?
No. La pagina corrente corrisponde al modello puramente text-to-video kling-3.0-turbo/text-to-video, che accetta solo un Prompt testuale. Per generare un video a partire da un frame iniziale, è necessario utilizzare la pagina dedicata al modello Kling 3.0 Turbo Image-to-Video.
-
Quali durate, risoluzioni e formati supporta Kling 3.0 Turbo?
L'attuale contratto di richiesta di HiAPI supporta 3–15 secondi, 720p o 1080p, e 16:9, 9:16, 1:1. Gli esempi della pagina coprono 720p, 5 secondi e 12 secondi, orizzontale e verticale; 1080p e 1:1 rientrano tra le capacità supportate dall'API, ma la pagina non presenta esempi corrispondenti.
-
Come viene fatturato il text-to-video di Kling 3.0 Turbo?
La fatturazione si basa sulla durata e sulla risoluzione del video generato; 720p e 1080p utilizzano tariffe al secondo diverse; l'importo esatto è determinato dal prezzo in tempo reale della pagina e dal registro delle attività.
-
Come scrivere un prompt text-to-video per Kling 3.0 Turbo?
Scrivi prima il soggetto e la scena, poi descrivi in ordine le azioni e i movimenti di camera, infine aggiungi i requisiti di illuminazione, stile e stabilità. Per i piani sequenza specifica chiaramente single continuous shot, no cuts e il percorso di camera; per i contenuti verticali indica inoltre vertical nel prompt e imposta aspect_ratio su 9:16.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: kling-3.0-turbo/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per kling-3.0-turbo/image-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 2500Descrizione testuale per generare il video, lunghezza massima 2500 caratteri; supporta l'inserimento di battute tra virgolette per sincronizzare il lip-sync dei dialoghi.
durationintegerOpzionalePredefinito: 5min 3max 15Durata del video generato, in secondi, intervallo di valori 3-15, predefinito 5.
image_urlsarrayObbligatoriominItems 1maxItems 1Array di URL delle immagini del primo fotogramma, supporta solo una singola immagine, formato jpeg o png, massimo 10MB per immagine, SVG non supportato.
Array [ string ]
resolutionstringOpzionalePredefinito: "720p"Risoluzione del video generato, predefinita 720p.
720p1080pcallbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0-turbo/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "kling-3.0-turbo/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "kling-3.0-turbo/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Vidu Q3 Vidu $0.149 /secondo -
Wan 3.0 Video Alibaba $0.040 /secondo -
Gemini Omni 1.1 Flash Google $0.450 /video -
LTX 2.5 Fast Lightricks $0.086 /secondo -
HeyGen Avatar IV HeyGen $0.150 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
PixVerse V6 PixVerse $0.036 /secondo -
Kandinsky 6.0 Pro $1.93 /video -
Kling 2.5 Kuaishou $0.060 /secondo -
Kling 3.0 Kuaishou $0.100 /secondo -
Wan 2.7 Video Alibaba $0.100 /secondo -
FLUX 3 Max Black Forest Labs $0.061 /secondo



