Communitygithub.com

kling-cli

Comandos oficiales de Kling AI para generar imágenes/videos, crear elementos reutilizables y controlar movimientos.

¿Qué es kling-cli?

Este skill proporciona acceso completo a la API oficial de Kling AI (可灵 AI) a través de la CLI `kling`, permitiendo a agentes de IA y desarrolladores generar imágenes y videos, gestionar elementos reutilizables (personajes, animales, objetos), controlar movimientos mediante videos de referencia y consultar el estado de las tareas y la cuenta. Soporta tanto el sitio chino (klingai.com) como el internacional (kling.ai), con paquetes npm separados que ya incluyen los endpoints correspondientes. La autenticación se realiza exclusivamente mediante OAuth en el navegador (`kling login`), y todas las interacciones con el backend deben pasar por la CLI, prohibiendo cualquier llamada directa a las APIs. El skill ofrece 20 comandos que cubren desde la generación con modelos específicos (obligatorio usar `--model`) hasta la gestión de elementos, control de movimientos, subida de archivos y consulta de créditos. Para empezar, se recomienda ejecutar `kling who_am_i` para obtener el perfil del usuario y las especificaciones de los modelos disponibles, y luego usar `kling tool_list` para ver las herramientas que el servidor expone en tiempo real.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/klingai-tech/skills/tree/main

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. 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.
  2. 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 availableModels en el idioma del usuario (priorizar el alias legible, si no, usar model). 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 en who_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 usuarioSitio web oficial (homepage)Base para determinarComando de instalación
