Come si usa l'API di Kling 3.0? Guida in cinese a testo-video e immagine-video

TL;DR

• Kling 3.0 è un modello video prodotto da Kuaishou; su HiAPI è disponibile con due endpoint: testo-video kling-3.0/text-to-video e immagine-video kling-3.0/image-to-video, da 3 a 15 secondi per clip, fino a 4K, con audio nativo.Apri la pagina del modello per generare online; i nuovi utenti ricevono 200 crediti alla registrazione.
• Tariffa al secondo: 720p $0,10 al secondo, con audio $0,143; 1080p $0,129, con audio $0,193; 4K $0,479. 5 secondi a 720p costano solo $0,50.
• API in due passaggi: POST /v1/tasks per inviare, poi usa taskId per recuperare il risultato. I curl e Python qui sotto sono pronti da copiare ed eseguire.

Prima guarda il risultato

Testo-video: un prompt in inglese, una richiesta.

A lone red fox sprints across a windswept snowy ridge at golden hour, powder snow kicking up behind each stride, then leaps over a frozen creek in a graceful arc. Cinematic, dramatic side lighting, ultra-detailed fur, shallow depth of field, smooth motion.

Genera con questo prompt → (5 secondi, 16:9)

Esempio dalla pagina del modello kling-3.0/text-to-video, 5 secondi. A 720p senza audio costa $0,50, a 1080p con audio $0,965.

Immagine-video: usa l'immagine del faro qui sotto come primo frame.

The waves surge and crash against the rocks, the lighthouse beam sweeps slowly across the stormy night sky, rain streaks through the wind. Smooth cinematic motion, synchronized ambient sound of waves and storm.

Genera con questo prompt → (carica la tua immagine del primo frame, 5 secondi)

Esempio dalla pagina del modello kling-3.0/image-to-video, 5 secondi. A 720p con audio costa $0,715.

Kling 3.0, Omni o Turbo: come scegliere?

Su HiAPI Kling 3.0 ha tre linee, con nomi dei modelli, prezzi e parametri diversi:

