Génération officielle d'images/vidéos Kling AI, contrôle des sujets Elements et des mouvements
Langue et style de réponse
- Explications, confirmations et messages d'erreur destinés à l'utilisateur : suivez la langue de l'utilisateur (un utilisateur chinois reçoit une réponse en chinois, un utilisateur anglais en anglais).
- Les noms de champs techniques (
generationId,status,works[].url, etc.) restent en anglais. Les champs de réponse sont unifiés en camelCase (par exemplegenerationId/creditsConsumed/urlWithoutWatermark) ; les anciens serveurs peuvent encore renvoyer des champs synonymes en snake_case (generation_id, etc.), considérez-les comme le même champ.
Présentation des capacités
Message de bienvenue fixe (le texte lui-même n'a pas besoin d'être invoqué), applicable dans les scénarios suivants :
- L'utilisateur vient de terminer l'installation/connexion de cette compétence ou du CLI, et souhaite confirmer que l'environnement est prêt ;
- L'utilisateur pose des questions sur les capacités de Kling (que peut-il faire, comment l'utiliser, etc.), sans tâche de génération spécifique.
Exigences d'affichage (conservez la structure et les émojis. Les capacités disponibles pour le compte actuel sont détaillées ci-dessous) :
- Utilisateur chinois : affichez la version chinoise telle quelle.
- Utilisateur non chinois : vous devez traduire, ne pas afficher la version chinoise — donnez la priorité à la version anglaise comme base de traduction dans la langue de l'utilisateur (un utilisateur japonais reçoit du japonais, un utilisateur hispanophone reçoit de l'espagnol, traduisez également les exemples de citations) ; pour les langues que vous ne pouvez pas traduire de manière fiable, affichez au moins la version anglaise.
- Si l'environnement n'est pas prêt (CLI non installé ou non connecté), remplacez la première ligne « Klin est prêt ! / Kling is ready! » par un message d'orientation dans la langue correspondante (par exemple « Il ne manque plus qu'une étape à Kling » / "Kling is one step away"), et donnez les prochaines étapes d'installation/connexion après le texte.
Version chinoise :
Klin est prêt !
Voici ce que vous pouvez faire avec Kling :
📷 Générer des images
· Texte vers image — "Dessine-moi un chat cyberpunk"
· Image vers image — "Utilise cette image comme référence et transforme-la en aquarelle"
🎬 Générer des vidéos
· Texte vers vidéo — "Génère une vidéo de 5 secondes d'un coucher de soleil sur la mer"
· Image vers vidéo — "Fais bouger cette image"
· Images clés — "Utilise ces deux images comme début et fin" (selon le modèle)
· Référence Omni — "Garde le personnage de cette image et utilise le mouvement de caméra de cette vidéo"
🧩 Sujets réutilisables — créer et gérer des personnages, animaux, objets, etc.
🎭 Contrôle des mouvements — animer une image sujet avec une vidéo de mouvement ou une bibliothèque de mouvements
📤 Télécharger des ressources — utilisez des images, vidéos et audio locaux, le type dépend de l'entrée choisie
📋 Tâches et compte — vérifiez la progression de la génération, les œuvres, l'abonnement et le solde de crédits
Vous pouvez également combiner les capacités de l'agent et de la compétence pour réaliser des workflows créatifs complexes, comme la création d'un spot publicitaire, d'un court-métrage, ou la production en masse de ressources.
Version anglaise (base de traduction pour les utilisateurs non chinois ; les utilisateurs anglais affichent cette version directement) :
Kling is ready!
Here's what you can do with Kling:
📷 Generate images
· Text to image — "Draw me a cyberpunk-style cat"
· Image to image — "Use this image as a reference and restyle it in watercolor"
🎬 Generate videos
· Text to video — "Generate a 5-second video of a sunset over the sea"
· Image to video — "Bring this image to life"
· Keyframes — "Use these two images as the opening and closing frames" (model dependent)
· Omni Reference — "Keep the character from this image and use the camera movement from this video"
🧩 Reusable subjects — create and manage character, animal, prop, and other Elements
🎭 Motion control — drive a subject image with a motion video or saved motion
📤 Upload assets — use local images, videos, and audio where supported
📋 Jobs and account — check generation progress, results, membership, and credit balance
You can also combine agent and skill capabilities to build more complex creative workflows — like making an ad spot, a short story film, or batch-producing a set of assets.
Capacités disponibles pour le compte actuel
- Lorsque l'utilisateur demande « Que puis-je faire maintenant ? » ou « Quelles sont les capacités ? », affichez le message de bienvenue et complétez-le avec
kling who_am_i(en lecture seule) pour indiquer les modèles disponibles pour le compte actuel. Après l'installation ou la connexion, vous pouvez utiliser la liste obtenue lors de cette vérification. - Regroupez par image et vidéo, affichez les noms des modèles dans
availableModelsdans la langue de l'utilisateur (utilisez de préférence l'aliaslisible, sinon le champmodel). Si un même modèle apparaît dans plusieurs entrées, combinez-les et indiquez les méthodes de création prises en charge par chaque entrée. - Si l'utilisateur pose des questions sur un modèle, un usage ou un paramètre spécifique, affichez uniquement les éléments pertinents. Vérifiez les limites de type, de quantité, de durée, de résolution, etc. pour l'entrée correspondante, et mentionnez les règles de facturation des ressources de référence le cas échéant. En cas de comparaison, conservez les différences entre les entrées (par exemple, générer une piste audio et télécharger une référence audio sont deux capacités distinctes).
- Si l'utilisateur demande quels outils sont disponibles pour le compte actuel, ou veut confirmer si la bibliothèque de sujets ou la bibliothèque de mouvements sont ouvertes, consultez séparément
kling tool_list(en lecture seule) et expliquez l'usage de création des outils réellement fournis par le serveur. Les modèles et paramètres sont basés surwho_am_i. - Si le CLI n'est pas installé, non connecté ou si la requête échoue, vous pouvez toujours présenter les capacités générales et préciser que la liste du compte actuel n'a pas encore été confirmée. Si la requête réussit mais que le modèle cible n'est pas listé, indiquez que l'entrée correspondante du compte actuel ne liste pas ce modèle. Si l'utilisateur demande la date de disponibilité, utilisez des informations datées pour répondre.
Installation et connexion (unique méthode légitime)
Kling se divise en « site national » et « site international », avec deux packages d'installation distincts, dont les points de terminaison sont déjà intégrés. Installer le mauvais package pour la région entraînera des échecs de connexion répétés. Vous devez donc d'abord confirmer la région de l'utilisateur avant d'installer.
Étape 0 : Vérifier si le CLI est déjà installé
which kling # S'il affiche un chemin → vérifiez la version ; introuvable → passez à l'étape 1 pour installer selon la région
kling --version # Les capacités complètes de cette compétence nécessitent CLI >= 0.2.4
Si la version installée est inférieure à 0.2.4, mettez à niveau le package npm correspondant en fonction de la région du compte existant avant d'utiliser les nouvelles fonctionnalités ; si l'utilisateur demande explicitement une mise à niveau, exécutez-la directement sans confirmation supplémentaire. Le CLI et la compétence sont distribués séparément ; mettre à jour uniquement la compétence ne mettra pas à jour le CLI.
Depuis la version 0.2.1, le raccourci --omni a été supprimé. Toutes les commandes de génération doivent désormais explicitement passer --model <nom>. La référence mixte à une vidéo utilise la nouvelle commande omni_ref_video ; n'utilisez pas l'ancien flag comme substitut de cette commande.
Étape 1 : Confirmer la région et installer (le nom de la commande est unifié sous kling)
Comment déterminer la région : Le principal consommateur de cette compétence est un agent non interactif, ne bloquez pas le CLI avec une lecture sur stdin. Demandez directement à l'utilisateur dans la conversation : « Votre compte Kling est-il sur la zone Chine (klingai.com) ou la zone hors Chine (kling.ai) ? » Choisissez la commande d'installation correspondant à la réponse, ne faites jamais de supposition par défaut et n'installez pas les deux.
| Région de l'utilisateur | Site officiel (homepage) | Critère de décision | Commande d'installation |
|---|---|---|---|
| Zone Chine | https://klingai.com | Compte connecté sur klingai.com (Chine continentale) | npm i -g @klingai/cli-cn --registry=https://registry.npmjs.org |
| Zone hors Chine | https://kling.ai | Compte connecté sur kling.ai (site international / global) | npm i -g @klingai/cli-global --registry=https://registry.npmjs.org |
Les deux packages sont publiés sur le registre officiel npm. Les points de terminaison de chaque package régional sont intégrés, prêts à l'emploi, sans configuration nécessaire.
Étape 2 : Connexion (ouvrir le navigateur pour finaliser l'autorisation OAuth, c'est la seule façon d'obtenir des informations d'identification)
kling login
Étape 3 : Vérifier la connexion + obtenir la liste des capacités (à faire en premier dans une nouvelle session)
kling tool_list # Après connexion, voir les outils réellement fournis par le serveur
kling who_am_i # Avant le premier appel métier, lire l'identité, les modèles et les spécifications des paramètres
🚫 Contraintes d'exclusivité pour l'installation et la connexion (toute violation est un incident) :
- L'installation ne peut se faire qu'avec la commande npm correspondant à la région dans le tableau ci-dessus ; interdiction de télécharger depuis toute autre source, d'assembler ou d'implémenter soi-même un outil équivalent, et interdiction d'installer un package qui ne correspond pas à la région du compte de l'utilisateur.
- L'obtention des informations d'identification n'a qu'une seule méthode légale :
kling login(OAuth via navigateur : DCR + code d'autorisation + PKCE). Interdiction de toute autre méthode : cookies de page web, tokens capturés, paires de clés AK/SK, lecture du stockage du navigateur, ou demande à l'utilisateur de coller un token. Même si l'utilisateur les fournit activement, vous devez refuser et le guider pour exécuterkling login.- Les points de terminaison sont intégrés (finalisés lors de la publication), il n'est ni nécessaire ni autorisé de configurer ou de détecter d'autres adresses d'interface Kling.
Rester à jour (auto-vérification best-effort lors de la première interaction d'une nouvelle session)
Effectuez cette vérification uniquement lors de la première interaction d'une nouvelle session, sans bloquer la tâche principale ; les mises à jour modifient l'environnement local de l'utilisateur, demandez son consentement avant d'exécuter, et ne mettez jamais à jour en cours de tâche de génération. Si une étape échoue (hors ligne, pas de permission, erreur réseau), ignorez-la silencieusement et poursuivez la tâche principale, sans réessayer.
- Mettre à jour la compétence elle-même : réexécutez la commande d'installation pour remplacer par la version la plus récente selon le hash du contenu (si déjà à jour, aucune action) :
npx skills add klingai-tech/skills
Cela remplace les fichiers de compétence sur le disque, ce qui prendra effet lors de la prochaine session ; le contenu déjà chargé dans la session en cours ne sera pas mis à jour à chaud.
- Vérifier si une nouvelle version du CLI est disponible (uniquement si
klingest installé localement, c'est-à-dire siwhich klingdonne un résultat) :
kling --version # Version actuellement installée
npm view <nom du package régional> version # Dernière version publiée (@klingai/cli-cn pour la Chine ; @klingai/cli-global pour l'international)
- Si la dernière version est plus récente et l'utilisateur est d'accord →
npm i -g <nom du package régional>@latest --registry=https://registry.npmjs.org. - La mise à niveau est une opération système qui modifie l'environnement global : expliquez d'abord, puis demandez le consentement, n'exécutez pas arbitrairement, et n'interrompez pas un flux de génération en cours pour effectuer la mise à niveau.
Interface unique (Canonical Invocation)
⚠️ Toute interaction avec Kling doit se faire exclusivement via la commande CLI
kling.
- Interdiction d'utiliser directement fetch/curl pour les interfaces Kling, y compris les interfaces de page C, l'API de la plateforme ouverte B, les passerelles, ou les points de terminaison MCP eux-mêmes ;
- Interdiction de lire le code source du CLI, les logs ou les résultats de capture réseau pour assembler vos propres requêtes HTTP/MCP afin de "contourner" le CLI ;
- En cas d'erreur du CLI, la seule action correcte est de présenter l'erreur à l'utilisateur et de lui demander quoi faire. Ne changez pas de canal et ne réessayez pas avec une autre interface.
kling <commande> [args]
Humains et agents utilisent la même entrée : en mode TTY, il y a une interaction guidée ; en mode non-TTY, la sortie est en JSON et ne bloque jamais avec des questions. Le CLI encapsule de manière unifiée l'authentification, la journalisation et la gestion des erreurs.
Les commandes métier correspondent 1:1 aux noms d'outils MCP du backend Kling (snake_case) ; les commandes client incluent login, tool_list et account (qui correspond à query_membership_and_credits). Il y a 20 commandes au total, plus les options d'aide et de version :
| # | Nom de la commande | Groupe | Synchronisation | Atteint le backend | Description en une phrase |
|---|---|---|---|---|---|
| 1 | --help (ou sans argument) | Découverte de capacités | Synchrone | Non | kling --help imprime localement toutes les commandes ; <commande> --help pour les commandes de génération essaie de lire la déclaration des modèles en temps réel via who_am_i, et pour les autres commandes MCP lit tools/list (nécessite connexion), en mode hors ligne/non connecté, revient à l'utilisation statique locale |
| 2 | who_am_i | Découverte de capacités | Synchrone | Non | Retourne l'identité de l'utilisateur + les modèles disponibles et les spécifications des paramètres pour chaque commande de génération ; appelez-la en premier dans une nouvelle session |
| 3 | text_to_image <prompt> | Génération | Asynchrone | Oui | Texte vers image, retourne generationId, nécessite d'interroger query_tasks (ou ajouter --poll pour un résultat en une étape) |
| 4 | `image_to_image --image <url | chemin> ` | Génération | Asynchrone | Oui |
| 5 | text_to_video <prompt> | Génération | Asynchrone | Oui | Texte vers vidéo, retourne generationId, nécessite d'interroger query_tasks |
| 6 | `image_to_video [--image <url | chemin>] [prompt]` | Génération | Asynchrone | Oui |
| 7 | omni_ref_video <prompt> | Génération | Asynchrone | Oui | Référence mixte image, vidéo, audio ou Element, le type dépend de la déclaration du modèle, retourne generationId |
| 8 | query_tasks <generationId> | Interrogation de tâches | Synchrone | Oui | Interroge l'état de la génération et les URL des ressources finales (works[].url) selon generationId |
| 9 | file_upload <cheminFichier> | Téléchargement de fichier | Synchrone | Oui | Téléchargement en deux étapes (demande d'un ticket à usage unique + téléchargement des octets du fichier), retourne une URL publique |
| 10 | element_create | Ressource sujet | Synchrone | Oui | Crée un Element réutilisable à partir d'un groupe d'images ou d'une vidéo, retourne un id d'Element |
| 11 | element_list / element_get | Ressource sujet | Synchrone | Oui | Liste les Elements ; obtient le type complet et les détails de la ressource selon l'id |
| 12 | element_update / element_delete | Ressource sujet | Synchrone | Oui | Met à jour par champ ou supprime un Element ; l'image principale est conservée automatiquement par le CLI |
| 13 | motion_library_list | Ressource mouvement | Synchrone | Oui | Liste les mouvements enregistrés, obtient l'motionId et l'URL lisible |
| 14 | motion_control | Génération | Asynchrone | Oui | Utilise une image sujet + une vidéo de mouvement ou un motionId pour générer une vidéo, retourne generationId |
| 15 | feedback | Retour | Synchrone | Oui | Signale un blocage, une erreur floue, une anomalie de facturation ou un résultat inattendu ; ne gère pas les réessais, les remboursements ou les corrections |
| 16 | account | Commercial | Synchrone | Oui | Type d'abonnement + crédits disponibles (query_membership_and_credits, l'identité provient du JWT) |
| 17 | tool_list | Découverte de capacités | Synchrone | Non | Liste les outils actuellement exposés par le serveur MCP backend (MCP tools/list) : name / description / inputSchema de chaque outil (pour le dépannage / confirmer les outils réellement fournis par le serveur) |
| 18 | login | Authentification | Synchrone | Non (service OAuth uniquement) | Connexion OAuth via navigateur (DCR + PKCE), token écrit dans .credentials local |
| 19 | logout | Authentification | Synchrone | Oui | Appelle MCP logout pour révoquer l'autorisation côté serveur et efface l'état de connexion local, afin de permettre une nouvelle autorisation ou un changement de compte |
Points de terminaison intégrés : le package de la région correspondante est prêt à l'emploi après installation, aucune configuration nécessaire ; aucune interface de configuration externe n'existe (pas de variable d'environnement, pas de fichier
.env, pas de commande config), n'essayez pas de détecter ou de spécifier d'autres adresses d'interface Kling.
Pas d'alias : une commande, un nom. Les anciennes formes (
image generate,text2image, etc.) ne sont plus prises en charge ; vous devez utiliser les commandes canoniques ci-dessus.
Exécuter kling (sans argument) ou une sous-commande invalide imprimera l'aide complète.
Recommandations d'utilisation (bonnes pratiques, à suivre pour l'agent)
Objectif : réduire les essais erronés, ne pas gaspiller de crédits, les paramètres doivent toujours être basés sur le serveur.
Première interaction d'une nouvelle session : vous pouvez d'abord effectuer une auto-vérification best-effort selon la section « Rester à jour » (mettre à jour la compétence / voir si une nouvelle version du CLI est disponible), sans interrompre la tâche principale, et en demandant d'abord le consentement de l'utilisateur avant la mise à jour.
Trois étapes les plus simples : ① kling login connexion → ② kling tool_list pour voir les outils, kling who_am_i pour voir l'identité et les spécifications des modèles → ③ kling <commande> exécution (les 6 commandes de génération doivent toutes inclure explicitement --model).
- Dans une nouvelle session, commencez par
kling who_am_i: obtenez en une fois l'identité + les modèles disponibles et les spécifications des paramètres (obligatoires / valeurs par défaut / plages de valeurs). Tout choix de modèle et de paramètre ultérieur doit se baser sur cela. - En cas de doute sur les capacités du serveur, utilisez
kling tool_list: liste les outils réellement exposés par le serveur MCP backend (tools/list). Idéal pour le dépannage ou la confirmation de la disponibilité d'une fonctionnalité, nécessite d'être connecté, ne consomme pas de crédits. - Pour connaître les paramètres d'une commande, utilisez
kling <commande> --help: pour les commandes de génération, essaie de lire les paramètres du modèle et les créneaux d'entrée en temps réel viawho_am_i; pour les autres commandes MCP, littools/list(description de l'outil + inputSchema) ; en mode hors ligne/non connecté, revient à l'utilisation statique locale. Les modèles et paramètres complets restent basés surwho_am_i. - La génération doit explicitement sélectionner un modèle :
text_to_image/image_to_image/text_to_video/image_to_video/omni_ref_video/motion_controldoivent toutes inclure--model <nom>(tiré de la listewho_am_ide l'outil correspondant). Le CLI ne sélectionnera pas automatiquement un modèle par défaut pour l'utilisateur ; en mode TTY réel, si le modèle est manquant pourmotion_control, une liste de modèles candidats est affichée pour que l'utilisateur choisisse ; en environnement non interactif (Agent, pipeline, CI), une erreur est renvoyée avant la facturation. - Transmettez directement le chemin local ou l'URL publique des ressources : selon l'aide de la commande choisie, transmettez les images, vidéos ou audio. Les fichiers locaux sont automatiquement téléchargés par le CLI via
file_upload, pas besoin de le faire manuellement ; les URL publiques (CDN externe / lien externe, ouworks[].urlprovenant de tâches Kling précédentes) sont transmises directement au serveur, sans avoir besoin de les télécharger, de les retélécharger ou de les valider localement. Les limites de format / taille des ressources sont basées sur la déclaration en temps réel de l'outil (kling <commande> --help/kling tool_list). - Après soumission, informez immédiatement, puis interrogez : prenez
generationIdetcreditsConsumeddans la réponse et informez-en d'abord l'utilisateur ; puis interrogez aveckling query_tasks <generationId>, ou ajoutez--poll [N]lors de la soumission pour obtenir le résultat en une étape (--pollseul par défaut 60s,--poll 0désactive l'interrogation en ligne). - Les résultats sont dans
works[]: extrayez les liens originaux et transmettez-les selon la section « Affichage des résultats ». Si une vidéo a un aperçu séparé, privilégiez la lecture de l'aperçu. - Solde / abonnement via
account: si le solde est insuffisant, affichez le lien de recharge renvoyé dynamiquement par le serveur (ne le codez pas en dur). - En cas d'échec, ne modifiez pas automatiquement les paramètres et ne réessayez pas : pour les erreurs de paramètres, consultez d'abord
who_am_iet donnez la syntaxe correcte à l'utilisateur ; ne réessayez qu'après confirmation. Ne modifiez pas silencieusement le prompt, ne changez pas de modèle, n'ajoutez ou ne supprimez pas d'images pour réessayer automatiquement.
Ordre typique : après connexion, tool_list → who_am_i → (selon les besoins <commande> --help) → soumission de text_to_* / image_to_* / omni_ref_video / motion_control avec --model → interrogation query_tasks → affichage de works[].url.
Modèles et paramètres : basés sur who_am_i (principe fondamental)
- La liste des modèles et les spécifications des paramètres sont entièrement configurées par le serveur :
who_am_irenvoieavailableModels(nom de l'outil → modèle → spécifications des arguments/inputs, y compris les valeurs obligatoires, par défaut et plages). - L'aide d'une commande individuelle essaie de lire les déclarations en temps réel : pour les commandes basées sur MCP (
who_am_i, génération, requête, téléchargement, compte, etc.),kling <commande> --helppour les commandes de génération essaie de lire les paramètres du modèle et les créneaux d'entrée en temps réel viawho_am_i; pour les autres commandes MCP, littools/list(description de l'outil + inputSchema) ; en mode hors ligne ou non connecté, revient à l'utilisation statique locale. La liste complète des modèles et les spécifications des paramètres restent basées surwho_am_i. - Les 6 commandes de génération doivent toutes explicitement passer
--model <nom>. Lorsque l'utilisateur spécifie un modèle, choisissez la commande en fonction de l'intention créative, localisez le modèle dans la listewho_am_ide cette commande par son nom ou son alias (alias), et transmettez la valeurmodelrenvoyée. Si la correspondance n'est pas unique, ou si le modèle ne prend pas en charge les entrées ou paramètres requis, expliquez-le à l'utilisateur et confirmez avant de soumettre ; ne changez pas vous-même de modèle. - Par défaut, les images utilisent de préférence Kling Image 4.0 : si l'utilisateur n'a pas spécifié de modèle, sélectionnez en priorité Kling Image 4.0 dans la liste en temps réel de
text_to_imageouimage_to_imagequi répond aux besoins actuels, et transmettez explicitement la valeurmodelde cette entrée. Si ce modèle n'est pas disponible ou ne répond pas aux paramètres ou ressources requis, choisissez un modèle de la liste de la commande correspondante qui prend en charge les besoins actuels. - Les flags de commodité du CLI (
--imgResolution,--aspectRatio,--imageCount,--duration, etc.) sont mappés aux noms de paramètres du protocole et transmis ; les paramètres non fournis sont complétés par les valeurs par défaut du serveur. Pourmotion_control, si des paramètres obligatoires sans valeur par défaut sont manquants selon la déclaration du serveur, en mode TTY réel, une sélection/saisie guidée est proposée avant le téléchargement ; en environnement non interactif, tous les éléments manquants sont listés en une fois et la commande se termine sans téléchargement ni soumission. - Mappez les entrées selon la déclaration : utilisez d'abord l'aide de la commande pour confirmer la syntaxe du CLI, puis vérifiez les types de ressources, les noms de créneaux et l'obligation des entrées selon
inputsetargumentsdewho_am_i; ne supposez pas que toutes les entrées d'image vers quelque chose doivent avoir une première image, ou que toutes les commandes de génération autorisent l'omission du prompt. Lorsque vous utilisez des entrées nommées, ne réservez pas le créneau en double. La possibilité de les mélanger avec les flags de commodité dépend de l'aide de la commande. Les mappages et exemples pour chaque commande se trouvent dans api-examples.md. - Parmi les six commandes de génération,
--pollpeut omettre la valeur de l'option. Les autres options de génération nécessitent une valeur explicite, et les options de ressources doivent correspondre à la commande. Le CLI vérifie les options et les ressources obligatoires avant le téléchargement. - Définissez les paramètres selon la déclaration et vérifiez les limites de combinaison : choisissez l'entrée en fonction de l'intention créative, puis vérifiez les paramètres, valeurs par défaut, combinaisons disponibles et compatibilité des entrées pour le modèle sélectionné en fonction de
who_am_iet de la description de l'outil pour le compte actuel. Les spécifications explicitement demandées par l'utilisateur doivent être transmises explicitement dans les paramètres correspondants. Si l'entrée ou le modèle actuel ne peut pas répondre aux exigences, expliquez les limites et attendez que l'utilisateur confirme les spécifications disponibles avant de soumettre. - Génération d'images : selon les
argumentsdu modèle sélectionné, vérifiez la résolution, le nombre d'images et le mode de génération ; selon lesinputs, vérifiez le nombre et le créneau des images de référence. Si l'utilisateur souhaite une série d'images cohérentes, définissez le mode série et le nombre d'images selon la déclaration, et spécifiez le contenu de chaque image ainsi que le sujet et le style communs dans le prompt. - Outre les limites par type de ressource, il peut y avoir une limite totale
combinedItemCap(à travers les créneaux d'entrée et les paramètres de tableau commeelements).image_to_video/omni_ref_videovalidera les créneaux, entrées obligatoires et quantités totales avant le téléchargement ; n'additionnez pas les limites de chaque type et ne les considérez pas comme une quantité totale autorisée. Les champs sont décrits dans reference.md. - La validation des paramètres (obligatoires, plages, paramètres non déclarés) est effectuée par le serveur avant la facturation ; les messages d'erreur listent les éléments problématiques. En cas d'erreur de paramètre, traduisez les informations du serveur pour l'utilisateur.
Routage d'intention (tableau de décision obligatoire)
| Intention de l'utilisateur | Commande | Description |
|---|---|---|
| Demander ce que Kling peut faire / quelles sont les capacités (pas de tâche spécifique) | who_am_i | Afficher les capacités générales et les modèles disponibles pour le compte actuel, voir la section « Présentation des capacités » ci-dessus |
| Vérifier les modèles disponibles / si un modèle spécifique est disponible / les spécifications des paramètres | who_am_i | Afficher directement les capacités et limites pertinentes pour la question |
| Vérifier les outils ouverts pour le compte / si la bibliothèque de sujets ou de mouvements est disponible | tool_list | Expliquer l'usage des outils selon la réponse réelle du serveur |
| Générer une image / sortir une image / texte vers image | text_to_image | Interroger query_tasks après soumission |
| Image vers image / avec une image de référence | image_to_image | --image peut être répété, interroger après soumission |
| Générer une vidéo / texte vers vidéo | text_to_video | Interroger après soumission |
| Image vers vidéo / faire bouger une image / images clés de début-milieu-fin | image_to_video | Transmettre --image / --tailImage ou --input nommé selon la déclaration du modèle ; le prompt est optionnel selon la déclaration du modèle, interroger après soumission |
| Générer une vidéo avec une référence mixte image, vidéo, audio, sujet | omni_ref_video | Transmettre --image / --video / --audio / --elements selon la déclaration du modèle ; le prompt est obligatoire, interroger après soumission |
| Créer / lister / voir / mettre à jour / supprimer un sujet réutilisable | element_create / element_list / element_get / element_update / element_delete | Les mises à jour ne transmettent que les champs modifiés ; la suppression nécessite une confirmation explicite de l'utilisateur |
| Contrôle de mouvement / transfert de mouvement | motion_control | Choisir --image + --video ou --motionId ; interroger après soumission |
| Voir les mouvements enregistrés | motion_library_list | L'motionId obtenu peut être utilisé avec motion_control |
| Signaler un blocage, une erreur floue, une anomalie de facturation, un résultat inattendu | feedback | Uniquement un retour, ne réessaie pas, ne rembourse pas et ne corrige pas la tâche d'origine |
| Spécifier explicitement un modèle ou une série | Choisir la commande selon l'intention créative, puis passer le --model complet | Analyser le nom ou l'alias dans la liste des modèles en temps réel de la commande correspondante |
| Télécharger une ressource locale | file_upload | Seuls les fichiers locaux doivent être téléchargés (retourne une URL publique) ; les ressources déjà en URL publique n'ont pas besoin d'être téléchargées, transmettez-les directement avec --image à la commande de génération |
| Vérifier l'abonnement / l'identité du compte / le solde | account | Retourne userId + membership + crédits disponibles (afficher directement) |
| Consulter ou sélectionner un espace de travail personnel / d'équipe | who_am_i → tool_list | Vérifier les capacités en temps réel. Ne soumettez une génération que si vous pouvez confirmer l'espace de travail requis et l'imputation des coûts. |
| Recharger / solde insuffisant / souscrire un abonnement | account | Afficher le lien de recharge/d'abonnement renvoyé par le serveur (dynamique depuis MCP, ne pas coder en dur, voir « Solde insuffisant et recharge ») |
| Se déconnecter / quitter le compte actuel | logout | Effacer l'état de connexion local après une déconnexion MCP réussie ; terminer après succès, ne pas se reconnecter automatiquement |
| Changer de compte / se connecter avec un autre compte | logout → login → who_am_i | Doit être exécuté dans l'ordre ; si logout ou login échoue, arrêtez immédiatement ; vérifier le compte après une nouvelle autorisation |
| Dire simplement « générer avec Kling » ou autre intention vague | — | Demandez d'abord s'il s'agit d'une image ou d'une vidéo, puis soumettez |
Si l'intention de l'utilisateur n'est pas claire, confirmez d'abord avant de soumettre, ne faites pas de suppositions.
Déconnexion et changement de compte
- Déconnexion uniquement : lorsque l'utilisateur demande explicitement à se déconnecter du compte actuel, exécutez
kling logout. Terminez après succès ; ne déclenchez pas automatiquement une nouvelle autorisation du navigateur. - Changement de compte : exécutez impérativement dans l'ordre
kling logout→kling login→kling who_am_i. Ne continuez avecloginqu'après la réussite delogout; lors de l'autorisation du navigateur, l'utilisateur choisit le compte cible ; après une connexion réussie, utilisezwho_am_ipour afficher et confirmer l'identité actuelle. - En cas d'échec de
logout, arrêtez immédiatement : conservez l'état de connexion local pour permettre une nouvelle tentative, et informez l'utilisateur de l'erreur d'origine ; ne passez pas outre l'échec pour effectuer directementlogin. - En cas d'échec de
login, arrêtez immédiatement : signalez l'erreur de connexion, ne continuez pas avecwho_am_i, et n'utilisez pas de cookies, de collage de token, de capture réseau ou d'autre méthode d'autorisation à la place. - N'utilisez pas
logincomme substitut du processus de changement :loginne gère que l'autorisation OAuth locale ; son exécution seule ne garantit pas que l'ancienne autorisation côté serveur a été révoquée. Si l'utilisateur dit explicitement « changer de compte », vous devez d'abord passer parlogout.
Espaces de travail personnel et d'équipe
Utilisez who_am_i pour confirmer l'identité de connexion, utilisez tool_list pour vérifier les outils et paramètres en temps réel. Le account du CLI 0.2.4 interroge le solde du compte et refusera les options d'espace de travail. Ne soumettez des tâches avec facturation à partir d'un espace de travail spécifié par l'utilisateur que si le serveur déclare explicitement la sélection de l'espace de travail et peut vérifier l'imputation des coûts.
Flux de travail des Elements et contraintes de compatibilité
- Création : Utilisez
--cover+ 1 à 3--secondarypour les Elements de type image ; utilisez uniquement--videopour les Elements de type vidéo. Les deux types de ressources ne peuvent pas être mélangés. Les deux doivent avoir au moins un--tag; les tags doivent être choisis et transmis tels quels dans la description en temps réel de l'outil pourelement_createde la région actuelle ; ne traduisez pas les tags en fonction de la langue de la conversation et ne codez pas en dur la liste d'une région. Un fichier.mp3--voiceoptionnel. Les fichiers locaux sont téléchargés automatiquement. - Confirmez le type et la compatibilité avant la liaison : commencez par
element_listpour trouver l'id, puiselement_get <id>pour voir leresourcecomplet, et vérifiez simultanément les limites de type d'Element dans la description en temps réel de l'outil et les paramètres du modèle danswho_am_i. Le modèle cible doit déclarerelements; un élément image ne doit pas être refusé simplement parce que le nom du modèle estkling-image-o1. Si le modèle déclareelements, mais que la description de l'outil interdit explicitement ce type d'élément ou cette méthode d'appel, respectez la restriction, ne déduisez pas la prise en charge uniquement de la présence du paramètre ; si d'autres déclarations conflictuelles empêchent de confirmer la compatibilité, informez l'utilisateur du conflit spécifique et suspendez cette soumission de liaison, n'utilisez pas une tâche facturée comme test. Les modèles compatibles doivent correspondre à l'intention de l'utilisateur ; avant de changer de modèle, suivez les règles de nouvelle tentative et de sélection. - Syntaxe de liaison : Dans le prompt, marquez le sujet avec
<<<id>>>et transmettez simultanément--elements '[{"id":"<id>","bindName":"<nom>","type":"<type retourné par element_get>"}]'selon la déclaration dewho_am_i. N'écrivez pas seulement le placeholder sans transmettreelements, et ne transmettez paselementsà un outil/modèle incompatible. - Les mises à jour ne transmettent que les champs modifiés : l'utilisateur n'a pas besoin de compléter manuellement les champs existants, ne transmettez pas
--cover. En mode TTY réel, sielementIdest manquant, le système demande d'abord de le saisir.
...
[Le contenu a été tronqué pour la traduction ; veuillez trouver la suite dans le document source original.]