Kuaishou

Kling 3.0

kling-3.0/motion-control

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/motion-control

Input

Creazioni

Vedi tutte le creazioni

Output

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

kling-3.0/motion-control per second

Specifiche	Prezzo unitario
720P	$0.100
1080P	$0.172

Panoramica della posizione

kling-3.0/motion-control è una linea di generazione video guidata dal movimento: si inseriscono un'immagine di riferimento di una persona e un video di riferimento con movimento, e si ottiene un nuovo video orchestrato da quel movimento. L'aspetto del personaggio deriva dall'immagine, il movimento e le espressioni dal video, mentre il prompt opzionale serve ad aggiungere scena, stile e inquadratura. È adatto a sviluppatori che necessitano di trasferire performance di persone reali su un personaggio specifico, ad esempio in scenari come miniserie, contenuti parlati o presentazioni e-commerce in cui occorre riutilizzare lo stesso materiale di movimento.

Punti chiave

Input disaccoppiati di personaggio e movimento — l'aspetto della persona è determinato dall'immagine di riferimento, il ritmo del movimento dal video di riferimento; la stessa performance può essere applicata a materiali di personaggi diversi.
Durata dell'output adattiva in base alla modalità di orientamento del personaggio — seguendo il video, il personaggio può essere emesso fino a 30 secondi; seguendo l'immagine, fino a 10 secondi; si può scegliere in base al tipo di inquadratura.
Supporto per conservare l'audio originale del video di riferimento — per impostazione predefinita viene mantenuta la traccia audio del video di riferimento, con movimento e suono sincronizzati in uscita, evitando la fase di sincronizzazione separata.

Descrizione delle capacità

Trasferimento di movimento guidato da due materiali: è necessario fornire due input, immagine della persona e video del movimento; l'immagine determina l'aspetto del personaggio, il video determina movimento ed espressioni, e il risultato generato eredita entrambi.

Commutazione della modalità di orientamento del personaggio: character_orientation può essere video o image: la prima è adatta a movimenti complessi, con durata massima di 30 secondi; la seconda è adatta al movimento di camera, con durata massima di 10 secondi.

Il prompt integra scena e inquadratura: il prompt opzionale può arrivare a 2500 caratteri ed è usato per aggiungere scena, stile e direzione dell'inquadratura, senza modificare movimento ed espressioni determinati dal video di riferimento.

Risoluzione selezionabile e conservazione della traccia audio: l'output può essere 720p o 1080p ed è possibile scegliere se conservare l'audio originale del video di riferimento; la risoluzione più alta comporta un costo maggiore.

Scenari d'uso

Creatori di miniserie e contenuti parlati che riutilizzano materiale di movimento — caricando una foto del personaggio e un video di performance si ottiene un prodotto finito con lo stesso movimento per quel personaggio, utile alla produzione di contenuti seriali.
E-commerce e brand per dimostrazioni di prodotto con personaggi — abbinando l'immagine di una modella o di un avatar a un video di dimostrazione del prodotto si produce un breve filmato dimostrativo con persona, da usare nelle pagine di dettaglio e nelle campagne.
Contenuti di movimento che richiedono di conservare l'audio originale — attivando la conservazione dell'audio si ottiene direttamente un video con traccia audio sincronizzata, da pubblicare come breve video sui social.

Limiti e consigli di scelta

Entrambi i materiali di input hanno requisiti obbligatori: nell'immagine della persona testa, spalle e busto devono essere chiaramente visibili, con rapporto d'aspetto tra 2:5 e 5:2 e dimensione non superiore a 10MB; il video di riferimento deve durare da 3 a 30 secondi, essere una ripresa continua a inquadratura singola con soggetto visibile e non superare 100MB. Movimento ed espressioni sono determinati dal video di riferimento; il prompt può regolare solo scena e stile, non riscrivere il movimento stesso. Per la generazione da solo testo o da immagine a video occorre scegliere altre linee della stessa famiglia; i contenuti narrativi lunghi richiedono comunque una generazione a segmenti e un successivo montaggio.

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/motion-control

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per kling-3.0/motion-control e la route default — vedi la tabella dei parametri sotto.

promptstringOpzionalemaxLength 2500

Prompt facoltativo per descrivere scena, stile e inquadratura. I movimenti e le espressioni del personaggio provengono dal video di riferimento, l'aspetto del personaggio proviene dall'immagine di riferimento; se non compilato, si fa affidamento sui materiali di riferimento stessi.

image_urlstringObbligatorio

Immagine di riferimento del personaggio, supporta i formati jpeg/png/jpg, dimensione non superiore a 10MB, larghezza e altezza entrambe maggiori di 340px, rapporto d'aspetto tra 2:5 e 5:2; testa, spalle e busto devono essere chiaramente visibili.

video_urlstringObbligatorio

Video di riferimento per i movimenti, supporta i formati mp4/mov, dimensione non superiore a 100MB, durata da 3 a 30 secondi, deve essere una ripresa continua a inquadratura singola con testa, spalle e busto del soggetto visibili; la durata dell'output segue quella del video, con un massimo di 10 secondi quando character_orientation è image e di 30 secondi quando è video.

resolutionstringOpzionalePredefinito: "720p"

Risoluzione dell'output, più alta è la risoluzione maggiore è il costo; predefinita 720p.

Opzioni:720p1080p

keep_original_soundbooleanOpzionalePredefinito: true

Indica se mantenere l'audio originale del video di riferimento nell'output; predefinito true, ovvero mantenuto per impostazione predefinita.

character_orientationstringOpzionalePredefinito: "video"

Origine dell'orientamento del personaggio: con video l'orientamento segue il video di riferimento, adatto a movimenti complessi, supporta fino a 30 secondi; con image l'orientamento segue l'immagine di riferimento, adatto ai movimenti di camera, supporta fino a 10 secondi. Predefinito video.

Opzioni:videoimage

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/motion-control",
  "input": {
    "image_url": "…",
    "video_url": "…",
    "resolution": "720p",
    "keep_original_sound": true,
    "character_orientation": "video"
  }
}'

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/motion-control",
    input: {
      "image_url": "…",
      "video_url": "…",
      "resolution": "720p",
      "keep_original_sound": true,
      "character_orientation": "video"
    }
  }),
});
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/motion-control",
        "input": {
          "image_url": "…",
          "video_url": "…",
          "resolution": "720p",
          "keep_original_sound": True,
          "character_orientation": "video"
        }
    },
)
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"
    }
  }
}