Kuaishou

Kling 3.0

kling-3.0-omni/transformation

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-omni/transformation

Input

Subjects

Creazioni

Vedi tutte le creazioni

Output

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

kling-3.0-omni/transformation per second

Specifiche	Prezzo unitario
720P	$0.143
1080P	$0.193
4K	$0.479

Panoramica

La linea di trasformazione video di Kling 3.0 Omni è pensata per gli sviluppatori che desiderano creare contenuti derivati partendo da materiale esistente. Basta fornire un video sorgente da 3 a 15,5 secondi e una descrizione testuale per riscrivere il contenuto del video in base alla descrizione; la durata e il formato di output seguono il video sorgente e si può scegliere una risoluzione di 720p, 1080p o 4K. È possibile fare riferimento a un massimo di 7 soggetti riutilizzabili tramite la sintassi @nome nel prompt, ciascuno definito da 2 a 4 immagini, ideale per attività di riscrittura in cui occorre mantenere la coerenza di persone o oggetti. Si richiama tramite l'interfaccia unificata di HiAPI.ai.

Punti di forza principali

Riscrittura basata sul video sorgente, non generazione da zero: la durata e le proporzioni dell'output ereditano quelle del video sorgente, offrendo una struttura visiva di riferimento solida, ideale per una ricreazione mirata di materiale esistente.
Il prompt può citare soggetti con nome: si possono registrare fino a 7 soggetti, ciascuno descritto con 2-4 immagini e richiamato nel prompt tramite @nome, così da mantenere la stessa figura attraverso più inquadrature.
Risoluzione selezionabile fino a 4K: l'output offre tre livelli, 720p, 1080p e 4k, consentendo di scegliere la nitidezza in base al canale di distribuzione.

Descrizione delle capacità

Riscrittura mirata del video sorgente: caricare un video sorgente MP4 o MOV (massimo 200 MB, da 3 a 15,5 secondi, da 700 a 4553 pixel, da 24 a 60 fps), trasformarne il contenuto in base al prompt; l'output mantiene durata e formato del video sorgente.

Riferimento a più soggetti: fornire da 2 a 4 immagini JPG o PNG per lo stesso soggetto e assegnare un nome, fino a 7 gruppi, da richiamare nel prompt con @nome, riducendo i costi di descrizione testuale dell'aspetto dei soggetti.

Selezione del livello di risoluzione: l'output può essere 720p, 1080p o 4k, con 720p predefinito, per bilanciare nitidezza e costi di generazione in base all'uso.

Controllo della lunghezza del prompt: il prompt supporta fino a 3072 caratteri, sufficienti per istruzioni di riscrittura piuttosto complete mantenendo un singolo blocco controllabile.

Scenari di utilizzo

Team pubblicitari e di marketing che riscrivono cortometraggi esistenti: trasformare materiale girato o generato in versioni creative diverse, ottenendo video brevi pronti per la distribuzione.
Operatori e-commerce che sostituiscono le immagini di presentazione dei prodotti: usare un breve video del prodotto come sorgente e riscriverne scena o modalità di presentazione tramite prompt, ottenendo un video dimostrativo adatto alla pagina prodotto.
Team di contenuti che riutilizzano materiale di un personaggio: una volta registrato un soggetto-personaggio fisso, richiamarlo con @nome nelle varie attività di trasformazione per produrre una serie di video con un'immagine coerente.

Limiti e suggerimenti per la scelta

Questa linea accetta un solo video sorgente e l'output eredita durata e formato del video sorgente; i contenuti lunghi richiedono un'elaborazione a segmenti. Il video sorgente deve rispettare vincoli come 3-15,5 secondi e massimo 200 MB; valori fuori intervallo non sono utilizzabili direttamente. Le specifiche indicano esplicitamente che non viene generato audio, quindi le scene che richiedono suono vanno gestite separatamente. Se l'attività consiste nel generare da zero o nel puro video da immagine, si può passare alle linee text-to-video o image-to-video della stessa serie; per un controllo preciso dei movimenti, considerare la linea di controllo del movimento.

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-omni/transformation

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

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

promptstringObbligatoriominLength 1maxLength 3072

Testo di descrizione del video, utilizzato per illustrare il contenuto video che si desidera generare; se è necessario fare riferimento a un soggetto di input, menzionare il nome del soggetto corrispondente nel testo nella forma @name.

elementsarrayOpzionalemaxItems 7

Array di soggetti riutilizzabili, massimo 7; ogni elemento è composto da un nome, una breve descrizione e 2-4 immagini, ed è possibile fare riferimento ad esso nel prompt nella forma @name.

Array [ object ]

Elementi dell'array

namestringObbligatoriominLength 1

Nome del soggetto, utilizzato come identificatore di riferimento @name nel prompt; deve essere univoco e non contenere spazi.

descriptionstringObbligatoriominLength 1

Breve descrizione testuale del soggetto, utilizzata per aiutare il modello a comprenderne le caratteristiche.

element_input_urlsarrayObbligatoriominItems 2maxItems 4

Array di immagini dello stesso soggetto; è necessario fornirne 2-4, in formato JPG o PNG.

Array [ string ]

resolutionstringOpzionalePredefinito: "720p"

Risoluzione del video di output, predefinita 720p.

Opzioni:720p1080p4k

video_urlsarrayObbligatoriominItems 1maxItems 1

Array di video di origine da convertire, supporta MP4 o MOV, massimo 200MB, durata 3-15,5 secondi, larghezza e altezza 700-4553 pixel, frame rate 24-60 fps; la durata e il rapporto d'aspetto del video di output seguono il video di origine e non viene generato audio.

Array [ string ]

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-omni/transformation",
  "input": {
    "prompt": "…",
    "resolution": "720p",
    "video_urls": "…"
  }
}'

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-omni/transformation",
    input: {
      "prompt": "…",
      "resolution": "720p",
      "video_urls": "…"
    }
  }),
});
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-omni/transformation",
        "input": {
          "prompt": "…",
          "resolution": "720p",
          "video_urls": "…"
        }
    },
)
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"
    }
  }
}