Kuaishou

Kling 2.5

kling-2.5-turbo/image-to-video

Modello image-to-video lanciato da Kuaishou, eccelle nella fluidità del movimento e nella coerenza dei personaggi, supporta prompt negativi e regolazione CFG, adatto alla generazione di brevi video con inquadrature altamente dinamiche

kling-2.5-turbo/image-to-video kling-2.5-turbo/text-to-video

Prova kling-2.5-turbo/image-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

kling-2.5-turbo/image-to-video per second

Prezzo unitario	$0.060

Presentazione

kling-2.5-turbo/image-to-video è un modello per attività di generazione video da immagine: utilizzando una o due immagini come fotogramma iniziale e, opzionalmente, fotogramma finale, combinate con un prompt testuale, genera video brevi di 5 o 10 secondi. Supporta prompt negativi e una regolazione dell'intensità di aderenza al prompt tra 0 e 1; il formato può essere scelto in modalità singola immagine o doppia immagine. È adatto a sviluppatori che desiderano trasformare immagini statiche in sequenze dinamiche e controllare il contenuto visivo tramite parametri.

Punti di forza principali

Guida a doppia immagine con fotogrammi iniziale e finale: è possibile passare un fotogramma iniziale o aggiungerne uno finale, in modo che il video parta da una scena specificata e si transizioni verso una scena finale specificata.
Aderenza al prompt regolabile: cfg_scale regola tra 0 e 1 il grado di aderenza del video alla descrizione testuale, consentendo di scegliere tra libertà creativa e riproduzione rigorosa.
Prompt negativo per escludere interferenze: supporta prompt negativi fino a 2496 caratteri, utili a sopprimere contenuti indesiderati nell'immagine.

Descrizione delle funzionalità

Input di fotogramma iniziale e finale opzionale: image_urls accetta da 1 a 2 URL di immagini, supporta jpeg/png/webp, massimo 10 MB per immagine; quando vengono passate due immagini, viene generata una transizione dal primo all'ultimo fotogramma.

Selezione di durata e formato: duration può essere 5 o 10 secondi; in modalità singola immagine i formati supportano 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, mentre in modalità doppia immagine sono limitati a 16:9, 9:16, 1:1.

Prompt e prompt negativo: prompt è obbligatorio, massimo 2500 caratteri, e descrive azioni del soggetto, cambiamenti ambientali e movimenti di camera; negative_prompt è lungo al massimo 2496 caratteri e serve a escludere contenuti indesiderati.

Regolazione dell'aderenza: cfg_scale assume valori 0–1; più è alto, maggiore è l'aderenza del video alla descrizione testuale, permettendo di adattare il grado di corrispondenza del risultato alle esigenze della scena.

Scenari di utilizzo

Creatori di spot pubblicitari e video di prodotto: singola immagine di prodotto + descrizione dell'azione: trasformano un'immagine statica di prodotto in una breve sequenza con movimento di camera, da usare come materiale dinamico in video di brand o e-commerce.
Previsualizzazione cinematografica: concept art + fotogrammi iniziale e finale specificati: con due concept art si fissano le scene di inizio e fine e si genera una sequenza di transizione come storyboard o anteprima concettuale.
Gestione di contenuti social: immagine verticale + prompt breve: con formato 9:16 si converte un'immagine in un breve video verticale di 5 o 10 secondi, pronto per la pubblicazione sui social.

Limiti e consigli di scelta

La durata massima di una singola generazione è di 10 secondi, quindi non è adatto a produrre direttamente video lunghi; in modalità doppia immagine i formati supportati sono solo 16:9, 9:16 e 1:1, mentre in modalità singola immagine, durante l'elaborazione di riserva, potrebbe seguire le proporzioni dell'immagine originale senza garantire una corrispondenza esatta con le dimensioni richieste. Le immagini WebP non vengono convertite automaticamente e alcune elaborazioni di riserva accettano solo jpeg/png. La qualità della generazione dipende molto dalla scrittura del prompt e dall'ottimizzazione di cfg_scale. Se serve generare video direttamente da testo, è opportuno scegliere un modello della stessa famiglia per la generazione video da testo.

Novità

Vedi il changelog →

Nuovo modello Aggiunta della documentazione di kling-2.5-turbo/text-to-video Oct 10, 2026
Nuovo modello Nuova documentazione dei modelli video: kling-2.5-turbo/image-to-video (guidato dal primo frame, fisso 5 secondi 1080p, opzionale… Oct 8, 2026

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-2.5-turbo/image-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

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

promptstringObbligatoriominLength 1maxLength 2500

Testo di prompt che descrive le azioni del soggetto, i cambiamenti ambientali e i movimenti di camera, determinando l'andamento del contenuto del video generato.

durationintegerOpzionalePredefinito: 5min 5max 10

Seleziona il numero di secondi del video da generare, valore intero, predefinito 5.

Opzioni:510

cfg_scalenumberOpzionalemin 0max 1

Regola il grado di aderenza del video alla descrizione testuale, valore numerico; più alto è il valore, maggiore è la corrispondenza con il prompt.

image_urlsarrayObbligatoriominItems 1maxItems 2

Array di URL delle immagini del primo fotogramma e dell'eventuale ultimo fotogramma, supporta jpeg/png/webp, massimo 10MB per immagine; alcuni percorsi di elaborazione alternativi accettano solo jpeg/png, WebP non viene convertito automaticamente; con due immagini sono supportati solo i rapporti 16:9, 9:16 o 1:1.

Array [ string ]

aspect_ratiostringOpzionalePredefinito: "16:9"

Proporzioni dell'immagine video, predefinito 16:9; con una sola immagine, durante l'elaborazione alternativa le proporzioni potrebbero seguire l'immagine originale senza garanzia di corrispondenza esatta con le dimensioni richieste; quando viene fornito image_urls sono supportati solo 16:9, 9:16 o 1:1.

Opzioni:16:99:161:14:33:421:9

negative_promptstringOpzionalemaxLength 2496

Contenuto che non si desidera appaia nel video, valore stringa, massimo 2496 caratteri.

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-2.5-turbo/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "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-2.5-turbo/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "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-2.5-turbo/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "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"
    }
  }
}

Kling 2.5

Prova kling-2.5-turbo/image-to-video

Input

Creazioni

Output

Prova di concetto dello storyboard: transizione con dolly-in tra primo e ultimo fotogramma

Prompt

Scheda formula dei prompt per video da immagine: dimostrazione visiva della scrittura strutturata

Prompt

Note sul linguaggio cinematografico per video da immagine con Kling 2.5: schema di movimento di camera

Prompt

Capacità image-to-video di Kling 2.5 Turbo illustrate: controllo della ripresa dal primo all'ultimo fotogramma

Prompt

Prezzi

Presentazione

Punti di forza principali

Descrizione delle funzionalità

Scenari di utilizzo

Limiti e consigli di scelta

Novità

Crea un'attività di generazione

Header

Corpo

Esempi di richiesta

Ottieni i dettagli dell'attività

Campi della risposta

Esempi di risposta

Articoli

hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione

Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python

Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling

Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python

Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante

Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori

Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili

Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python

recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione

Modelli correlati

Stesso tipo

Stesso fornitore