Kuaishou

Kling 3.0

kling-3.0/text-to-video

Serie unificata di generazione video multimodale, supporta la generazione di video da testo, da immagine, da riferimento e il montaggio all'interno del video, con sincronizzazione labiale nativa e audio multilingue

kling-3.0-omni/image-to-video kling-3.0-omni/reference-to-video kling-3.0-omni/text-to-video kling-3.0-omni/transformation kling-3.0/image-to-video kling-3.0/motion-control kling-3.0/text-to-video

Prova kling-3.0/text-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

kling-3.0/text-to-video per second

Specifiche	720P	1080P	4K
Sound Off	$0.100	$0.129	—
Sound On	$0.143	$0.193	—
—	—	—	$0.479

Panoramica della posizione

kling-3.0/text-to-video è la linea text-to-video della serie Kling 3.0: inserendo una descrizione testuale si genera un video completo con audio nativo opzionale. Supporta durate da 3 a 15 secondi, risoluzioni da 720p a 4K e tre formati (orizzontale, verticale e quadrato): è ideale per sviluppatori e team di contenuti che devono trasformare rapidamente script o idee in video pubblicabili, con tariffazione al secondo che consente di controllare i costi in base alla durata.

Punti di forza

Text-to-video con audio nativo——attivando l'opzione audio si generano effetti sonori e suoni ambientali sincronizzati con le immagini, eliminando la fase di sonorizzazione separata.
Risoluzione e formato coprono le esigenze di pubblicazione più comuni——tre livelli di risoluzione (720p, 1080p, 4K) e formati 16:9, 9:16, 1:1: con una sola chiamata si ottiene il formato orizzontale, verticale o quadrato desiderato.
Durata regolabile in base alla narrazione——generazione da 3 a 15 secondi per singola chiamata: sia clip brevi sia sequenze multi-inquadratura si realizzano attraverso la stessa interfaccia.

Descrizione delle capacità

Dal solo testo al video finito: basta inviare il prompt per ottenere un video, ideale per team che hanno già script o testi ma mancano di materiale e devono produrre rapidamente.

Audio nativo o silenzioso, a scelta: è possibile attivare effetti sonori e suoni ambientali sincronizzati, oppure disattivare l'audio per ottenere solo le immagini, così da aggiungere musiche o voci in post-produzione.

Risoluzione e formato parametrizzati: le specifiche di output si controllano direttamente tramite i parametri di risoluzione e formato, riducendo le perdite di qualità dovute a ritaglio e ridimensionamento successivi alla generazione.

Durata e costi correlati: la tariffazione è basata sui secondi prodotti; riducendo la durata o la risoluzione si comprime il costo per singolo video, utile per testare in batch.

Scenari di utilizzo

Team di marketing che producono rapidamente spot pubblicitari da testi——trasformare i testi delle campagne in video 9:16 o 16:9, da usare direttamente per i feed e i video di brand.
Creator di contenuti che producono in serie video brevi verticali——generare in batch materiali video brevi 9:16 in base ai temi, per gli aggiornamenti quotidiani sui social.
Validare idee di storyboard quando mancano riprese reali——generare brevi clip di anteprima da descrizioni testuali per valutare l'effetto delle inquadrature in fase di storyboard e revisione creativa.

Limiti e consigli di scelta

La durata massima per singola generazione è di 15 secondi: le narrazioni lunghe richiedono generazioni separate da montare poi insieme. L'audio nativo copre solo effetti sonori e suoni ambientali, non dialoghi né sincronizzazione labiale: per i contenuti dialogati occorre aggiungere audio separatamente o passare a un'altra linea della stessa serie. Risoluzione, durata e attivazione dell'audio influiscono sul costo: prima di una produzione in batch conviene verificare i risultati con clip brevi a bassa risoluzione. Se si dispone già di immagini di riferimento o serve il controllo dei movimenti, è opportuno scegliere la linea image-to-video o quella per il controllo dei movimenti della stessa serie.

Novità

Vedi il changelog →

Nuovo modello Nuovo modello: Kling 3.0 Omni (可灵 O3), richiamabile tramite POST /v1/tasks. kling-3.0-omn… Oct 12, 2026

Domande frequenti

Vedi tutte le domande →

Kling 3.0 Image-to-Video richiede il caricamento di un'immagine?

Sì. Attualmente kling-3.0/image-to-video è una pipeline image-to-video: l'immagine di input definisce il soggetto e la composizione iniziale, mentre il Prompt gestisce i movimenti, la telecamera e i cambiamenti dell'ambiente.
Quali durate e risoluzioni supporta Kling 3.0 Image-to-Video?

L'attuale contratto di richiesta di HiAPI supporta 3–15s, con risoluzioni di output 720p, 1080p e 4K. I valori disponibili sono quelli indicati nel pannello dei parametri della pagina e nella documentazione API.
Come viene fatturato Kling 3.0 Image-to-Video?

Le attività vengono fatturate in base alla durata dell'output e al livello selezionato. La pagina mostra il prezzo in tempo reale seguendo l'unità monetaria globale; l'addebito finale fa riferimento al record delle attività completate con successo.
Come migliorare la stabilità del soggetto nella generazione di video da immagine?

Usa un'immagine di input con un soggetto chiaro, poche occlusioni e una composizione completa; nel Prompt descrivi prima l'azione principale e la ripresa, poi elenca gli aspetti dell'aspetto, i materiali e le relazioni con lo sfondo che devono essere preservati. Per il primo test si consiglia una durata breve.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: kling-3.0/text-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per kling-3.0/text-to-video e la route default — vedi la tabella dei parametri sotto.

soundbooleanOpzionalePredefinito: false

Indica se generare effetti sonori e suoni ambientali sincronizzati con le immagini; se attivato, il costo della chiamata è più elevato. Valore booleano, predefinito false.

promptstringObbligatorio

Prompt testuale che descrive il contenuto del video da generare, espresso come stringa.

durationintegerOpzionalePredefinito: 5min 3max 15

Durata della clip video in secondi, con valori da 3 a 15; il costo aumenta con la durata. Predefinito 5 secondi.

resolutionstringOpzionalePredefinito: "1080p"

Risoluzione del video in uscita, espressa come stringa; più alta è la risoluzione, più alto è il costo. Predefinito 1080p.

Opzioni:720p1080p4K

aspect_ratiostringOpzionalePredefinito: "16:9"

Rapporto d'aspetto del video in uscita, espresso come stringa. Predefinito 16:9.

Opzioni:16:99:161:1

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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/text-to-video",
  "input": {
    "sound": false,
    "prompt": "…",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }
}'

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/text-to-video",
    input: {
      "sound": false,
      "prompt": "…",
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "16:9"
    }
  }),
});
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/text-to-video",
        "input": {
          "sound": False,
          "prompt": "…",
          "duration": 5,
          "resolution": "1080p",
          "aspect_ratio": "16:9"
        }
    },
)
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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}