Kling AI: Generación oficial de imágenes/videos, control de elementos y movimientos
Idioma y estilo de respuesta
- Explicaciones orientadas al usuario, confirmaciones y mensajes de error: seguir el idioma del usuario (usuarios chinos responden en chino, usuarios ingleses en inglés).
- Los nombres de campos técnicos (
generationId,status,works[].url, etc.) se mantienen en inglés original. Los campos de respuesta se unifican en camelCase (por ejemplo,generationId/creditsConsumed/urlWithoutWatermark); versiones antiguas del servidor pueden devolver campos snake_case equivalentes (generation_id, etc.), se interpretan como el mismo campo.
Introducción de capacidades
Mensaje de bienvenida fijo (el texto en sí no requiere ejecutar comandos), aplicable en los siguientes escenarios:
- Cuando el usuario acaba de completar la instalación/inicio de sesión de este skill o CLI y confirma que el entorno está listo.
- Cuando el usuario pregunta qué puede hacer Kling / qué capacidades tiene / cómo se usa, etc., en un contexto de consulta de capacidades (sin una tarea de generación específica).
Requisito de presentación (conservar la estructura y los emojis. Las capacidades disponibles de la cuenta actual se muestran más abajo):
- Usuarios chinos: mostrar la versión en chino tal cual.
- Usuarios no chinos: deben traducir, no mostrar la versión china — priorizar la versión en inglés como borrador y traducir al idioma del usuario (usuarios japoneses reciben japonés, hispanohablantes reciben español, etc., las citas de ejemplo también se traducen); para idiomas en los que no se pueda traducir de forma fiable, al menos mostrar la versión en inglés.
- Si el entorno no está listo (CLI no instalado o no ha iniciado sesión), reemplazar la primera línea "可灵已就绪!" o "Kling is ready!" por la guía correspondiente en el idioma del usuario (por ejemplo, "可灵还差一步就绪" / "Kling is one step away") y proporcionar los siguientes pasos de instalación/inicio de sesión después del texto.
Versión en español:
¡Kling está listo!
Esto es lo que puedes hacer con Kling:
📷 Generar imágenes
· Texto a imagen — "Dibújame un gato cyberpunk"
· Imagen a imagen — "Usa esta imagen como referencia y conviértela a acuarela"
🎬 Generar videos
· Texto a video — "Genera un video de 5 segundos de una puesta de sol sobre el mar"
· Imagen a video — "Dale vida a esta imagen"
· Fotogramas clave — "Usa estas dos imágenes como fotogramas de inicio y fin" (depende del modelo)
· Referencia omni — "Mantén el personaje de esta imagen y usa el movimiento de cámara de este video"
🧩 Sujetos reutilizables — crear y gestionar personajes, animales, objetos y otros Elementos
🎭 Control de movimiento — usar un video de movimiento o un movimiento guardado para animar una imagen de sujeto
📤 Subir activos — usar imágenes, videos y audio locales cuando sea compatible
📋 Trabajos y cuenta — consultar el progreso de generación, resultados, membresía y saldo de créditos
También puedes combinar las capacidades del agente y del skill para crear flujos de trabajo más complejos — como hacer un anuncio, un cortometraje o producir un lote de activos.
Capacidades disponibles de la cuenta actual
- Cuando el usuario pregunte "¿Qué puedo hacer ahora?" "¿Qué capacidades hay?", mostrar el mensaje de bienvenida y usar
kling who_am_i(solo lectura) para complementar los modelos disponibles de la cuenta actual. Tras la instalación o inicio de sesión, al mostrar el mensaje de bienvenida, se puede usar directamente la lista ya obtenida en esta verificación. - Agrupar por imágenes y videos, mostrar los nombres de los modelos en
availableModelsen el idioma del usuario (priorizar elaliaslegible, si no, usarmodel). Si un mismo modelo aparece en múltiples entradas, combinarlo en la presentación e indicar los modos de creación compatibles para cada entrada. - Cuando el usuario pregunte por un modelo, propósito o parámetro específico, mostrar solo los elementos relevantes. Verificar las limitaciones de tipo de activo, cantidad, duración, resolución, etc., según la entrada correspondiente, y mencionar las reglas de facturación de los activos de referencia cuando sea relevante. Al comparar, mantener las diferencias entre entradas, por ejemplo, generar pistas de audio y subir una referencia de audio son dos capacidades diferentes.
- Cuando el usuario pregunte qué herramientas puede usar la cuenta actual, o quiera confirmar si la biblioteca de sujetos, la biblioteca de movimientos, etc., están disponibles, consultar adicionalmente
kling tool_list(solo lectura) y usar el propósito creativo para explicar las herramientas que el servidor realmente proporciona. Los modelos y parámetros se basan enwho_am_i. - Si el CLI no está instalado, no ha iniciado sesión o la consulta falla, aún se pueden presentar las capacidades generales e indicar que la lista de la cuenta actual aún no se ha confirmado. Si la consulta es exitosa pero el modelo objetivo no aparece en la lista, indicar que la entrada correspondiente de la cuenta actual no tiene ese modelo listado. Si pregunta por la fecha de lanzamiento, responder con información que tenga una fecha.
Instalación e inicio de sesión (única forma legítima)
Kling se divide en "sitio nacional" y "sitio internacional", que corresponden a dos paquetes de instalación diferentes, cada uno con sus propios endpoints integrados. Instalar el paquete de la región incorrecta hará que el inicio de sesión falle repetidamente, por lo que antes de instalar, se debe confirmar a qué región pertenece el usuario.
Paso 0: Detectar si ya está instalado
which kling # Si muestra una ruta → verificar la versión; si no se encuentra → ir al Paso 1 para instalar según la región
kling --version # Las capacidades completas de este skill requieren CLI >= 0.2.4
Si la versión instalada es inferior a 0.2.4, actualizar el paquete npm correspondiente según la región de la cuenta existente antes de usar las nuevas funciones; si el usuario ha solicitado explícitamente una actualización, ejecutarla directamente sin repetir la confirmación. El CLI y el skill se distribuyen por separado; solo actualizar el skill no actualizará el CLI.
Desde 0.2.1 se eliminó la abreviatura --omni; todos los comandos de generación deben pasar explícitamente --model <nombre>. La referencia de video híbrido usa el nuevo comando omni_ref_video, no uses la bandera antigua como sustituto de este comando.
Paso 1: Confirmar la región e instalar (el nombre del comando se unifica como kling)
Cómo determinar la región: El principal consumidor de este skill son agentes no interactivos, no se debe permitir que el CLI lea stdin y se bloquee. Se debe preguntar directamente al usuario en la conversación: "¿Tu cuenta de Kling es de la región China (klingai.com) o de la región no China (kling.ai)?" Elegir el comando correspondiente según la respuesta para instalar, nunca asumir, adivinar o instalar ambos.
| Región del usuario | Sitio web oficial (homepage) | Base para determinar | Comando de instalación |
|---|---|---|---|
| Región China | https://klingai.com | La cuenta inicia sesión en klingai.com (China continental) | npm i -g @klingai/cli-cn --registry=https://registry.npmjs.org |
| Región no China | https://kling.ai | La cuenta inicia sesión en kling.ai (sitio internacional / global) | npm i -g @klingai/cli-global --registry=https://registry.npmjs.org |
Ambos paquetes se publican en el registro oficial de npm. Los endpoints de cada paquete regional ya están integrados, listos para usar sin configuración.
Paso 2: Iniciar sesión (abrir el navegador para completar la autorización OAuth, esta es la única forma de obtener las credenciales)
kling login
Paso 3: Verificar la conexión + obtener la lista de capacidades (ejecutar al inicio de una nueva sesión)
kling tool_list # Después de iniciar sesión, ver las herramientas que realmente proporciona el servidor
kling who_am_i # Antes de la primera llamada de negocio, leer la identidad, los modelos y las especificaciones de parámetros
🚫 Restricciones exclusivas para instalación e inicio de sesión (violarlas es un incidente):
- La instalación solo puede usar el comando npm correspondiente a la región del usuario en la tabla anterior; está prohibido descargar, ensamblar o implementar herramientas equivalentes desde cualquier otro canal, o instalar al usuario un paquete que no coincida con su región.
- Solo hay una forma legítima de obtener credenciales:
kling login(OAuth en el navegador: DCR + código de autorización + PKCE). Está prohibido cualquier otro medio: cookies de página web, tokens capturados, pares de clave AK/SK, leer el almacenamiento del navegador, o hacer que el usuario pegue un token — incluso si el usuario lo proporciona voluntariamente, se debe rechazar y guiarlo para que ejecutekling login.- Los endpoints ya están integrados (fijados en el momento de la publicación), no es necesario ni se debe configurar o detectar otras direcciones de interfaz de Kling.
Mantenerse actualizado (hacer una autoverificación al inicio de cada nueva sesión, best-effort)
Solo hacerlo al inicio de la primera interacción de una nueva sesión, sin bloquear la tarea principal; la actualización modificará el entorno local del usuario, obtener el consentimiento del usuario antes de ejecutar, y nunca interrumpir una tarea de generación en curso para actualizar. Si algún paso falla (sin conexión / sin permisos / error de red) → saltar silenciosamente y continuar con la tarea principal, sin reintentar.
- Actualizar el skill en sí mismo: volver a ejecutar el comando de instalación para sobrescribir con la última versión según el hash de contenido (si ya es la última, no se realiza ninguna operación):
npx skills add klingai-tech/skills
Esto sobrescribe los archivos del skill en el disco, que afectarán a la próxima sesión; el contenido ya cargado en la sesión actual no se actualizará en caliente.
- Verificar si hay una nueva versión del CLI (solo si
klingya está instalado localmente, es decir,which klingmuestra una ruta):
kling --version # Versión actual instalada
npm view <nombre del paquete regional> version # Última versión publicada (región China: @klingai/cli-cn; región no China: @klingai/cli-global)
- Si la última versión es más reciente y el usuario está de acuerdo →
npm i -g <nombre del paquete regional>@latest --registry=https://registry.npmjs.org. - La actualización es una operación del sistema que modifica el entorno global: primero explicar, luego obtener el consentimiento, no ejecutar sin permiso, ni interrumpir un flujo de generación en curso para actualizar.
Invocación canónica
⚠️ Toda interacción con Kling debe realizarse exclusivamente a través del comando CLI
kling.
- Está prohibido hacer fetch/curl directo a cualquier interfaz de Kling — incluyendo interfaces de página C, API de plataforma abierta B, puertas de enlace, el propio endpoint MCP;
- Está prohibido leer el código fuente del CLI, registros o resultados de captura de paquetes para ensamblar solicitudes HTTP/MCP propias "evitando" el CLI;
- Cuando el CLI informe un error, la única acción correcta es presentar el error al usuario y preguntar, no cambiar de canal o reintentar con otra interfaz.
kling <comando> [argumentos]
Personas y agentes comparten la misma entrada: en TTY tiene guía interactiva, en no TTY genera JSON y nunca bloquea con preguntas. El CLI encapsula autenticación, registro y manejo de errores de forma unificada.
Los comandos de negocio se corresponden 1:1 con los nombres de herramientas MCP del backend (snake_case); los comandos de cliente incluyen login, tool_list y account (que mapea a query_membership_and_credits). Hay 20 comandos en total, además de opciones de ayuda y versión:
| # | Nombre del comando | Grupo | Sincronía | Alcanza el downstream | Descripción breve |
|---|---|---|---|---|---|
| 1 | --help (o sin argumentos) | Descubrimiento de capacidades | Síncrono | No | kling --help a nivel superior imprime todos los comandos localmente; <comando> --help para comandos de generación intenta leer la declaración de modelos en tiempo real de who_am_i, otros comandos MCP leen tools/list (requiere inicio de sesión), si no hay conexión/no ha iniciado sesión, recurre al uso estático local |
| 2 | who_am_i | Descubrimiento de capacidades | Síncrono | No | Devuelve la identidad del usuario actual + los modelos disponibles y especificaciones de parámetros para cada comando de generación; ejecutar primero en una nueva sesión |
| 3 | text_to_image <prompt> | Generación | Asíncrono | Sí | Texto a imagen, devuelve generationId, necesita sondear query_tasks (o añadir --poll para obtener el resultado en un solo paso) |
| 4 | `image_to_image --image <url | ruta> ` | Generación | Asíncrono | Sí |
| 5 | text_to_video <prompt> | Generación | Asíncrono | Sí | Texto a video, devuelve generationId, necesita sondear query_tasks |
| 6 | `image_to_video [--image <url | ruta>] [prompt]` | Generación | Asíncrono | Sí |
| 7 | omni_ref_video <prompt> | Generación | Asíncrono | Sí | Referencia híbrida de imagen, video, audio o Elemento, el tipo se determina según la declaración del modelo, devuelve generationId |
| 8 | query_tasks <generationId> | Consulta de tareas | Síncrono | Sí | Consulta el estado de generación y las URL de los recursos finales (works[].url) por generationId |
| 9 | file_upload <rutaArchivo> | Subida de archivos | Síncrono | Sí | Subida en dos pasos (solicitar un ticket de un solo uso + subir los bytes del archivo), devuelve una URL pública |
| 10 | element_create | Activos de sujeto | Síncrono | Sí | Crea un Elemento reutilizable a partir de un conjunto de imágenes o un video, devuelve el element id |
| 11 | element_list / element_get | Activos de sujeto | Síncrono | Sí | Listar Elementos; obtener el tipo completo y los detalles del recurso por id |
| 12 | element_update / element_delete | Activos de sujeto | Síncrono | Sí | Actualizar por campo o eliminar un Elemento; el CLI conserva automáticamente la imagen principal |
| 13 | motion_library_list | Activos de movimiento | Síncrono | Sí | Listar los movimientos guardados, obtener el motionId y la URL reproducible |
| 14 | motion_control | Generación | Asíncrono | Sí | Genera un video a partir de una imagen de sujeto + un video de movimiento o motionId, devuelve generationId |
| 15 | feedback | Retroalimentación | Síncrono | Sí | Reportar bloqueos, errores confusos, anomalías de facturación o resultados inesperados; no se encarga de reintentos/reembolsos/arreglos |
| 16 | account | Comercialización | Síncrono | Sí | Tipo de membresía + créditos disponibles (query_membership_and_credits, la identidad se obtiene del JWT) |
| 17 | tool_list | Descubrimiento de capacidades | Síncrono | No | Lista las herramientas que el servidor MCP backend expone actualmente (MCP tools/list): name / description / inputSchema de cada herramienta (para depuración / confirmar qué herramientas proporciona realmente el servidor) |
| 18 | login | Autenticación | Síncrono | No (solo servicio OAuth) | Inicio de sesión OAuth en el navegador (DCR + PKCE), el token se escribe en .credentials local |
| 19 | logout | Autenticación | Síncrono | Sí | Llama a MCP logout para invalidar la autorización en el servidor y limpiar el estado de inicio de sesión local, para permitir una nueva autorización o cambiar de cuenta |
Los endpoints ya están integrados: el paquete regional correspondiente se puede usar directamente después de la instalación, sin configuración; no existe ningún punto de configuración externo (sin variables de entorno, sin
.env, sin comando config), ni se debe intentar detectar o especificar otras direcciones de interfaz de Kling.
Sin alias: un comando por nombre; las formas antiguas (
image generate,text2image, etc.) ya no son compatibles, se deben usar los comandos canónicos anteriores.
Ejecutar kling (sin argumentos) o con un subcomando no válido imprimirá la ayuda completa de uso.
Uso recomendado (mejores prácticas, el agente debe seguirlas)
Objetivo: minimizar errores, no desperdiciar créditos y que los parámetros siempre se basen en el servidor.
Primera interacción de una nueva sesión: se puede hacer una autoverificación best-effort según la sección "Mantenerse actualizado" (actualizar skill / ver si hay nueva versión del CLI), sin interrumpir la tarea principal y obteniendo el consentimiento del usuario antes de actualizar.
Tres pasos simples: ① kling login iniciar sesión → ② kling tool_list para ver herramientas, kling who_am_i para ver identidad y especificaciones del modelo → ③ kling <comando> ejecutar (los 6 comandos de generación deben llevar --model explícitamente).
- En nueva sesión, primero
kling who_am_i: obtener de una vez la identidad + los modelos disponibles y especificaciones de parámetros para cada comando de generación (obligatorios / valores por defecto / rangos). Las selecciones de modelo y configuración de parámetros posteriores se basarán en esto. - Cuando no se sepa qué capacidades proporciona el servidor, usar
kling tool_list: lista las herramientas que el servidor MCP backend expone realmente en tiempo real (tools/list). Ideal para depuración o confirmar si una capacidad está disponible, requiere inicio de sesión, no consume créditos. - Para ver cómo pasar argumentos a un comando, usar
kling <comando> --help: para comandos de generación, intenta leer los parámetros del modelo y los slots de entrada en tiempo real dewho_am_i; para otros comandos MCP, leetools/list(descripción de la herramienta + inputSchema); si no hay conexión / no ha iniciado sesión, recurre al uso estático local. La lista completa de modelos y parámetros sigue basándose enwho_am_i. - La generación debe seleccionar el modelo explícitamente:
text_to_image/image_to_image/text_to_video/image_to_video/omni_ref_video/motion_controldeben llevar--model <nombre>(tomado de la listawho_am_ide la herramienta correspondiente). El CLI no seleccionará un modelo por defecto por el usuario;motion_controlen un TTY real, si falta el modelo, mostrará modelos candidatos para que el usuario elija; en entornos no interactivos como agentes / pipelines / CI, mostrará un error antes de cobrar. - Pasar los activos directamente como ruta local o URL pública: pasar imágenes, videos o audio según la ayuda del comando seleccionado; el CLI sube automáticamente los archivos locales con
file_upload, no es necesario subirlos manualmente; las URL públicas (CDN externo / enlaces externos, oworks[].urldevueltos por tareas anteriores de Kling) se pasan directamente al servidor, no es necesario descargarlas, volver a subirlas o validarlas localmente. Las limitaciones de formato/tamaño de los activos se basan en la declaración en tiempo real de la herramienta (kling <comando> --help/kling tool_list). - Después de enviar, informar inmediatamente y luego sondear: tomar
generationIdycreditsConsumedde la respuesta para informar al usuario; luego sondear conkling query_tasks <generationId>, o añadir--poll [N]al enviar para obtener el resultado en un solo paso (--pollsin valor por defecto 60s,--poll 0desactiva el sondeo en línea). - El resultado está en
works[]: extraer el enlace del recurso original y entregarlo según "Presentación de resultados". Si el video tiene una vista previa independiente, priorizar la reproducción de la vista previa. - Saldo / membresía, usar
account: cuando el saldo sea insuficiente, mostrar el enlace de recarga que devuelve dinámicamente el servidor (no codificarlo). - Ante un fallo, no cambiar parámetros automáticamente y reenviar: para errores de parámetros, primero comparar con
who_am_iy decirle al usuario la forma correcta, y reintentar solo después de la confirmación; no modificar silenciosamente el prompt / cambiar el modelo / añadir o eliminar imágenes y reenviar por cuenta propia.
Orden típico: después de iniciar sesión, tool_list → who_am_i → (según sea necesario <comando> --help) → text_to_* / image_to_* / omni_ref_video / motion_control con --model para enviar → query_tasks para sondear → mostrar works[].url.
Modelos y parámetros: basarse en who_am_i (mentalidad central)
- La lista de modelos y las especificaciones de parámetros están completamente configuradas por el servidor:
who_am_idevuelveavailableModels(nombre de la herramienta → modelo → especificaciones de arguments/inputs, incluyendo obligatoriedad, valores por defecto y rangos). - La ayuda de un solo comando priorizará la lectura de la declaración en tiempo real: para comandos respaldados por MCP como
who_am_i/ generación / consulta / subida / cuenta,kling <comando> --helppara comandos de generación intenta leer los parámetros del modelo y los slots de entrada en tiempo real dewho_am_i; otros comandos MCP leentools/list(descripción de la herramienta + inputSchema); si no hay conexión o no ha iniciado sesión, recurre al uso estático local. La lista completa de modelos y especificaciones de parámetros sigue basándose enwho_am_i. - Los 6 comandos de generación deben pasar explícitamente
--model <nombre>. Cuando el usuario especifica un modelo, elegir el comando según la intención creativa, localizar el modelo por nombre o alias (alias) en la listawho_am_ide ese comando, y pasar el valor demodeldevuelto. Si no se puede hacer una coincidencia única, o el modelo no admite la entrada o los parámetros necesarios, explicarlo al usuario y confirmar antes de enviar; no cambiar de modelo por cuenta propia. - Por defecto, para imágenes, elegir Kling Image 4.0: cuando el usuario no especifica un modelo, en la lista en tiempo real de
text_to_imageoimage_to_image, seleccionar preferentemente Kling Image 4.0 que cumpla con los requisitos de esta tarea, y pasar explícitamente el valor demodelde esa entrada. Si ese modelo no está disponible o no cumple con los parámetros o activos necesarios, seleccionar un modelo de la lista del comando correspondiente que admita los requisitos de esta tarea. - Las banderas convenientes del CLI (
--imgResolution,--aspectRatio,--imageCount,--duration, etc.) se asignan a nombres de parámetros del protocolo y se pasan directamente; los parámetros no proporcionados son rellenados por el servidor con valores por defecto. Simotion_controlcarece de parámetros obligatorios que no tienen valor por defecto según la declaración del servidor, en un TTY real, guiará al usuario para seleccionar/ingresar según el rango antes de la subida; en entornos no interactivos, listará todos los elementos faltantes de una vez y saldrá, sin subir ni enviar. - Mapear la entrada según la declaración: primero usar la ayuda del comando para confirmar la sintaxis del CLI, luego verificar el tipo de recurso, el nombre del slot y la obligatoriedad según
inputsyargumentsdewho_am_i; no asumir que todas las entradas de imagen a imagen deben tener un primer fotograma, o que todos los comandos de generación permiten omitir el prompt. Al usar entradas con nombre, no ocupar los slots repetidamente; si se pueden mezclar con banderas convenientes, depende de la ayuda de ese comando. Los mapeos y ejemplos de cada comando se encuentran en api-examples.md. - De los seis comandos de generación,
--pollpuede omitir el valor de la opción. Otras opciones de generación necesitan pasar el valor explícitamente, y las opciones de activos deben coincidir con el comando. El CLI verifica las opciones y los activos obligatorios antes de la subida. - Configurar parámetros según la declaración y verificar las restricciones de combinación: según la intención creativa, elegir la entrada, luego verificar los parámetros, valores por defecto, combinaciones disponibles y compatibilidad de entrada del modelo seleccionado según el
who_am_ide la cuenta actual y la descripción de la herramienta. Las especificaciones solicitadas explícitamente por el usuario deben pasarse como argumentos correspondientes. Si la entrada o el modelo actual no pueden cumplir con los requisitos, explicar las limitaciones y esperar a que el usuario confirme las especificaciones disponibles antes de enviar. - Generación de imágenes: según los
argumentsdel modelo seleccionado, verificar la resolución, el número de imágenes generadas y el modo de generación; según losinputs, verificar la cantidad de imágenes de referencia y los slots. Cuando el usuario quiera un conjunto de imágenes coherente, configurar el modo de conjunto y el número de imágenes según la declaración, y explicar el contenido de cada imagen y el sujeto/estilo común en el prompt. - Además de los límites por tipo de entrada, también puede haber un límite total de
combinedItemCap(a través de slots de entrada y parámetros de array comoelements).image_to_video/omni_ref_videoverificarán los slots relevantes, las entradas obligatorias y la cantidad total antes de la subida; no sumar los límites de cada tipo como si fuera la cantidad total permitida. Los campos se encuentran en reference.md. - La validación de parámetros (obligatorios, rangos, parámetros no declarados) la realiza el servidor antes de cobrar, y el mensaje de error listará los elementos problemáticos; ante errores de parámetros, se debe traducir la información del servidor al usuario.
Enrutamiento de intenciones (tabla de decisiones obligatoria)
| Intención del usuario | Comando | Descripción |
|---|---|---|
| Preguntar qué puede hacer Kling / qué capacidades tiene (sin tarea específica) | who_am_i | Mostrar las capacidades generales y los modelos disponibles de la cuenta actual, ver la sección "Introducción de capacidades" arriba |
| Consultar modelos disponibles / si un modelo específico está disponible / especificaciones de parámetros | who_am_i | Mostrar directamente las capacidades y limitaciones relevantes a la pregunta |
| Consultar herramientas abiertas de la cuenta / si la biblioteca de sujetos o de movimientos está disponible | tool_list | Explicar el propósito de la herramienta según lo que realmente devuelve el servidor |
| Generar imágenes / sacar imágenes / texto a imagen | text_to_image | Después de enviar, sondear query_tasks |
| Imagen a imagen / con imagen de referencia | image_to_image | --image se puede repetir, después de enviar, sondear |
| Generar videos / texto a video | text_to_video | Después de enviar, sondear |
| Imagen a video / animar una imagen / fotogramas clave de inicio, medio y fin | image_to_video | Pasar --image / --tailImage o --input con nombre según la declaración del modelo; la opcionalidad del prompt depende de la declaración del modelo, después de enviar, sondear |
| Generar video con referencia híbrida de imagen, video, audio y sujeto | omni_ref_video | Pasar --image / --video / --audio / --elements según la declaración del modelo; el prompt es obligatorio, después de enviar, sondear |
| Crear / listar / ver / actualizar / eliminar sujetos reutilizables | element_create / element_list / element_get / element_update / element_delete | Actualizar solo los campos modificados; eliminar requiere confirmación explícita del usuario |
| Control de movimiento / transferencia de movimiento | motion_control | Sujeto --image + --video o --motionId (elegir uno); después de enviar, sondear |
| Ver movimientos guardados | motion_library_list | Después de obtener el motionId, se puede pasar a motion_control |
| Reportar bloqueos, errores confusos, anomalías de facturación, resultados inesperados | feedback | Solo retroalimentación, no reintentará, reembolsará ni arreglará la tarea original |
| Especificar un modelo o serie concreta | Elegir el comando según la intención creativa, luego pasar --model completo | Analizar el nombre o alias usando la lista de modelos en tiempo real del comando correspondiente |
| Subir activos locales | file_upload | Solo los archivos locales necesitan subirse (devuelve una URL pública); los activos que ya son una URL pública no necesitan subirse, se pasan directamente como --image al comando de generación |
| Consultar membresía / identidad de la cuenta / consultar saldo | account | Devuelve userId + membership + créditos disponibles (mostrar directamente) |
| Consultar o seleccionar espacio de trabajo personal / de equipo | who_am_i → tool_list | Verificar capacidades en tiempo real. Solo cuando se pueda confirmar el espacio de trabajo necesario y la atribución de facturación, enviar la generación. |
| Recargar / saldo insuficiente / abrir membresía | account | Mostrar el enlace de recarga/membresía devuelto por el servidor (tomado dinámicamente del MCP, no codificado, ver "Saldo insuficiente y recarga") |
| Cerrar sesión / salir de la cuenta actual | logout | Después de que el MCP confirme el cierre de sesión, limpiar el estado de inicio de sesión local; terminar al finalizar, no volver a iniciar sesión automáticamente |
| Cambiar de cuenta / iniciar sesión con otra cuenta | logout → login → who_am_i | Se debe ejecutar en orden; si logout o login fallan en cualquier paso, detenerse inmediatamente; después de completar la nueva autorización, verificar la cuenta |
| Solo decir "genera con Kling" u otra intención vaga | — | Primero preguntar si es imagen o video, luego enviar |
Si la intención del usuario no es clara, primero confirmar y luego enviar, no asumir.
Cerrar sesión y cambiar de cuenta
- Solo cerrar sesión: cuando el usuario solicite explícitamente salir de la cuenta actual, ejecutar
kling logout. Terminar después de que tenga éxito; no activar automáticamente una nueva autorización en el navegador. - Cambiar de cuenta: se debe ejecutar en orden:
kling logout→kling login→kling who_am_i. Solo después de quelogouttenga éxito se puede continuar conlogin; durante la autorización en el navegador, el usuario selecciona la cuenta de destino; después de iniciar sesión con éxito, usarwho_am_ipara mostrar y confirmar la identidad actual. - Si
logoutfalla, se debe detener inmediatamente: conservar el estado de inicio de sesión local para poder reintentar, e informar al usuario del error original; no saltar el fallo e ir directamente alogin. - Si
loginfalla, se debe detener inmediatamente: informar del error de inicio de sesión, no continuar conwho_am_i, ni usar cookies, pegar tokens, captura de paquetes u otros métodos de autorización. - No usar
logincomo sustituto del flujo de cambio:loginsolo se encarga de la autorización OAuth local; su ejecución por separado no garantiza que la autorización anterior en el servidor se haya invalidado. Cuando el usuario diga explícitamente "cambiar de cuenta", primero se debe ejecutarlogout.
Espacios de trabajo personales y de equipo
Usar who_am_i para confirmar la identidad de inicio de sesión, y usar tool_list para verificar las herramientas y parámetros en tiempo real. El comando account del CLI 0.2.4, al consultar el saldo de la cuenta, rechazará la opción de espacio de trabajo. Solo cuando el servidor declare explícitamente la selección del espacio de trabajo y pueda verificar la atribución de facturación, se podrá enviar una tarea que el usuario solicite que se facture desde un espacio de trabajo específico.
Flujo de trabajo de Element (sujeto) y restricciones de compatibilidad
- Creación: para Element de imagen, usar
--cover+ 1–3--secondary; para Element de video, usar solo--video; estos dos tipos de recursos no se pueden mezclar. Ambos deben incluir al menos una etiqueta--tag; la etiqueta se debe seleccionar de la descripción en tiempo real de la herramientaelement_createde la región actual y pasarla tal cual; tanto en la creación como en la actualización, no traducir las etiquetas según el idioma de la conversación ni codificar el directorio de una región. Se puede pasar un.mp3--voiceopcional. Los archivos locales se suben automáticamente. - Antes de vincular, confirmar el tipo y la compatibilidad: primero
element_listpara encontrar el id, luegoelement_get <id>para ver elresourcecompleto, y al mismo tiempo verificar las restricciones de tipo de sujeto en la descripción en tiempo real de la herramienta y los parámetros del modelo enwho_am_i. El modelo de destino debe declararelements; un sujeto de imagen no debe ser rechazado solo porque el nombre del modelo seakling-image-o1. Si el modelo declaraelements, pero la descripción de la herramienta prohíbe explícitamente ese tipo de sujeto o método de invocación, se debe respetar esa restricción, no se puede asumir compatibilidad solo por la existencia del parámetro; si otros conflictos en la declaración impiden confirmar la compatibilidad, informar al usuario del conflicto específico y pausar el envío de esa vinculación, no usar una tarea de pago para probar. El modelo compatible debe cumplir con la intención del usuario; antes de cambiar de modelo, seguir las reglas de reintento y selección. - Sintaxis de vinculación: en el prompt, marcar el sujeto con
<<<id>>>, y al mismo tiempo, según la declaración dewho_am_i, pasar--elements '[{"id":"<id>","bindName":"<nombre>","type":"<tipo devuelto por element_get>"}]'. No escribir solo el marcador de posición y omitir el paso deelements, ni forzar el paso a herramientas/modelos incompatibles. - Actualizar solo los campos modificados: el usuario no necesita completar manualmente los campos existentes, ni pasar
--cover. En un TTY real, si faltaelementId, primero se mostrará un mensaje para que el usuario lo ingrese.