¿Qué hace Extensión de Video Kling AI?
Resumen
Extiende un video existente agregando segundos adicionales. El endpoint de extensión toma el task_id de un video completado y genera una continuación sin interrupciones.
Endpoint: POST https://api.klingai.com/v1/videos/video-extend
Parámetros de Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
task_id | string | Sí | ID de la tarea del video fuente completado |
prompt | string | No | Descripción de movimiento/escena para la extensión |
duration | string | No | Duración de la extensión: "5" (por defecto) |
mode | string | No | "standard" o "professional" |
model_name | string | No | Por defecto: "kling-v2-master" |
callback_url | string | No | Webhook para finalización |
Extensión Básica
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"}
# Paso 1: Generar el video inicial de 5s
initial = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Un cohete lanzándose desde un paisaje desértico, cinematográfico",
"duration": "5",
"mode": "standard",
}).json()
initial_task_id = initial["data"]["task_id"]
# Esperar a que se complete...
# (poll hasta que task_status == "succeed")
# Paso 2: Extender 5 segundos más
extension = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": initial_task_id,
"prompt": "El cohete asciende a través de nubes hacia la estratósfera",
"duration": "5",
"mode": "standard",
}).json()
ext_task_id = extension["data"]["task_id"]
# Paso 3: Hacer polling de la tarea de extensión
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"Video extendido: {extended_url}")
break
elif result["data"]["task_status"] == "failed":
print(f"Falló: {result['data']['task_status_msg']}")
break
Encadenar Múltiples Extensiones
def chain_extensions(initial_task_id: str, prompts: list[str],
duration: str = "5", mode: str = "standard") -> list[str]:
"""Encadena múltiples extensiones para construir un video más largo."""
current_task_id = initial_task_id
video_urls = []
for i, prompt in enumerate(prompts):
print(f"Extensión {i + 1}/{len(prompts)}: enviando...")
# Enviar extensión
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"]
# Hacer polling hasta que se complete
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 # la siguiente extensión se encadena desde esta
print(f"Extensión {i + 1} completada: {url}")
break
elif status == "failed":
raise RuntimeError(f"Extensión {i + 1} falló: {result['data']['task_status_msg']}")
return video_urls
Uso: Construir un Video de 20 Segundos
# Generar el inicial de 5s
initial_r = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Amanecer sobre un lago de montaña, niebla elevándose",
"duration": "5",
"mode": "standard",
}).json()
initial_id = initial_r["data"]["task_id"]
# ... hacer polling hasta completar ...
# Encadenar 3 extensiones más = 5 + 5 + 5 + 5 = 20 segundos en total
extensions = chain_extensions(initial_id, [
"El sol sube más alto, pájaros comienzan a volar sobre el lago",
"Un ciervo se acerca al borde del agua para beber",
"Plano general alejándose para revelar la cadena montañosa completa",
])
Costo
Cada extensión tiene el mismo costo que una nueva generación:
| Duración de Extensión | Estándar | Profesional |
|---|---|---|
| 5 segundos | 10 créditos | 35 créditos |
Un video de 20 segundos (inicial + 3 extensiones) cuesta 40 créditos en modo estándar.
Manejo de Errores
| Error | Causa | Solución |
|---|---|---|
task_id inválido | La tarea fuente no existe | Verifica que task_id provenga de una generación completada |
| Fuente no completada | Extender una tarea aún en proceso | Espera a que la tarea fuente alcance estado succeed |
| Extensión falló | Conflicto de prompt con la fuente | Alinea el prompt de extensión con la escena original |
Prerrequisitos
- Un borrador fuente completado, con derechos libres o sintético, un resumen de extensión aprobado, un espacio de trabajo autorizado y presupuesto de créditos, revisión de políticas, destino solo para borrador, y un propietario de reversión/eliminación.
Instrucciones
- Confirma la propiedad de la fuente, el estado de finalización y el resumen de continuidad aprobado antes de crear una extensión; no uses material privado, sin licencia o restringido por políticas.
- Envía un borrador canario con marca de agua dentro de la duración y límite de crédito aprobados, luego verifica políticas, derechos, calidad y controles de destino.
- Detente ante desviaciones de continuidad, políticas, derechos o presupuesto y elimina la tarea de extensión en lugar de publicarla.
- Promociona solo después de la aprobación del propietario; conserva un recibo redactado y elimina activos temporales en el límite de retención acordado.
Salida
Produce un recibo de extensión con la referencia de la tarea fuente, clasificación de derechos, modo/duración, estimación de créditos, revisión de políticas, destino del borrador, aprobador, referencia de retención/eliminación e ID de tarea. Excluye prompts, identidades y URLs de activos.
Ejemplos
source=synthetic-task-42; rights=cleared; duration=5s; mode=standard; policy=pass; destination=draft-only; cleanup=24h es seguro para revisión.