Ir al contenido
Regístrate gratis
Kling

API de vídeo de Kling: texto, imágenes y control de movimiento

Conecta Kling con tu BetterToken API Key y elige los campos, recursos y métodos de generación según el Model ID y la operación.

Puedes generar vídeos a partir de texto o imágenes, o controlar el movimiento con una imagen de referencia de una persona y un vídeo de movimiento. El nivel de salida de kling-v3 usa provider_options.kling.mode; Omni, Turbo y Motion Control usan sus propios campos de resolución.

Prepara tu BetterToken API Key. La Base URL es https://bettertoken.ai/v1 y la autenticación usa Authorization: Bearer YOUR_API_KEY. Copia el Model ID exactamente, respetando mayúsculas y minúsculas.

Cada request.json de esta página sigue el mismo proceso: solicita un presupuesto, confirma la creación, consulta el estado y descarga. El presupuesto no inicia la generación; la creación envía una tarea de pago. Consulta los precios actuales en el model plaza.

Modelos y operaciones

La tabla enumera las opciones de cada operación. Consulta los valores predeterminados, las cantidades de recursos y las restricciones de combinación en cada sección. Los tamaños usan 1 MB = 1048576 bytes.

Model IDOperaciónDuración (segundos)Nivel de salidaRelación de aspectoAudioRoles de recursos
kling-3.0-turbotext_to_video5–10, incremento 5720p, 1080p16:9, 9:16, 1:1onNinguno
kling-v3-motion-controlreference_to_videoSigue el vídeo de referencia de 3–10 s720p, 1080pNo enviaroff, onreference_image, reference_video
kling-v3-omnitext_to_video3–15, incremento 1720p, 1080p, 4k16:9, 9:16, 1:1off, onNinguno
kling-v3image_to_video3–15, incremento 1std, pro, 4kNo enviaroff, onfirst_frame, last_frame
kling-v3text_to_video3–15, incremento 1std, pro, 4k16:9, 9:16, 1:1off, onNinguno

kling-v3 no acepta output.resolution; en imagen a vídeo tampoco acepta output.aspect_ratio. kling-v3-motion-control no acepta provider_options. Turbo solo genera vídeos de 5 o 10 segundos, con el audio fijado en on.

Recursos de ejemplo

Los ejemplos de generación desde imágenes y referencias usan una taza de cerámica azul sobre una mesa blanca. Puedes probar la imagen de ejemplo o sustituirla primero por recursos HTTPS públicos que tengas derecho a usar y que cumplan los límites de esta página.

Imagen de referencia para generar vídeo: taza de cerámica azul sobre una mesa blanca

El ejemplo de control de movimiento usa una imagen de referencia de un niño y un vídeo de movimiento del mismo niño. El prompt corresponde a estos recursos. El vídeo dura unos 5.04 segundos, a 1280 × 720 y 24 fps.

De texto a vídeo

kling-3.0-turbo

Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.

Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoonon
duration.modestringNofixedfixed
duration.secondsintegerNo5–10, incremento 5 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 9:16, 1:116:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.

Ejemplo de solicitud

Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.

{
"model": "kling-3.0-turbo",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Errores 422 frecuentes

Código de error 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.

kling-v3-omni

Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.

Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNooff, onoff
duration.modestringNofixedfixed
duration.secondsintegerNo3–15, incremento 1 s; solo con duración fija3
output.aspect_ratiostringNo16:9, 9:16, 1:116:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p, 4k720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con output.resolution="4k", debes establecer audio.mode="off".

Ejemplo de solicitud

Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.

{
"model": "kling-v3-omni",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Errores 422 frecuentes

Código de error 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.

kling-v3

Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.

Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNooff, onoff
duration.modestringNofixedfixed
duration.secondsintegerNo3–15, incremento 1 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 9:16, 1:116:9
output.formatstringNomp4mp4
promptstringNoCadenaNinguno
provider_options.kling.camera_axisstringNohorizontal, vertical, pan, tilt, roll, zoomNinguno
provider_options.kling.camera_typestringNosimple, down_back, forward_up, right_turn_forward, left_turn_forwardNinguno
provider_options.kling.camera_valueintegerNo-10–10, incremento 1, no puede ser 0Ninguno
provider_options.kling.modestringNostd, pro, 4kstd
provider_options.kling.negative_promptstringNoCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.

Ejemplo de solicitud

Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.

{
"model": "kling-v3",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"aspect_ratio": "16:9"
},
"provider_options": {
"kling": {
"mode": "std"
}
}
}

Errores 422 frecuentes

Código de error 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.

De imagen a vídeo

kling-v3

Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.

Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNooff, onoff
duration.modestringNofixedfixed
duration.secondsintegerNo3–15, incremento 1 s; solo con duración fija5
output.formatstringNomp4mp4
promptstringNoCadenaNinguno
provider_options.kling.camera_axisstringNohorizontal, vertical, pan, tilt, roll, zoomNinguno
provider_options.kling.camera_typestringNosimple, down_back, forward_up, right_turn_forward, left_turn_forwardNinguno
provider_options.kling.camera_valueintegerNo-10–10, incremento 1, no puede ser 0Ninguno
provider_options.kling.modestringNostd, pro, 4kstd
provider_options.kling.negative_promptstringNoCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, opcional, máximo 1jpg, jpeg, pngTamaño máximo: 10 MB; ancho: 300–100000 px; alto: 300–100000 px
last_frameimage, opcional, máximo 1jpg, jpeg, pngTamaño máximo: 10 MB; ancho: 300–100000 px; alto: 300–100000 px

Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Proporciona al menos uno de estos roles: first_frame, last_frame.
  • Si envías un fotograma final last_frame, no establezcas provider_options.kling.camera_type.

Ejemplo de solicitud

Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.

{
"model": "kling-v3",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"provider_options": {
"kling": {
"mode": "std"
}
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Errores 422 frecuentes

Código de error 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto.

Generación con referencias

kling-v3-motion-control

Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.

Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNooff, onoff
duration.modestringNoautoauto
duration.secondsintegerNoNo enviar; la duración sigue el vídeo de referencia de 3–10 sNinguno
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, 1 (obligatorio)jpg, jpeg, pngTamaño máximo: 10 MB; ancho: 300–16384 px; alto: 300–16384 px
reference_videovideo, 1 (obligatorio)mp4, movTamaño máximo: 100 MB; duración: 3–10 s; duración total máxima de este rol: 10 s

Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.

Restricciones de combinación

  • Usa duración automática; la duración de salida sigue la del vídeo de referencia. No indiques duration.seconds.

Debes proporcionar exactamente una reference_image y un reference_video. No establezcas la relación de aspecto ni provider_options adicionales.

Ejemplo de solicitud

Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.

{
"model": "kling-v3-motion-control",
"operation": "reference_to_video",
"prompt": "Animate the boy in the reference image following the motion in the reference video. Preserve his appearance.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "person",
"type": "image",
"role": "reference_image",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0-poster.jpg"
},
{
"id": "motion",
"type": "video",
"role": "reference_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

Errores 422 frecuentes

Código de error 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto.

Documentación oficial

Al llamar a BetterToken, usa los campos de esta página y la operación correspondiente del catálogo de modelos en tiempo real.