Modello	Endpoint	720p / secondo	1080p / secondo	4K / secondo	Ideale per
Kling 3.0 kling-3.0/*	Testo-video, immagine-video (primo frame o primo+ultimo frame)	$0,10, con audio $0,143	$0,129, con audio $0,193	$0,479	Video finiti con audio, cortometraggi multi-inquadratura
Kling 3.0 Omni kling-3.0-omni/*	Testo-video, immagine-video, reference-to-video, video rewrite	$0,10, con audio $0,129	$0,129, con audio $0,1645	$0,479	Bloccare persone/prodotti, seguire il movimento di un video di riferimento
Kling 3.0 Turbo kling-3.0-turbo/*	Testo-video, immagine-video	$0,13	$0,16	—	Nessuna distinzione per l'audio, prezzo solo per risoluzione

Se ti servono solo testo-video e immagine-video, scegli kling-3.0; per bloccare il soggetto con un'immagine di riferimento, usare un video di riferimento o riscrivere un video esistente, vedi la guida in cinese a Kling 3.0 Omni.

Due percorsi per iniziare

Prova online (senza scrivere codice)

1. Apri la pagina del modello Kling 3.0 testo-video, registrati o accedi.
2. Incolla il prompt, scegli durata, risoluzione, formato e decidi se attivare l'audio.
3. Clicca Genera e scarica direttamente il video prodotto.

Chiamata API

1. Crea una API Key nella console.
2. Invia il task con POST https://api.hiapi.ai/v1/tasks; restituisce un taskId.
3. Controlla lo stato con GET /v1/tasks/{taskId}; quando status è success, scarica il video da output[0].url.

curl: il primo video

5 secondi a 720p senza audio, $0,50:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0/text-to-video",
    "input": {
      "prompt": "金色夕阳下，一只红狐在风雪覆盖的山脊上疾奔，雪粉飞扬，电影级侧光，平滑跟拍",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "sound": false
    }
  }'

Risposta:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Controlla il risultato:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: invio, polling, download

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(model, timeout_s=900, **params):
    body = {"model": model, "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 竖屏、带声音的口播短视频
url = generate(
    "kling-3.0/text-to-video",
    prompt="竖屏短视频：一位博主拿着新耳机对着镜头介绍，手势自然，室内自然光，口型和说话声同步",
    duration=6, resolution="1080p", aspect_ratio="9:16", sound=True,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Questo video da 6 secondi a 1080p con audio costa $1,158.

Immagine-video: un primo frame, o primo e ultimo frame

Cambia il nome del modello in kling-3.0/image-to-video e inserisci le immagini in image_urls: 1 immagine è il primo frame, 2 immagini sono [primo frame, ultimo frame].

{
  "model": "kling-3.0/image-to-video",
  "input": {
    "image_urls": [
      "https://your-cdn.example.com/start.jpg",
      "https://your-cdn.example.com/end.jpg"
    ],
    "prompt": "镜头缓慢推进，两个画面之间平滑过渡",
    "duration": 5,
    "resolution": "720p",
    "sound": false
  }
}

• Le immagini supportano JPEG / PNG / WebP; SVG non è supportato.
• Immagine-video non ha aspect_ratio: il formato segue il primo frame.
• Il prompt è facoltativo: scrivi «come deve muoversi dopo», senza ridescivere l'intera immagine.

Panoramica dei parametri

Parametro	Valori	Descrizione
prompt	stringa	Obbligatorio per testo-video, facoltativo per immagine-video
image_urls	1–2 immagini	Solo immagine-video; 1 immagine è il primo frame, 2 sono primo e ultimo frame
duration	intero da 3 a 15, predefinito 5	In secondi
resolution	720p / 1080p / 4K, predefinito 1080p	Se non specificato, viene fatturato a 1080p
aspect_ratio	16:9 / 9:16 / 1:1, predefinito 16:9	Solo testo-video
sound	predefinito false	Se attivato genera dialoghi, effetti sonori e suoni ambientali

Calcolo dei costi

Durata	720p	720p con audio	1080p	1080p con audio	4K
3 secondi	$0,30	$0,429	$0,387	$0,579	$1,437
5 secondi	$0,50	$0,715	$0,645	$0,965	$2,395
10 secondi	$1,00	$1,43	$1,29	$1,93	$4,79
15 secondi	$1,50	$2,145	$1,935	$2,895	$7,185

resolution è impostato a 1080p per impostazione predefinita; quando modifichi il prompt, ricorda di specificare esplicitamente 720p per risparmiare oltre il 20%. Per altri confronti sui prezzi vedi prezzi API di Kling 3.0.

Attenzione prima del go-live

• Usa i callback invece del polling: al livello superiore della richiesta (allo stesso livello di input) aggiungi "callback": {"url": "https://tuo-dominio/hiapi/callback"} e deduplica per taskId.
• Salva subito i file: output[0].url è un link temporaneo; scaricalo immediatamente nel tuo storage.
• Retry con chiave di idempotenza: aggiungi Idempotency-Key nell'header della richiesta; con la stessa chiave il task viene creato una sola volta.
• Rimborso automatico in caso di errore: fatturazione solo per i video generati con successo.

Domande frequenti

Posso scrivere il prompt in cinese?

Sì. Va bene sia in cinese sia in inglese; anche i contenuti dei dialoghi possono essere scritti direttamente nel prompt.

L'audio si paga a parte?

Con sound: true il prezzo unitario è più alto: a 720p da $0,10 a $0,143 al secondo, a 1080p da $0,129 a $0,193. Se ti serve solo l'immagine, lascia il valore predefinito false.

Quanto dura al massimo una clip?

Da 3 a 15 secondi. Per video più lunghi, genera in segmenti e monta in seguito.

Kling 3.0 o Seedance 2.5: come scegliere?

Kling 3.0 ha un prezzo unitario più basso e supporta il 4K; Seedance 2.5 arriva fino a 30 secondi per clip. Per il confronto vedi differenze tra Kling 3.0 e Seedance 2.5.

Per esempi di prompt pronti, vedi la guida ai prompt di Kling 3.0; puoi anche copiare il prompt della volpe rossa qui sopra e andare alla pagina del modello per generare.