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 ID | Operación | Duración (segundos) | Nivel de salida | Relación de aspecto | Audio | Roles de recursos |
|---|---|---|---|---|---|---|
kling-3.0-turbo | text_to_video | 5–10, incremento 5 | 720p, 1080p | 16:9, 9:16, 1:1 | on | Ninguno |
kling-v3-motion-control | reference_to_video | Sigue el vídeo de referencia de 3–10 s | 720p, 1080p | No enviar | off, on | reference_image, reference_video |
kling-v3-omni | text_to_video | 3–15, incremento 1 | 720p, 1080p, 4k | 16:9, 9:16, 1:1 | off, on | Ninguno |
kling-v3 | image_to_video | 3–15, incremento 1 | std, pro, 4k | No enviar | off, on | first_frame, last_frame |
kling-v3 | text_to_video | 3–15, incremento 1 | std, pro, 4k | 16:9, 9:16, 1:1 | off, on | Ninguno |
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.

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.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on | on |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 5–10, incremento 5 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplí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 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa 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.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | off, on | off |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 3–15, incremento 1 s; solo con duración fija | 3 |
output.aspect_ratio | string | No | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p, 4k | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
output.resolution="4k", debes estableceraudio.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 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa 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.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | off, on | off |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 3–15, incremento 1 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | No | mp4 | mp4 |
prompt | string | No | Cadena | Ninguno |
provider_options.kling.camera_axis | string | No | horizontal, vertical, pan, tilt, roll, zoom | Ninguno |
provider_options.kling.camera_type | string | No | simple, down_back, forward_up, right_turn_forward, left_turn_forward | Ninguno |
provider_options.kling.camera_value | integer | No | -10–10, incremento 1, no puede ser 0 | Ninguno |
provider_options.kling.mode | string | No | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | No | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplí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 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa 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.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | off, on | off |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 3–15, incremento 1 s; solo con duración fija | 5 |
output.format | string | No | mp4 | mp4 |
prompt | string | No | Cadena | Ninguno |
provider_options.kling.camera_axis | string | No | horizontal, vertical, pan, tilt, roll, zoom | Ninguno |
provider_options.kling.camera_type | string | No | simple, down_back, forward_up, right_turn_forward, left_turn_forward | Ninguno |
provider_options.kling.camera_value | integer | No | -10–10, incremento 1, no puede ser 0 | Ninguno |
provider_options.kling.mode | string | No | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | No | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, opcional, máximo 1 | jpg, jpeg, png | Tamaño máximo: 10 MB; ancho: 300–100000 px; alto: 300–100000 px |
last_frame | image, opcional, máximo 1 | jpg, jpeg, png | Tamañ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"requiereduration.seconds. Cuando indiquesfixedexplí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 establezcasprovider_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 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba 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.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | off, on | off |
duration.mode | string | No | auto | auto |
duration.seconds | integer | No | No enviar; la duración sigue el vídeo de referencia de 3–10 s | Ninguno |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, 1 (obligatorio) | jpg, jpeg, png | Tamaño máximo: 10 MB; ancho: 300–16384 px; alto: 300–16384 px |
reference_video | video, 1 (obligatorio) | mp4, mov | Tamañ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 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba 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.