Región Chinahttps://klingai.comLa cuenta inicia sesión en klingai.com (China continental)npm i -g @klingai/cli-cn --registry=https://registry.npmjs.org
Región no Chinahttps://kling.aiLa 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 ejecute kling 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.

  1. 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.

  1. Verificar si hay una nueva versión del CLI (solo si kling ya está instalado localmente, es decir, which kling muestra 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 comandoGrupoSincroníaAlcanza el downstreamDescripción breve
1--help (o sin argumentos)Descubrimiento de capacidadesSíncronoNokling --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
2who_am_iDescubrimiento de capacidadesSíncronoNoDevuelve 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
3text_to_image <prompt>GeneraciónAsíncronoSí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 <urlruta> `GeneraciónAsíncronoSí
5text_to_video <prompt>GeneraciónAsíncronoSíTexto a video, devuelve generationId, necesita sondear query_tasks
6`image_to_video [--image <urlruta>] [prompt]`GeneraciónAsíncronoSí
7omni_ref_video <prompt>GeneraciónAsíncronoSíReferencia híbrida de imagen, video, audio o Elemento, el tipo se determina según la declaración del modelo, devuelve generationId
8query_tasks <generationId>Consulta de tareasSíncronoSíConsulta el estado de generación y las URL de los recursos finales (works[].url) por generationId
9file_upload <rutaArchivo>Subida de archivosSíncronoSíSubida en dos pasos (solicitar un ticket de un solo uso + subir los bytes del archivo), devuelve una URL pública
10element_createActivos de sujetoSíncronoSíCrea un Elemento reutilizable a partir de un conjunto de imágenes o un video, devuelve el element id
11element_list / element_getActivos de sujetoSíncronoSíListar Elementos; obtener el tipo completo y los detalles del recurso por id
12element_update / element_deleteActivos de sujetoSíncronoSíActualizar por campo o eliminar un Elemento; el CLI conserva automáticamente la imagen principal
13motion_library_listActivos de movimientoSíncronoSíListar los movimientos guardados, obtener el motionId y la URL reproducible
14motion_controlGeneraciónAsíncronoSíGenera un video a partir de una imagen de sujeto + un video de movimiento o motionId, devuelve generationId
15feedbackRetroalimentaciónSíncronoSíReportar bloqueos, errores confusos, anomalías de facturación o resultados inesperados; no se encarga de reintentos/reembolsos/arreglos
16accountComercializaciónSíncronoSíTipo de membresía + créditos disponibles (query_membership_and_credits, la identidad se obtiene del JWT)
17tool_listDescubrimiento de capacidadesSíncronoNoLista 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)
18loginAutenticaciónSíncronoNo (solo servicio OAuth)Inicio de sesión OAuth en el navegador (DCR + PKCE), el token se escribe en .credentials local
19logoutAutenticaciónSíncronoSí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).

  1. 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.
  2. 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.
  3. 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 de who_am_i; para otros comandos MCP, lee tools/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 en who_am_i.
  4. 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_control deben llevar --model <nombre> (tomado de la lista who_am_i de la herramienta correspondiente). El CLI no seleccionará un modelo por defecto por el usuario; motion_control en 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.
  5. 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, o works[].url devueltos 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).
  6. Después de enviar, informar inmediatamente y luego sondear: tomar generationId y creditsConsumed de la respuesta para informar al usuario; luego sondear con kling query_tasks <generationId>, o añadir --poll [N] al enviar para obtener el resultado en un solo paso (--poll sin valor por defecto 60s, --poll 0 desactiva el sondeo en línea).
  7. 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.
  8. Saldo / membresía, usar account: cuando el saldo sea insuficiente, mostrar el enlace de recarga que devuelve dinámicamente el servidor (no codificarlo).
  9. Ante un fallo, no cambiar parámetros automáticamente y reenviar: para errores de parámetros, primero comparar con who_am_i y 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_i devuelve availableModels (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> --help para comandos de generación intenta leer los parámetros del modelo y los slots de entrada en tiempo real de who_am_i; otros comandos MCP leen tools/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 en who_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 lista who_am_i de ese comando, y pasar el valor de model devuelto. 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_image o image_to_image, seleccionar preferentemente Kling Image 4.0 que cumpla con los requisitos de esta tarea, y pasar explícitamente el valor de model de 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. Si motion_control carece 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 inputs y arguments de who_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, --poll puede 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_i de 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 arguments del modelo seleccionado, verificar la resolución, el número de imágenes generadas y el modo de generación; según los inputs, 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 como elements). image_to_video / omni_ref_video verificará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 usuarioComandoDescripción
Preguntar qué puede hacer Kling / qué capacidades tiene (sin tarea específica)who_am_iMostrar 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ámetroswho_am_iMostrar directamente las capacidades y limitaciones relevantes a la pregunta
Consultar herramientas abiertas de la cuenta / si la biblioteca de sujetos o de movimientos está disponibletool_listExplicar el propósito de la herramienta según lo que realmente devuelve el servidor
Generar imágenes / sacar imágenes / texto a imagentext_to_imageDespués de enviar, sondear query_tasks
Imagen a imagen / con imagen de referenciaimage_to_image--image se puede repetir, después de enviar, sondear
Generar videos / texto a videotext_to_videoDespués de enviar, sondear
Imagen a video / animar una imagen / fotogramas clave de inicio, medio y finimage_to_videoPasar --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 sujetoomni_ref_videoPasar --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 reutilizableselement_create / element_list / element_get / element_update / element_deleteActualizar solo los campos modificados; eliminar requiere confirmación explícita del usuario
Control de movimiento / transferencia de movimientomotion_controlSujeto --image + --video o --motionId (elegir uno); después de enviar, sondear
Ver movimientos guardadosmotion_library_listDespués de obtener el motionId, se puede pasar a motion_control
Reportar bloqueos, errores confusos, anomalías de facturación, resultados inesperadosfeedbackSolo retroalimentación, no reintentará, reembolsará ni arreglará la tarea original
Especificar un modelo o serie concretaElegir el comando según la intención creativa, luego pasar --model completoAnalizar el nombre o alias usando la lista de modelos en tiempo real del comando correspondiente
Subir activos localesfile_uploadSolo 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 saldoaccountDevuelve userId + membership + créditos disponibles (mostrar directamente)
Consultar o seleccionar espacio de trabajo personal / de equipowho_am_i → tool_listVerificar 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íaaccountMostrar 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 actuallogoutDespué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 cuentalogout → login → who_am_iSe 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 que logout tenga éxito se puede continuar con login; durante la autorización en el navegador, el usuario selecciona la cuenta de destino; después de iniciar sesión con éxito, usar who_am_i para mostrar y confirmar la identidad actual.
  • Si logout falla, 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 a login.
  • Si login falla, se debe detener inmediatamente: informar del error de inicio de sesión, no continuar con who_am_i, ni usar cookies, pegar tokens, captura de paquetes u otros métodos de autorización.
  • No usar login como sustituto del flujo de cambio: login solo 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 ejecutar logout.

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

  1. 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 herramienta element_create de 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 --voice opcional. Los archivos locales se suben automáticamente.
  2. Antes de vincular, confirmar el tipo y la compatibilidad: primero element_list para encontrar el id, luego element_get <id> para ver el resource completo, 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 en who_am_i. El modelo de destino debe declarar elements; un sujeto de imagen no debe ser rechazado solo porque el nombre del modelo sea kling-image-o1. Si el modelo declara elements, 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.
  3. Sintaxis de vinculación: en el prompt, marcar el sujeto con <<<id>>>, y al mismo tiempo, según la declaración de who_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 de elements, ni forzar el paso a herramientas/modelos incompatibles.
  4. Actualizar solo los campos modificados: el usuario no necesita completar manualmente los campos existentes, ni pasar --cover. En un TTY real, si falta elementId, primero se mostrará un mensaje para que el usuario lo ingrese.

Skills relacionados