Comment utiliser l'API de génération de vidéo à partir de texte Kling 3.0 Turbo ? Paramètres, code et erreurs

TL;DR

• Le nom du modèle de génération de vidéo à partir de texte Kling 3.0 Turbo est kling-3.0-turbo/text-to-video, c'est la version rapide de Kling 3.0. Ouvrez la page du modèle pour l'essayer en ligne.
• Facturation à la seconde : 720p à $0.13 par seconde, 1080p à $0.16 par seconde. Durée de 3 à 15 secondes, n'importe quel entier, 5 secondes en 720p coûtent $0.65.
• Seulement 4 paramètres : prompt, duration, aspect_ratio, resolution. Tout champ supplémentaire (comme seed, negative_prompt) renvoie une erreur 400.

Un exemple pour commencer

720p, 5 secondes, 16:9 :

aerial drone shot sweeping over a norwegian fjord waterfall, mist drifting,
camera gliding forward, smooth natural motion, stable cinematic camera
movement, consistent lighting across frames, cinematic composition, dramatic
directional lighting, rich cohesive color grade, ultra-detailed, premium
commercial finish

Générer avec ce prompt → (5 secondes, 720p, 16:9)

kling-3.0-turbo/text-to-video, 5 secondes.

Référence rapide des paramètres

Champ	Obligatoire	Valeurs	Description
prompt	Oui	2500 caractères maximum	Scène, sujet, action, mouvement de caméra ; les répliques entre guillemets peuvent être synchronisées sur les lèvres
duration	Non	Entier de 3 à 15, par défaut 5	Facturation à la seconde, une seconde de plus coûte une seconde de plus
aspect_ratio	Non	16:9 (par défaut) / 9:16 / 1:1	Paysage, portrait, carré
resolution	Non	720p (par défaut) / 1080p	Détermine le prix unitaire par seconde

Il n'y a pas de champ sound, mais la vidéo finale contient de l'audio, impossible à désactiver. Il n'y a pas non plus de 4K, d'image de fin ni d'image de référence ; pour cela, utilisez la version standard Kling 3.0 ou Omni.

curl : faire tourner le premier appel

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo/text-to-video",
    "input": {
      "prompt": "A golden retriever surfing a turquoise wave at sunset, cinematic slow motion, water droplets frozen mid-air",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p"
    }
  }'

La réponse ne contient que data.taskId. Interrogez GET /v1/tasks/{taskId} toutes les 5 à 10 secondes ; une fois que status passe à success, téléchargez la vidéo depuis output[0].url.

Python : soumettre, interroger, télécharger

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

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # 重试同一次提交时复用同一个 Idempotency-Key，只会扣一次费
    r = requests.post(API, json={"model": "kling-3.0-turbo/text-to-video", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(8)
    raise TimeoutError(task_id)

# 竖屏 3 秒 720p 试方向，$0.39
url = generate(
    prompt="A barista pours latte art in slow motion, close-up, warm cafe light",
    duration=3, aspect_ratio="9:16", resolution="720p",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Combien ça coûte

Durée	720p ($0.13/s)	1080p ($0.16/s)
3 secondes (minimum)	$0.39	$0.48
5 secondes	$0.65	$0.80
10 secondes	$1.30	$1.60
15 secondes (maximum)	$1.95	$2.40

Tarifs actuels de HiAPI, vérifiés le 18 octobre 2026.

Aucun frais en cas d'échec. Comparaison complète dans Tarifs de l'API Kling 3.0 Turbo.

Les erreurs que vous rencontrerez

Ce que vous avez envoyé	Réponse
prompt absent	400, missing required field "prompt"
Champ supplémentaire (comme seed, negative_prompt)	400, additional properties ... not allowed
duration: 2	400, duration: minimum: got 2, want 3
duration: 99	400, duration: maximum: got 99, want 15
aspect_ratio: "4:3"	400, seuls 16:9, 9:16, 1:1 sont autorisés
resolution: "480p"	400, seuls 720p, 1080p sont autorisés
Clé incorrecte ou manquante	401, permission_denied
Solde insuffisant	402, rechargez avant de réessayer

Les erreurs de paramètres sont renvoyées immédiatement lors de la soumission ; les échecs de génération sont détectés plus tard lors de l'interrogation avec status à fail, l'erreur se trouve dans data.error. Les deux cas doivent être gérés.

À vérifier avant la mise en production

• Utilisez un callback plutôt que l'interrogation : ajoutez au même niveau que input "callback": {"url": "https://your-app.example.com/hiapi/callback", "when": "final"}, la notification n'est envoyée qu'une fois à la fin de la tâche, dédupliquez par taskId.
• Ajoutez l'en-tête Idempotency-Key : réutilisez la même clé en cas de nouvelle tentative après un timeout, un seul tâche sera créée et un seul débit effectué.
• Téléchargez le résultat immédiatement : output[0].url a une durée de validité.
• Au-delà de 15 secondes, segmentez : passez la dernière image du segment précédent comme première image à kling-3.0-turbo/image-to-video pour continuer la génération.

Questions fréquentes

Combien de temps prend une génération ?

Cela se compte en minutes, plus la durée est longue et plus la résolution est élevée, plus c'est long. Il est recommandé de fixer la limite d'interrogation à 10–15 minutes, ou d'utiliser directement un callback.

Les prompts négatifs sont-ils pris en charge ?

Non. Écrivez directement dans le prompt ce que vous voulez éviter, par exemple « no text overlays, no watermarks ».

Comment choisir entre Turbo et la version standard Kling 3.0 ?

Turbo est la version rapide, avec audio intégré ; la version standard sans audio en 720p coûte $0.10 par seconde, moins cher, l'audio est activable ou désactivable, et elle peut produire de la 4K. Comparaison avec le même prompt dans Kling 3.0 Turbo vs Kling 3.0.

Copiez le prompt du fjord ci-dessus et générez un test de 3 secondes pour $0.39.