Que fait Extension de vidéo Kling AI ?
Aperçu
Étendez une vidéo existante en ajoutant des secondes supplémentaires. Le point d’extension prend le task_id d’une vidéo terminée et génère une continuation fluide.
Point d’accès : POST https://api.klingai.com/v1/videos/video-extend
Paramètres de requête
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
task_id | string | Oui | Identifiant de tâche de la vidéo source terminée |
prompt | string | Non | Description du mouvement/scène pour l’extension |
duration | string | Non | Durée de l’extension : "5" (par défaut) |
mode | string | Non | "standard" ou "professional" |
model_name | string | Non | Par défaut : "kling-v2-master" |
callback_url | string | Non | Webhook pour la fin de traitement |
Extension de base
import jwt, time, os, requests
BASE = "https://api.klingai.com/v1"
def get_headers():
ak, sk = os.environ["KLING_ACCESS_KEY"], os.environ["KLING_SECRET_KEY"]
token = jwt.encode(
{"iss": ak, "exp": int(time.time()) + 1800, "nbf": int(time.time()) - 5},
sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"}
)
return {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
# Étape 1 : Générer la vidéo initiale de 5s
initial = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Une fusée décolle depuis un paysage désertique, cinématographique",
"duration": "5",
"mode": "standard",
}).json()
initial_task_id = initial["data"]["task_id"]
# Attendre la fin...
# (interroger jusqu'à ce que task_status == "succeed")
# Étape 2 : Étendre de 5 secondes supplémentaires
extension = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": initial_task_id,
"prompt": "La fusée monte à travers les nuages dans la stratosphère",
"duration": "5",
"mode": "standard",
}).json()
ext_task_id = extension["data"]["task_id"]
# Étape 3 : Interroger la tâche d'extension
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/video-extend/{ext_task_id}", headers=get_headers()
).json()
if result["data"]["task_status"] == "succeed":
extended_url = result["data"]["task_result"]["videos"][0]["url"]
print(f"Vidéo étendue : {extended_url}")
break
elif result["data"]["task_status"] == "failed":
print(f"Échec : {result['data']['task_status_msg']}")
break
Enchaîner plusieurs extensions
def chain_extensions(initial_task_id: str, prompts: list[str],
duration: str = "5", mode: str = "standard") -> list[str]:
"""Enchaîne plusieurs extensions pour construire une vidéo plus longue."""
current_task_id = initial_task_id
video_urls = []
for i, prompt in enumerate(prompts):
print(f"Extension {i + 1}/{len(prompts)} : soumission...")
# Soumettre l'extension
r = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": current_task_id,
"prompt": prompt,
"duration": duration,
"mode": mode,
}).json()
ext_task_id = r["data"]["task_id"]
# Interroger jusqu'à la fin
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/video-extend/{ext_task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
url = result["data"]["task_result"]["videos"][0]["url"]
video_urls.append(url)
current_task_id = ext_task_id # l'extension suivante s'enchaîne sur celle-ci
print(f"Extension {i + 1} terminée : {url}")
break
elif status == "failed":
raise RuntimeError(f"Extension {i + 1} échouée : {result['data']['task_status_msg']}")
return video_urls
Utilisation : Construire une vidéo de 20 secondes
# Générer les 5s initiales
initial_r = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Lever de soleil matinal sur un lac de montagne, brume montante",
"duration": "5",
"mode": "standard",
}).json()
initial_id = initial_r["data"]["task_id"]
# ... interroger jusqu'à complet ...
# Enchaîner 3 extensions supplémentaires = 5 + 5 + 5 + 5 = 20 secondes au total
extensions = chain_extensions(initial_id, [
"Le soleil monte, des oiseaux commencent à voler au-dessus du lac",
"Un cerf s'approche du bord de l'eau pour boire",
"Plan large qui s'éloigne pour révéler toute la chaîne montagneuse",
])
Coût
Chaque extension coûte le même prix qu’une nouvelle génération :
| Durée d’extension | Standard | Professionnel |
|---|---|---|
| 5 secondes | 10 crédits | 35 crédits |
Une vidéo de 20 secondes (initiale + 3 extensions) coûte 40 crédits en mode standard.
Gestion des erreurs
| Erreur | Cause | Correction |
|---|---|---|
task_id invalide | La tâche source n’existe pas | Vérifier que task_id provient d’une génération terminée |
| Source non terminée | Extension d’une tâche encore en cours | Attendre que la tâche source atteigne le statut succeed |
| Échec d’extension | Conflit de prompt avec la source | Aligner le prompt d’extension avec la scène originale |
Prérequis
- Une source terminée, aux droits libres ou synthétique, une note d’extension approuvée, un espace de travail autorisé et un budget de crédits, une revue de politique, une destination provisoire uniquement, et un responsable de retour/retrait.
Instructions
- Confirmer la propriété de la source, l’état de fin et la note de continuité approuvée avant de créer une extension ; ne pas utiliser de matériel privé, non licencié ou restreint par la politique.
- Soumettre un seul canary filigrané dans la durée et le plafond de crédits approuvés, puis vérifier la politique, les droits, la qualité et les contrôles de destination.
- Arrêter en cas de dérive de continuité, de politique, de droits ou de budget et supprimer la tâche d’extension au lieu de la publier.
- Promouvoir uniquement après approbation du propriétaire ; conserver un reçu rédigé et supprimer les actifs temporaires à la limite de conservation convenue.
Production
Produire un reçu d’extension avec la référence de la tâche source, la classification des droits, le mode/durée, l’estimation des crédits, la revue de politique, la destination provisoire, l’approbateur, la référence de conservation/suppression et l’identifiant de tâche. Exclure les prompts, les identités et les URL des actifs.
Exemples
source=synthetic-task-42 ; rights=cleared ; duration=5s ; mode=standard ; policy=pass ; destination=draft-only ; cleanup=24h est sûr pour la révision.