¿Qué hace Kling AI Texto a Video?
Descripción general
Genera videos a partir de indicaciones de texto usando el endpoint /v1/videos/text2video. Compatible con modelos v1 hasta v2.6, modos estándar/profesional, control de cámara, indicaciones negativas y audio nativo (v2.6+).
Endpoint: POST https://api.klingai.com/v1/videos/text2video
Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
model_name | string | Sí | Versión del modelo (ver catálogo de modelos) |
prompt | string | Sí | Descripción del video, máximo 2500 caracteres |
negative_prompt | string | No | Qué excluir de la generación |
duration | string | Sí | "5" o "10" segundos |
aspect_ratio | string | No | "16:9" (predeterminado), "9:16", "1:1", etc. |
mode | string | No | "standard" (predeterminado) o "professional" |
cfg_scale | float | No | Adherencia a la indicación (0.0-1.0, predeterminado 0.5) |
camera_control | object | No | Configuración de movimiento de cámara |
callback_url | string | No | URL de webhook para notificación de finalización |
Ejemplo completo — Python
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"}
# Crear tarea de texto a video
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Aerial drone shot of a coral reef at golden hour, "
"tropical fish swimming through crystal clear water, "
"sun rays penetrating the surface, cinematic 4K",
"negative_prompt": "blurry, low quality, distorted, watermark",
"duration": "5",
"aspect_ratio": "16:9",
"mode": "professional",
"cfg_scale": 0.5,
})
task = response.json()
task_id = task["data"]["task_id"]
# Consultar hasta completar
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/text2video/{task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
video = result["data"]["task_result"]["videos"][0]
print(f"Video URL: {video['url']}")
print(f"Duration: {video['duration']}s")
break
elif status == "failed":
raise RuntimeError(result["data"]["task_status_msg"])
# else: submitted/processing — keep polling
Con control de cámara
# Tipos de movimiento de cámara: pan, tilt, zoom, roll
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "A medieval castle on a cliff at sunrise, fog in the valley",
"duration": "5",
"mode": "standard",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 5, # paneo a la derecha (negativo = izquierda), rango -10 a 10
"vertical": 0, # inclinación (negativo = abajo, positivo = arriba)
"zoom": 3, # acercar (positivo) o alejar (negativo)
"roll": 0, # rotación
"pan": 0, # dolly izquierda/derecha
"tilt": -2, # dolly arriba/abajo
}
},
})
Regla: Solo un campo distinto de cero en config para type: "simple".
Con audio nativo (solo v2.6)
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "A jazz band performing in a dimly lit club, saxophone solo, "
"audience clapping, warm amber lighting",
"duration": "10",
"mode": "professional",
"motion_has_audio": True, # genera audio sincronizado
})
Consejos de ingeniería de indicaciones
| Técnica | Ejemplo |
|---|---|
| Escena + acción + estilo | "Un samurái caminando entre cerezos en flor, cámara lenta cinematográfica" |
| Pistas de iluminación | "hora dorada", "iluminado con neón", "luz difusa nublada" |
| Lenguaje de cámara | "primer plano", "plano general de establecimiento", "travelling" |
| Indicación negativa | "borroso, marca de agua, superposición de texto, rostros distorsionados" |
| Material/textura | "acero cepillado", "acuarela pintada a mano", "fotorrealista" |
Referencia de costos
| Duración | Estándar | Profesional |
|---|---|---|
| 5 segundos | 10 créditos | 35 créditos |
| 10 segundos | 20 créditos | 70 créditos |
Manejo de errores
| Error | Causa | Solución |
|---|---|---|
400 indicación no válida | Vacía o >2500 caracteres | Verificar longitud de la indicación |
400 modelo no válido | model_name no compatible | Usar ID de modelo válido del catálogo |
402 créditos insuficientes | No hay suficientes créditos | Recargar cuenta |
task_status: failed | Violación de política de contenido o complejidad | Simplificar indicación, eliminar contenido restringido |
Prerrequisitos
- Un brief aprobado, material de referencia con derechos autorizados o sintético, un espacio de trabajo y presupuesto autorizados, una revisión de la política de contenido y un propietario designado para la publicación y eliminación.
Instrucciones
- Crear un borrador en modo sandbox a partir de un brief aprobado; no incluir personas privadas, material protegido ni afirmaciones no verificadas en las indicaciones o cargas.
- Verificar la duración solicitada, el estilo, el destino, el presupuesto de créditos, el estado de la política de contenido y la opción de solo borrador antes del envío.
- Revisar una representación renderizada con marca de agua para verificar política, derechos y calidad; detenerse ante una preocupación de política o atribución y eliminar el borrador en lugar de publicarlo.
- Promocionar solo después de la aprobación del propietario y conservar un recibo de producción redactado; eliminar los activos temporales en el límite de retención aprobado.
Salida
Producir un recibo de renderización con ID de brief, clasificación de fuente aprobada, modelo/modo, duración, estimación de créditos, resultado de la revisión de política y derechos, destino del borrador, aprobador, referencia de retención/eliminación e ID de tarea. Excluir texto de la indicación, identidades y credenciales.
Ejemplos
brief=synthetic-product-demo; source=rights-cleared; mode=standard; duration=5s; policy=pass; destination=draft-only; approval=pending; cleanup=24h es una solicitud de prueba segura.