Comment utiliser l'API Kling 2.5 Turbo ? Lancez votre première vidéo en 5 minutes

TL;DR

• Kling 2.5 Turbo est la version rapide du modèle vidéo Kling de Kuaishou. Sur HiAPI, il existe deux entrées : texte-vers-vidéo et image-vers-vidéo. Ouvrez la page du modèle pour l'essayer en ligne ; les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.
• Les deux entrées coûtent 0,06 $ par seconde : 0,30 $ pour 5 secondes, 0,60 $ pour 10 secondes.
• Appel : soumettez avec POST /v1/tasks, récupérez le résultat avec taskId, la vidéo finale se trouve dans output[0].url.

Ce que Kling 2.5 Turbo peut faire

• 5 ou 10 secondes, environ 1080p : la résolution suit le format ; en 16:9, la sortie est de 1920×1080, aucun réglage séparé nécessaire.
• Le texte-vers-vidéo inclut le son : chaque vidéo a une piste audio, sans option d'activation/désactivation.
• L'image-vers-vidéo prend en charge l'image de fin : l'image de début fixe le commencement, l'image de fin fixe la fin, le modèle génère le processus intermédiaire.
• L'image-vers-vidéo propose 6 formats : en plus du paysage, du portrait et du carré, il y a aussi 4:3, 3:4 et le 21:9 cinéma large.

Vertical cinematic shot of a ceramic artist in a sunlit studio. Her hands shape a small terracotta bowl on a spinning pottery wheel. The wet clay gradually rises as the wheel turns, a little water glints on the surface. The camera gently tracks upward from the bowl to her focused face. Warm morning light, linen apron, natural movement, one continuous shot, no text or logos.

Générer avec ce prompt → (choisissez 10 secondes, 9:16)

kling-2.5-turbo/text-to-video, 9:16, 1080×1920, 10 secondes, avec piste audio, 0,60 $.

Comment choisir entre les deux entrées

ID du modèle	Entrée	Format	Son	Idéal pour
kling-2.5-turbo/text-to-video	Prompt	16:9, 9:16, 1:1	Piste audio intégrée	Partir de texte sans visuel
kling-2.5-turbo/image-to-video	Image de début obligatoire, image de fin facultative	6 formats ; 3 formats avec image de fin	Sans piste audio	Animer des photos produits, photographies, illustrations

Les deux entrées sont au même prix : 0,06 $ par seconde.

Deux parcours pour démarrer

Essayer dans le navigateur (3 étapes)

1. Ouvrez la page du modèle texte-vers-vidéo ou image-vers-vidéo et connectez-vous.
2. Rédigez le prompt ; pour l'image-vers-vidéo, téléversez d'abord l'image de début, puis l'image de fin si nécessaire.
3. Choisissez 5 secondes et le format, puis cliquez sur Exécuter.

Appeler via l'API (3 étapes)

1. Créez une clé sur la page API Key de la console et placez-la dans la variable d'environnement HIAPI_KEY.
2. Soumettez avec POST https://api.hiapi.ai/v1/tasks ; la réponse renvoie data.taskId.
3. Interrogez avec GET /v1/tasks/{taskId} jusqu'à ce que status soit success, puis téléchargez output[0].url.

curl : votre première vidéo

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.5-turbo/text-to-video",
    "input": {
      "prompt": "Hands pour glossy caramel over a stack of pancakes, steam rises, camera slowly pushes in, warm kitchen light",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 secondes, 16:9, 0,30 $. Pour l'image-vers-vidéo, remplacez model par kling-2.5-turbo/image-to-video et ajoutez "image_urls": ["https://votre-hébergement/image.jpg"].

Python : soumission, interrogation, téléchargement

# 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(model, timeout_s=900, **inp):
    # 重试同一个任务时带同一个 Idempotency-Key，避免重复扣费
    r = requests.post(API, json={"model": model, "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"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 首帧 + 尾帧：红车从左边开到右边，变成蓝车（5 秒，$0.30）
url = generate(
    "kling-2.5-turbo/image-to-video",
    prompt="A toy car moves smoothly from the left to the right and changes from red to blue. "
           "Keep the simple light grey background and beige ground. Continuous static camera shot.",
    image_urls=["https://votre-hébergement/first.png", "https://votre-hébergement/last.png"],
    duration=5, aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Image de début plus image de fin : figer le plan sur l'image voulue

Passez deux images dans image_urls : la première est l'image de début, la seconde est l'image de fin. Dans l'exemple ci-dessous, l'image de début est la voiture rouge à gauche et l'image de fin la voiture bleue à droite :

Image de début	Image de fin

A toy car moves smoothly from the left to the right and changes from red to blue. Keep the simple light grey background and beige ground. Continuous static camera shot.

Générer avec ce prompt → (téléversez l'image de début et l'image de fin, choisissez 5 secondes, 9:16)

kling-2.5-turbo/image-to-video, 9:16, 1080×1920, 5 secondes, image de début + image de fin, 0,30 $.

La voiture avance vers la droite, sa couleur passe du rouge au violet puis au bleu, et elle s'arrête à la position de l'image de fin, le fond reste inchangé du début à la fin. Les deux images doivent être identiques sauf pour l'élément à modifier ; le résultat est alors le plus stable. Avec une image de fin, seuls les formats 16:9, 9:16 ou 1:1 sont disponibles.

Tableau des paramètres

Champ	Obligatoire	Valeurs	Description
prompt	Oui	1–2500 caractères	Décrivez l'action et le plan ; pour l'image-vers-vidéo, inutile de décrire à nouveau l'image
duration	Non	5 (par défaut) / 10	Facturation à la seconde
aspect_ratio	Non	Texte : 16:9 (par défaut) 9:16 1:1 ; image : aussi 4:3 3:4 21:9	Avec une image de fin, uniquement 16:9 9:16 1:1
image_urls	Obligatoire pour l'image-vers-vidéo	1–2 images, jpeg/png/webp, ≤10 Mo chacune	1re image : image de début ; 2e image : image de fin ; le texte-vers-vidéo n'accepte pas ce champ
negative_prompt	Non	Texte ≤2500, image ≤2496 caractères	Ce que vous ne voulez pas voir apparaître
cfg_scale	Non	0–1, par défaut 0.5	Plus la valeur est élevée, plus le résultat suit le prompt

Il n'y a ni resolution, ni seed, ni option de son.

Les erreurs que vous rencontrerez

En cas de paramètre incorrect à la soumission, l'API renvoie directement 400, sans créer de tâche ni débiter de crédit :

• duration: value must be one of 5, 10 : la durée ne peut être que 5 ou 10.
• aspect_ratio: value must be one of '16:9', '9:16', '1:1' : un autre format a été transmis au texte-vers-vidéo, ou l'image-vers-vidéo avec image de fin a choisi 4:3, 3:4 ou 21:9.
• image_urls: maxItems: got 3, want 2 : deux images maximum, image de début plus image de fin.
• image_urls: missing required field "image_urls" : l'image-vers-vidéo n'a pas reçu d'image de début.
• cfg_scale: maximum: got 5, want 1 : cfg_scale va de 0 à 1, et non de 1 à 20 comme dans d'autres modèles.
• additional properties 'seed', 'sound' not allowed : ces deux champs n'existent pas.

À vérifier avant la mise en production

• Utilisez un callback au lieu de l'interrogation répétée : au niveau racine de la requête (au même niveau que input), ajoutez "callback": {"url": "https://votre-domaine/hiapi/callback"}, et dédupliquez par taskId.
• Transférez rapidement : output[0].url expire au bout d'environ 7 jours ; stockez la vidéo dans votre propre stockage dès réception.
• Indiquez explicitement duration et aspect_ratio : sans ces champs, ce sera 5 secondes et 16:9, un besoin en format vertical est vite oublié.
• Utilisez une clé d'idempotence pour les nouvelles tentatives : ajoutez l'en-tête Idempotency-Key ; une même clé ne crée la tâche qu'une seule fois.

Questions fréquentes

Peut-on désactiver le son du texte-vers-vidéo ?

Non, il n'y a pas d'option de son. Si vous ne voulez pas de son, retirez la piste audio au montage, ou utilisez l'image-vers-vidéo, qui n'a pas de piste audio par défaut.

Que se passe-t-il si le ratio de l'image de début diffère du format choisi ?

L'image de début est recadrée au centre selon le format choisi. Si vous choisissez 9:16 pour une image en 16:9, seule une bande verticale centrale est conservée ; placez le sujet au centre pour un meilleur résultat.

Peut-on obtenir de la 4K ?

Non. La sortie est d'environ 1080p selon le format ; le plus large est le 21:9 en 2200×940.

Comment choisir entre Kling 2.5 Turbo et Kling 3.0 Turbo ?

Si 5 ou 10 secondes suffisent et que vous voulez le prix le plus bas, choisissez Kling 2.5 Turbo ; pour une durée réglable seconde par seconde de 3 à 15 secondes, ou pour choisir entre 720p et 1080p, consultez la comparaison entre Kling 2.5 Turbo et 3.0 Turbo.

Pour le détail des prix, voir les tarifs de l'API Kling 2.5 Turbo ; pour plus de cas d'usage, voir le guide complet des prompts Kling 2.5 Turbo. Pour voir un aperçu, copiez le prompt d'argile ci-dessus et allez sur la page du modèle pour générer la première.