Communitygithub.com

kling-cli

Offizielles Kling AI CLI-Skill zur Bild- und Videogenerierung, Element- und Bewegungssteuerung über die Befehlszeile.

Was ist kling-cli?

Dieses Skill ermöglicht die nahtlose Integration von Kling AIs Bild- und Videogenerierungsfunktionen in KI-Agenten wie Claude Code, Cursor oder Codex. Es bietet einen vollständigen Satz von CLI-Befehlen, um Bilder und Videos aus Text- oder Bildvorlagen zu erstellen, wiederverwendbare Objekte (Elemente) zu verwalten und Bewegungssteuerungen mit Referenzvideos anzuwenden. Das Skill erzwingt die ausschließliche Nutzung des `kling`-CLI-Befehls, um Sicherheit und Konsistenz zu gewährleisten, und führt autorisierte Aktionen wie die Installation über `npm` und den Login über OAuth im Browser aus. Es unterstützt sowohl den chinesischen als auch den internationalen Markt von Kling mit getrennten CLI-Paketen und bietet eine Echtzeitmodellabfrage (`who_am_i`), um Modellverfügbarkeit und Parameterspezifikationen vor der Generierung zu prüfen. Die Ergebnisse werden über eine Abfrageschleife (`query_tasks`) abgerufen und direkt als öffentliche URLs bereitgestellt, während Benutzerinteraktionen wie Fehlerberichte oder Kontoinformationen über spezifische Befehle abgewickelt werden.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Kling AI Offizielle Bild-/Videogenerierung, Element-Subjekte und Bewegungssteuerung

Sprache und Antwortstil

  • Benutzerorientierte Erklärungen, Bestätigungen, Fehlermeldungen: Folgt der Sprache des Benutzers (deutsche Benutzer antworten auf Deutsch).
  • Technische Feldnamen (generationId, status, works[].url, etc.) bleiben im englischen Original. Antwortfelder sind einheitlich in camelCase (z. B. generationId / creditsConsumed / urlWithoutWatermark); die alte Serverversion könnte noch snake_case-Synonyme (generation_id, etc.) zurückgeben, die als dasselbe Feld zu verstehen sind.

Funktionsübersicht

Feste Begrüßung (der Text selbst erfordert keinen Befehlsaufruf), geeignet für folgende Szenarien:

  1. Der Benutzer hat gerade die Installation/Anmeldung für dieses Skill oder CLI abgeschlossen und die Umgebung ist bereit.
  2. Der Benutzer fragt nach den Fähigkeiten von Kling / was es kann / wie man es verwendet usw. – Anfragen zur Fähigkeitsberatung (ohne spezifische Generierungsaufgaben).

Präsentationsanforderungen (Struktur und Emojis beibehalten. Die für das aktuelle Konto verfügbaren Fähigkeiten siehe unten):

  • Deutschsprachige Benutzer: Geben Sie die deutsche Version wie unten aus.
  • Nicht-deutschsprachige Benutzer: Muss übersetzt werden, darf nicht die deutsche Version ausgeben – priorisieren Sie die Übersetzung in die Sprache des Benutzers (geben Sie japanischen Benutzern die japanische Version usw., übersetzen Sie die Beispielzitate mit); geben Sie für Sprachen, die nicht zuverlässig übersetzt werden können, zumindest die englische Version aus.
  • Falls die Umgebung noch nicht bereit ist (CLI nicht installiert oder nicht angemeldet), ersetzen Sie die erste Zeile „Kling ist bereit!" durch einen entsprechenden Leitfaden in der jeweiligen Sprache (z. B. „Kling ist einen Schritt entfernt") und fügen Sie nach dem Text die nächsten Schritte für Installation/Anmeldung hinzu.

Deutsche Version:

Kling ist bereit!

Hier ist, was du mit Kling machen kannst:

📷 Bilder generieren
   · Text zu Bild — "Zeichne mir eine Katze im Cyberpunk-Stil"
   · Referenzbild zu Bild — "Verwende dieses Bild als Referenz und gestalte es im Aquarellstil um"

🎬 Videos generieren
   · Text zu Video — "Generiere ein 5-Sekunden-Video von einem Sonnenuntergang am Meer"
   · Bild zu Video — "Erwecke dieses Bild zum Leben"
   · Keyframes — "Verwende diese beiden Bilder als Start- und Endbild" (modellabhängig)
   · Omni-Referenz — "Behalte die Figur aus diesem Bild und übernimm die Kamerabewegung aus diesem Video"

🧩 Wiederverwendbare Subjekte — erstelle und verwalte Charaktere, Tiere, Requisiten und andere Elemente
🎭 Bewegungssteuerung — steuere ein Subjektbild mit einem Bewegungsvideo oder einer gespeicherten Bewegung

📤 Assets hochladen — verwende lokale Bilder, Videos und Audiodateien, wo unterstützt
📋 Aufträge und Konto — überprüfe Generierungsfortschritt, Ergebnisse, Mitgliedschaft und Guthaben

Du kannst auch Agent- und Skill-Fähigkeiten kombinieren, um komplexere kreative Workflows zu erstellen – wie das Erstellen eines Werbespots, eines Kurzfilms oder die Batch-Produktion einer Reihe von Assets.

Derzeit für das Konto verfügbare Fähigkeiten

  • Wenn der Benutzer fragt „Was kann ich jetzt tun?" / „Welche Fähigkeiten gibt es?", zeigen Sie die Begrüßung und ergänzen Sie die für das aktuelle Konto verfügbaren Modelle mit dem schreibgeschützten Befehl kling who_am_i. Nach der Installation oder Anmeldung können Sie bei der Anzeige der Begrüßung direkt die bereits ermittelte Liste verwenden.
  • Gruppieren Sie die Ergebnisse nach Bild und Video, zeigen Sie die Modellnamen aus availableModels in der Sprache des Benutzers an (bevorzugen Sie den lesbaren alias, sonst model). Wenn dasselbe Modell in mehreren Einstiegen erscheint, kombinieren Sie die Anzeige und kennzeichnen Sie die von jedem Einstieg unterstützten Erstellungsmethoden.
  • Wenn der Benutzer nach einem bestimmten Modell, Verwendungszweck oder Parameter fragt, zeigen Sie nur die relevanten Elemente an. Überprüfen Sie anhand des entsprechenden Einstiegs die Einschränkungen bezüglich Materialtyp und -anzahl, Dauer, Auflösung usw. und erklären Sie gegebenenfalls die Abrechnungsregeln für Referenzmaterialien. Heben Sie beim Vergleich die Unterschiede zwischen den Einstiegen hervor, z. B. sind die Generierung einer Tonspur und das Hochladen einer Audio-Referenz zwei verschiedene Fähigkeiten.
  • Wenn der Benutzer fragt, welche Tools für das aktuelle Konto verfügbar sind, oder bestätigen möchte, ob Tools wie die Subjektbibliothek oder die Bewegungsbibliothek geöffnet sind, fragen Sie zusätzlich mit dem schreibgeschützten Befehl kling tool_list ab und erklären Sie die tatsächlich vom Server bereitgestellten Tools im Hinblick auf den kreativen Zweck. Modelle und Parameter basieren auf who_am_i.
  • Wenn das CLI nicht installiert, nicht angemeldet ist oder die Abfrage fehlschlägt, können Sie dennoch die allgemeinen Fähigkeiten vorstellen und darauf hinweisen, dass die Liste für das aktuelle Konto noch nicht bestätigt wurde. Wenn die Abfrage erfolgreich ist, das gewünschte Modell jedoch nicht aufgeführt ist, erklären Sie, dass der entsprechende Einstieg für das aktuelle Konto dieses Modell nicht auflistet. Wenn nach dem Veröffentlichungsdatum gefragt wird, antworten Sie mit datumsbasierten Informationen.

Installation und Anmeldung (Einzig legitimer Weg)

Kling unterscheidet zwischen „Inlandsseite" und „Auslandsseite", die zwei verschiedenen Installationspaketen entsprechen, deren Endpunkte bereits integriert sind. Die Installation des falschen Pakets führt zu wiederholten Anmeldefehlern. Daher muss vor der Installation bestätigt werden, zu welcher Region der Benutzer gehört.

Schritt 0: Prüfen, ob bereits installiert

which kling   # Ausgabe eines Pfads → Version prüfen; nicht gefunden → zu Schritt 1 für regionsspezifische Installation
kling --version   # Für die vollständigen Fähigkeiten dieses Skills wird CLI >= 0.2.4 benötigt

Wenn die installierte Version niedriger als 0.2.4 ist, aktualisieren Sie das entsprechende npm-Paket basierend auf der Region des vorhandenen Kontos, bevor Sie neue Funktionen nutzen. Wenn der Benutzer ausdrücklich ein Update angefordert hat, führen Sie es direkt aus, ohne erneute Bestätigung. CLI und Skill werden separat verteilt; nur das Skill zu aktualisieren, aktualisiert nicht das CLI.

Seit 0.2.1 wurde die Kurzform --omni entfernt; alle Generierungsbefehle müssen explizit --model <Name> übergeben. Der Befehl für die Omni-Referenzvideo-Mischung lautet omni_ref_video; verwenden Sie nicht das alte Flag als Ersatz für diesen Befehl.

Schritt 1: Region bestätigen und installieren (Befehlsname einheitlich kling)

Wie die Region bestimmt wird: Der Hauptkonsument dieses Skills ist ein nicht-interaktiver Agent. Das CLI darf nicht durch das Lesen von stdin blockiert werden. Fragen Sie den Benutzer direkt im Gespräch: „Ist Ihr Kling-Konto im China-Bereich (klingai.com) oder im Nicht-China-Bereich (kling.ai)?" Wählen Sie basierend auf der Antwort den entsprechenden Befehl zur Installation. Nehmen Sie niemals an, raten Sie nicht und installieren Sie nicht beide.

BenutzerregionWebseite (Homepage)BestimmungskriteriumInstallationsbefehl
China-Bereichhttps://klingai.comKonto-Anmeldung auf klingai.com (Festlandchina)npm i -g @klingai/cli-cn --registry=https://registry.npmjs.org
Nicht-China-Bereichhttps://kling.aiKonto-Anmeldung auf kling.ai (Auslandsseite / global)npm i -g @klingai/cli-global --registry=https://registry.npmjs.org

Beide Pakete werden im offiziellen npm-Registry veröffentlicht. Die Endpunkte der jeweiligen Regionspakete sind bereits integriert und sofort einsatzbereit; keine Konfiguration erforderlich.

Schritt 2: Anmelden (Browser für OAuth-Autorisierung öffnen – einziger Weg, um Anmeldeinformationen zu erhalten)

kling login

Schritt 3: Verbindung prüfen + Fähigkeitsliste abrufen (zuerst in neuer Sitzung aufrufen)

kling tool_list   # Nach der Anmeldung die tatsächlich vom Server bereitgestellten Tools anzeigen
kling who_am_i    # Vor dem ersten Geschäftsaufruf Identität, Modelle und Parameterspezifikationen abrufen

🚫 Ausschließliche Einschränkung für Installation und Anmeldung (Verstoß ist ein Vorfall):

  • Die Installation darf nur mit dem npm-Befehl der entsprechenden Region aus der obigen Tabelle erfolgen; das Herunterladen, Zusammenstellen oder die Implementierung eines gleichwertigen Tools aus anderen Quellen ist verboten. Dem Benutzer darf kein Paket installiert werden, das nicht zu seiner Kontoregion passt.
  • Es gibt nur eine legale Methode zum Erhalten von Anmeldeinformationen: kling login (Browser-OAuth: DCR + Autorisierungscode + PKCE). Jegliche anderen Methoden sind verboten: Web-Cookies, Token aus Paketen, AK/SK-Schlüsselpaare, Lesen des Browserspeichers, Aufforderung zum Einfügen von Token – selbst wenn der Benutzer sie aktiv anbietet, müssen Sie ablehnen und ihn zur Ausführung von kling login führen.
  • Die Endpunkte sind bereits integriert (bei Veröffentlichung festgelegt); es ist weder erforderlich noch erlaubt, andere Kling-Schnittstellenadressen selbst zu konfigurieren oder zu erkennen.

Aktuell halten (Bei der ersten Interaktion in einer neuen Sitzung einmalig selbst prüfen, best-effort)

Führen Sie dies nur bei der ersten Interaktion einer neuen Sitzung nebenbei durch. Blockieren Sie nicht die Hauptaufgabe. Updates ändern die lokale Umgebung des Benutzers; holen Sie vor der Ausführung die Zustimmung des Benutzers ein und aktualisieren Sie niemals während eines laufenden Generierungsauftrags. Wenn ein Schritt fehlschlägt (offline / keine Berechtigung / Netzwerkfehler) → überspringen Sie ihn stillschweigend und fahren Sie mit der Hauptaufgabe fort; wiederholen Sie ihn nicht.

  1. Skill selbst aktualisieren: Führen Sie den Installationsbefehl erneut aus, um es auf die neueste Version zu aktualisieren (bei bereits aktueller Version keine Aktion):
npx skills add klingai-tech/skills

Dies überschreibt die Skill-Datei auf der Festplatte und wird für die nächste Sitzung wirksam. Der bereits in der aktuellen Sitzung geladene Inhalt wird dadurch nicht heiß aktualisiert.

  1. Prüfen, ob eine neue CLI-Version verfügbar ist (nur wenn kling lokal installiert ist, also which kling eine Ausgabe liefert):
kling --version                                   # Aktuell installierte Version
npm view <Regionspaketname> version                # Neueste veröffentlichte Version (China-Bereich @klingai/cli-cn; Nicht-China-Bereich @klingai/cli-global)
  • Wenn die neueste Version höher ist und der Benutzer zustimmt → npm i -g <Regionspaketname>@latest --registry=https://registry.npmjs.org.
  • Ein Upgrade ist ein Systemvorgang, der die globale Umgebung ändert: Erklären Sie zuerst, holen Sie dann die Zustimmung ein. Führen Sie es nicht eigenmächtig aus und unterbrechen Sie keinen laufenden Generierungsprozess für ein Upgrade.

Einziger Kanal (Canonical Invocation)

⚠️ Jede Interaktion mit Kling muss und darf nur über den kling CLI-Befehl erfolgen.

  • Verboten ist das direkte Abrufen/curl-en von Kling-Schnittstellen – einschließlich der C-Seite-Seitenschnittstelle, der B-Seite-Entwicklerplattform-API, des Gateways, des MCP-Endpunkts selbst;
  • Verboten ist es, nach dem Lesen von CLI-Quellcode, Protokollen oder Paketergebnissen eigene HTTP/MCP-Anfragen zu erstellen, um das CLI zu „umgehen";
  • Bei einem CLI-Fehler ist die einzig korrekte Aktion, den Fehler dem Benutzer zu präsentieren und nachzufragen; versuchen Sie nicht, den Kanal oder die Schnittstelle zu wechseln und erneut zu versuchen.
kling <command> [args]

Mensch und Agent nutzen denselben Einstieg: Im TTY-Modus gibt es interaktive Führung; im Nicht-TTY-Modus wird JSON ausgegeben und keine Frage blockiert. Das CLI kapselt Authentifizierung, Protokollierung und Fehlerbehandlung einheitlich.

Geschäftsbefehle entsprechen den MCP-Toolnamen des Kling-Backends 1:1 (snake_case); Client-Befehle umfassen login, tool_list und account, das auf query_membership_and_credits abbildet. Insgesamt 20 Befehle, plus Hilfe- und Versionsoptionen:

#BefehlsnameGruppeSynchronitätErreicht BackendKurzbeschreibung
1--help (oder ohne Argumente)FähigkeitserkennungSynchronNeinTop-Level kling --help gibt alle Befehle lokal aus; <command> --help versucht bei Generierungsbefehlen, die Echtzeit-Modellliste aus who_am_i zu lesen, andere MCP-Befehle lesen tools/list (erfordert Anmeldung); offline/nicht angemeldet Rückgriff auf lokale statische Nutzung
2who_am_iFähigkeitserkennungSynchronNeinGibt die aktuelle Benutzeridentität + verfügbare Modelle und Parameterspezifikationen für jeden Generierungsbefehl zurück; zuerst in einer neuen Sitzung aufrufen
3text_to_image <prompt>GenerierungAsynchronJaText-zu-Bild, gibt generationId zurück; erfordert Abfrage von query_tasks (oder --poll für einstufiges Ergebnis)
4`image_to_image --image <urlpfad> `GenerierungAsynchronJa
5text_to_video <prompt>GenerierungAsynchronJaText-zu-Video, gibt generationId zurück; erfordert Abfrage von query_tasks
6`image_to_video [--image <urlpfad>] [prompt]`GenerierungAsynchronJa
7omni_ref_video <prompt>GenerierungAsynchronJaMischt Bild-, Video-, Audio- oder Element-Referenzen; Typ gemäß Modelldeklaration, gibt generationId zurück
8query_tasks <generationId>AuftragsabfrageSynchronJaFragt Generierungsstatus und endgültige Ressourcen-URLs (works[].url) nach generationId ab
9file_upload <filePath>DateiuploadSynchronJaZweistufiger Upload (Ticket beantragen + Dateibytes hochladen), gibt öffentliche URL zurück
10element_createSubjektmaterialSynchronJaErstellt wiederverwendbares Element aus Bildgruppe oder Video, gibt Element-ID zurück
11element_list / element_getSubjektmaterialSynchronJaListet Elemente auf; ruft vollständige Typ- und Ressourcendetails nach ID ab
12element_update / element_deleteSubjektmaterialSynchronJaAktualisiert nach Feld oder löscht Element; primäres Bild wird vom CLI automatisch beibehalten
13motion_library_listBewegungsmaterialSynchronJaListet gespeicherte Bewegungen auf, liefert motionId und abspielbare URL
14motion_controlGenerierungAsynchronJaGeneriert Video mit Subjektbild + Bewegungsvideo oder motionId, gibt generationId zurück
15feedbackFeedbackSynchronJaMeldet Hänger, obskure Fehler, Abrechnungsanomalien oder unerwartete Ergebnisse; ist nicht für Wiederholung/Rückerstattung/Reparatur zuständig
16accountKommerziellSynchronJaMitgliedschaftstyp + verfügbare Credits (query_membership_and_credits, Identität aus JWT)
17tool_listFähigkeitserkennungSynchronNeinListet die aktuell vom Backend-MCP-Server bereitgestellten Tools auf (MCP tools/list): Name / description / inputSchema jedes Tools (zur Fehlerbehebung / Bestätigung der tatsächlich verfügbaren Tools)
18loginAuthentifizierungSynchronNein (nur OAuth-Dienst)Browser-OAuth-Anmeldung (DCR + PKCE), Token wird in lokale .credentials-Datei geschrieben
19logoutAuthentifizierungSynchronJaRuft MCP logout auf, um die serverseitige Autorisierung zu widerrufen, und löscht den lokalen Anmeldestatus, um eine erneute Autorisierung oder einen Kontowechsel zu ermöglichen

Endpunkte sind integriert: Nach der Installation des entsprechenden Regionspakets sofort einsatzbereit; keine Konfiguration erforderlich. Es gibt keine externen Konfigurationsschnittstellen (keine Umgebungsvariablen, keine .env-Datei, kein config-Befehl). Versuchen Sie nicht, andere Kling-Schnittstellenadressen zu erkennen oder anzugeben.

Keine Aliasse: Ein Befehl, ein Name. Alte Formen (image generate, text2image, usw.) werden nicht mehr unterstützt. Verwenden Sie die oben genannten kanonischen Befehle.

Die Ausführung von kling (ohne Argumente) oder mit einem ungültigen Unterbefehl gibt die vollständige Nutzungshilfe aus.


Empfohlene Verwendung (Best Practices, die der Agent befolgen muss)

Ziel: Weniger Fehlversuche, keine Verschwendung von Credits, Parameter immer serverseitig aktuell.

Erste Interaktion in einer neuen Sitzung: Führen Sie zuerst eine best-effort-Selbstprüfung gemäß dem Abschnitt „Aktuell halten" durch (Skill aktualisieren / prüfen, ob eine neue CLI-Version vorliegt), ohne die Hauptaufgabe zu unterbrechen; holen Sie vor dem Update die Zustimmung des Benutzers ein.

Einfachste drei Schritte: ① kling login → ② kling tool_list für Tools, kling who_am_i für Identität und Modellspezifikationen → ③ kling <command> ausführen (alle 6 Generierungsbefehle müssen explizit --model übergeben).

  1. In neuer Sitzung zuerst kling who_am_i: Erhalten Sie auf einen Schlag Identität + verfügbare Modelle und Parameterspezifikationen (Pflichtfelder / Standardwerte / Wertebereiche) für jeden Generierungsbefehl. Die folgenden Modell- und Parameterauswahlen basieren darauf.
  2. Wenn Sie nicht wissen, welche Fähigkeiten der Server bereitstellt, verwenden Sie kling tool_list: Listet die aktuell vom Backend-MCP-Server tatsächlich bereitgestellten Tools auf (tools/list). Geeignet zur Fehlerbehebung und Bestätigung, ob eine bestimmte Fähigkeit verfügbar ist. Erfordert Anmeldung, verbraucht keine Credits.
  3. Wie man Parameter an einen Befehl übergibt, erfahren Sie mit kling <command> --help: Versucht bei Generierungsbefehlen, die Echtzeit-Modellparameter und Eingabeslots aus who_am_i zu lesen; andere MCP-Befehle lesen tools/list (Tool-Beschreibung + inputSchema); offline/nicht angemeldet Rückgriff auf lokale statische Nutzung. Vollständige Modelle und Parameter basieren dennoch auf who_am_i.
  4. Generierung muss explizit ein Modell auswählen: text_to_image / image_to_image / text_to_video / image_to_video / omni_ref_video / motion_control müssen alle --model <Name> übergeben (aus der who_am_i-Liste des entsprechenden Tools). Das CLI wählt nicht automatisch ein Standardmodell für den Benutzer; motion_control zeigt in einer echten TTY bei fehlendem Modell Kandidatenmodelle zur Auswahl an; Agent-/Pipeline-/CI- und andere nicht-interaktive Umgebungen geben einen Fehler vor der Abrechnung aus.
  5. Materialien direkt als lokalen Pfad oder öffentliche URL übergeben: Übergeben Sie Bild-, Video- oder Audiomaterialien gemäß der Hilfe des ausgewählten Befehls. Lokale Dateien werden vom CLI automatisch per file_upload hochgeladen; manuelles Hochladen ist nicht erforderlich. Öffentliche URLs (externes CDN / externer Link oder bereits von einer früheren Kling-Aufgabe zurückgegebene works[].url) werden direkt an den Server weitergeleitet; kein Herunterladen, erneutes Hochladen oder lokale Prüfung erforderlich. Format-/Größenbeschränkungen von Materialien basieren auf der Echtzeit-Tool-Deklaration (kling <command> --help / kling tool_list).
  6. Nach dem Absenden sofort Feedback geben, dann abfragen: Entnehmen Sie generationId und creditsConsumed aus der Antwort und informieren Sie den Benutzer zuerst. Fragen Sie dann mit kling query_tasks <generationId> nach, oder fügen Sie beim Absenden --poll [N] hinzu, um das Ergebnis in einem Schritt zu erhalten (rohes --poll standardmäßig 60s, --poll 0 deaktiviert die Inline-Abfrage).
  7. Ergebnisse in works[]: Extrahieren Sie die Links zu den Originaldateien und liefern Sie sie gemäß „Ergebnisanzeige" aus. Wenn Videos eine separate Vorschau haben, verwenden Sie vorzugsweise die Vorschau zur Wiedergabe.
  8. Guthaben / Mitgliedschaft mit account anzeigen: Wenn das Guthaben nicht ausreicht, zeigen Sie den vom Server dynamisch zurückgegebenen Aufladungslink an (nicht fest codieren).
  9. Bei Fehlern nicht automatisch Parameter ändern und erneut einreichen: Bei Parameterfehlern zeigen Sie dem Benutzer zuerst anhand von who_am_i die korrekte Schreibweise; wiederholen Sie den Vorgang erst nach Bestätigung. Ändern Sie nicht stillschweigend den Prompt / wechseln Sie das Modell / fügen Sie Bilder hinzu oder löschen Sie sie, um automatisch erneut einzureichen.

Typische Reihenfolge: Nach der Anmeldung tool_list → who_am_i → (bei Bedarf <command> --help) → text_to_* / image_to_* / omni_ref_video / motion_control mit --model absenden → query_tasks abfragen → works[].url anzeigen.


Modelle und Parameter: Maßgeblich ist who_am_i (Kernkonzept)

  • Modellliste und Parameterspezifikationen werden vollständig vom Server konfiguriert: who_am_i gibt availableModels zurück (Toolname → Modell → arguments/inputs-Spezifikation, inklusive Pflichtfelder, Standardwerte, Wertebereiche).
  • Die Hilfe für einzelne Befehle priorisiert die Echtzeit-Deklaration: Für MCP-gestützte Befehle wie who_am_i / Generierung / Abfrage / Upload / Konto versucht kling <command> --help, bei Generierungsbefehlen die Echtzeit-Modellparameter und Eingabeslots aus who_am_i zu lesen; andere MCP-Befehle lesen tools/list (Tool-Beschreibung + inputSchema); offline oder nicht angemeldet Rückgriff auf lokale statische Nutzung. Die vollständige Modellliste und Parameterspezifikationen basieren dennoch auf who_am_i.
  • Die 6 Generierungsbefehle müssen alle explizit --model <Name> übergeben. Wenn der Benutzer ein Modell angibt, wählen Sie den Befehl entsprechend der kreativen Absicht aus, lokalisieren Sie das Modell in der who_am_i-Liste des Befehls anhand des Namens oder Alias (alias) und übergeben Sie den zurückgegebenen model-Wert. Wenn keine eindeutige Übereinstimmung möglich ist oder das Modell die erforderliche Eingabe oder Parameter nicht unterstützt, erläutern Sie dies dem Benutzer und holen Sie eine Bestätigung ein, bevor Sie es einreichen; wechseln Sie das Modell nicht selbstständig.
  • Standardmäßig wird Kling Image 4.0 bevorzugt: Wenn der Benutzer kein Modell angibt, wählen Sie in der Echtzeitliste von text_to_image oder image_to_image vorzugsweise Kling Image 4.0 aus, das die Anforderungen dieser Aufgabe erfüllt, und übergeben Sie explizit den model-Wert dieses Eintrags. Wenn dieses Modell nicht verfügbar ist oder die erforderlichen Parameter/Materialien nicht unterstützt, wählen Sie aus der Liste des entsprechenden Befehls ein Modell aus, das die Anforderungen dieser Aufgabe unterstützt.
  • Praktische Flags des CLI (--imgResolution, --aspectRatio, --imageCount, --duration, usw.) werden auf Protokollparameternamen abgebildet und transparent weitergeleitet; nicht bereitgestellte Parameter werden vom Server mit Standardwerten belegt. Wenn motion_control obligatorische Parameter hat, die vom Server nicht deklariert wurden und keinen Standardwert haben, wird die echte TTY vor dem Upload eine geführte Auswahl/Eingabe gemäß dem Wertebereich anbieten; nicht-interaktive Umgebungen geben alle fehlenden Elemente auf einmal aus und beenden, ohne hochzuladen oder einzureichen.
  • Eingabe gemäß Deklaration zuordnen: Überprüfen Sie zuerst mit der Befehls Hilfe die CLI-Schreibweise, dann gleichen Sie gemäß inputs und arguments von who_am_i die Materialtypen, Slot-Namen und Pflichtigkeit ab. Gehen Sie nicht davon aus, dass alle Bildeingänge einen ersten Frame haben müssen oder dass alle Generierungsbefehle das Weglassen des Prompts erlauben. Bei der Verwendung benannter Eingänge dürfen Slots nicht doppelt belegt werden; ob sie mit praktischen Flags gemischt werden können, bestimmt die Hilfe des jeweiligen Befehls. Die Zuordnung und Beispiele für jeden Befehl finden Sie in api-examples.md.
  • Bei den sechs Generierungsbefehlen kann --poll den Optionswert weglassen. Andere Generierungsoptionen benötigen explizite Werte; Materialoptionen müssen mit dem Befehl übereinstimmen. Das CLI überprüft Optionen und Pflichtmaterialien vor dem Upload.
  • Parameter gemäß Deklaration setzen und Kombinationseinschränkungen prüfen: Wählen Sie den Einstieg gemäß der kreativen Absicht, dann überprüfen Sie anhand der who_am_i des aktuellen Kontos und der Tool-Beschreibung die Parameter, Standardwerte, verfügbaren Kombinationen und Eingabekompatibilität des ausgewählten Modells. Vom Benutzer ausdrücklich gewünschte Spezifikationen sollten explizit als entsprechende Parameter übergeben werden. Wenn der aktuelle Einstieg oder das Modell die Anforderungen nicht erfüllt, erklären Sie die Einschränkungen und warten Sie, bis der Benutzer die verfügbaren Spezifikationen bestätigt, bevor Sie einreichen.
  • Bildgenerierung: Überprüfen Sie gemäß den arguments des ausgewählten Modells Auflösung, Anzahl der Ausgabebilder und Generierungsmodus; überprüfen Sie gemäß den inputs die Anzahl der Referenzbilder und Slots. Wenn der Benutzer eine zusammenhängende Bildserie wünscht, setzen Sie gemäß der Deklaration den Serienmodus und die Anzahl der Ausgabebilder und beschreiben Sie im Prompt den Inhalt jedes Bildes sowie die gemeinsamen Subjekte und Stile.
  • Neben der Anzahl pro Typ kann es auch ein combinedItemCap-Gesamtlimit geben (über Eingabeslots und Array-Parameter wie elements hinweg). image_to_video / omni_ref_video validiert vor dem Upload die relevanten Slots, Pflichteingaben und die Gesamtanzahl; addieren Sie nicht die verschiedenen Obergrenzen und betrachten Sie die Summe als zulässige Gesamtmenge. Felder siehe reference.md.
  • Die Parametervalidierung (Pflichtfelder, Wertebereiche, nicht deklarierte Parameter) erfolgt durch den Server vor der Abrechnung. Die Fehlermeldung listet die problematischen Elemente auf. Bei Parameterfehlern übersetzen Sie die Serverinformationen für den Benutzer.

Intent-Routing (Obligatorische Entscheidungstabelle)

NutzerabsichtBefehlBeschreibung
Fragen, was Kling kann / welche Fähigkeiten es gibt (keine spezifische Aufgabe)who_am_iAllgemeine Fähigkeiten und für das aktuelle Konto verfügbare Modelle anzeigen, siehe oben „Funktionsübersicht"
Verfügbare Modelle abfragen / ob ein bestimmtes Modell verfügbar ist / Parameterspezifikationenwho_am_iDirekt die für die Frage relevanten Fähigkeiten und Einschränkungen anzeigen
Abfragen, welche Tools für das Konto geöffnet sind / ob die Subjekt- oder Bewegungsbibliothek verfügbar isttool_listDen Verwendungszweck der Tools basierend auf der tatsächlichen Serverantwort erläutern
Bild generieren / Bild erstellen / Text-zu-Bildtext_to_imageNach dem Absenden query_tasks abfragen
Referenzbild-zu-Bild / mit Referenzbildimage_to_image--image kann wiederholt werden; nach dem Absenden abfragen
Video generieren / Text-zu-Videotext_to_videoNach dem Absenden abfragen
Bild-zu-Video / Bild animieren / Start-Mitte-Ende-Keyframesimage_to_videoGemäß Modelldeklaration --image / --tailImage oder benanntes --input übergeben; Prompt-Optionalität gemäß Modelldeklaration; nach dem Absenden abfragen
Bild-, Video-, Audio-, Subjekt-Mischreferenz-Video generierenomni_ref_videoGemäß Modelldeklaration --image / --video / --audio / --elements übergeben; Prompt ist Pflicht; nach dem Absenden abfragen
Wiederverwendbares Subjekt erstellen / auflisten / anzeigen / aktualisieren / löschenelement_create / element_list / element_get / element_update / element_deleteAktualisierung nur geänderte Felder übergeben; vor dem Löschen explizite Bestätigung vom Benutzer einholen
Bewegungssteuerung / Bewegungsübertragungmotion_controlSubjekt --image + --video oder --motionId (eines von beiden); nach dem Absenden abfragen
Gespeicherte Bewegungen anzeigenmotion_library_listNach Erhalt der motionId kann diese an motion_control übergeben werden
Hänger, obskure Fehler, Abrechnungsanomalien, unerwartete Ergebnisse meldenfeedbackNur Feedback; es wird nicht wiederholt, erstattet oder der ursprüngliche Auftrag repariert
Bestimmtes Modell oder Serie angebenBefehl entsprechend der kreativen Absicht wählen, dann vollständiges --model übergebenMit der Echtzeit-Modellliste des entsprechenden Befehls den Namen oder Alias auflösen
Lokales Material hochladenfile_uploadNur lokale Dateien müssen hochgeladen werden (geben öffentliche URL zurück); Materialien, die bereits eine öffentliche URL sind, müssen nicht hochgeladen werden, sondern werden direkt als --image an Generierungsbefehle übergeben
Mitgliedschaft / Kontoidentität / Guthaben abfragenaccountGibt userId + membership + verfügbare Credits zurück (direkt anzeigen)
Persönlichen / Team-Arbeitsbereich abfragen oder auswählenwho_am_i → tool_listEchtzeit-Fähigkeiten prüfen. Nur wenn der erforderliche Arbeitsbereich und die Abrechnungszuordnung bestätigt werden können, eine Generierung einreichen.
Aufladen / Guthaben nicht ausreichend / Mitgliedschaft abschließenaccountVom Server zurückgegebenen Aufladungs-/Mitgliedschaftslink anzeigen (dynamisch vom MCP bezogen, nicht fest codieren, siehe „Nicht ausreichendes Guthaben und Aufladen")
Abmelden / Aktuelles Konto verlassenlogoutNach erfolgreichem MCP-Logout den lokalen Anmeldestatus löschen; bei Erfolg beenden, nicht automatisch erneut anmelden
Konto wechseln / Mit einem anderen Konto anmeldenlogout → login → who_am_iMuss in dieser Reihenfolge ausgeführt werden; falls ein Schritt (logout oder login) fehlschlägt, sofort anhalten; nach der neuen Autorisierung das Konto überprüfen
Nur vage Absicht wie „Mit Kling generieren"—Zuerst klären, ob Bild oder Video, dann einreichen

Wenn die Absicht des Benutzers unklar ist, muss zuerst bestätigt werden, bevor ein Auftrag eingereicht wird. Nehmen Sie keine Annahmen vor.

Abmelden und Konto wechseln

  • Nur abmelden: Wenn der Benutzer ausdrücklich die Abmeldung vom aktuellen Konto wünscht, führen Sie kling logout aus. Beenden Sie nach Erfolg; lösen Sie nicht automatisch eine neue Browser-Autorisierung aus.
  • Konto wechseln: Muss nacheinander kling logout → kling login → kling who_am_i ausführen. Nur nach erfolgreichem logout kann mit login fortgefahren werden; bei der Browser-Autorisierung wählt der Benutzer das Zielkonto aus; nach erfolgreichem Login zeigen Sie mit who_am_i die aktuelle Identität an und bestätigen sie.
  • Ein fehlgeschlagener logout muss sofort abgebrochen werden: Behalten Sie den lokalen Anmeldestatus für einen erneuten Versuch bei und informieren Sie den Benutzer über den ursprünglichen Fehler; überspringen Sie den Fehler nicht und fahren Sie nicht mit login fort.
  • Ein fehlgeschlagener login muss sofort abgebrochen werden: Melden Sie den Anmeldefehler, fahren Sie nicht mit who_am_i fort und verwenden Sie keine Cookies, Token-Einfüge- oder andere Autorisierungsmethoden.
  • Verwenden Sie nicht login als Ersatz für den Wechselvorgang: login ist nur für die lokale OAuth-Autorisierung zuständig; eine separate Ausführung garantiert nicht, dass die alte serverseitige Autorisierung widerrufen wurde. Wenn der Benutzer ausdrücklich „Konto wechseln" sagt, muss zuerst logout ausgeführt werden.

Persönlicher und Team-Arbeitsbereich

Verwenden Sie who_am_i, um die Anmeldeidentität zu bestätigen, und tool_list, um die Echtzeit-Tools und Parameter zu überprüfen. account in CLI 0.2.4 lehnt Arbeitsbereichsoptionen ab. Nur wenn der Server die Arbeitsbereichsauswahl ausdrücklich deklariert und die Abrechnungszuordnung überprüft werden kann, darf ein Auftrag eingereicht werden, der die Abbuchung von einem bestimmten Arbeitsbereich erfordert.

Element-Subjekt-Workflow und Kompatibilitätseinschränkungen

  1. Erstellung: Bilder-Element mit --cover + 1–3 --secondary; Video-Element nur mit --video, die beiden Ressourcentypen dürfen nicht gemischt werden. Beide erfordern mindestens ein --tag, das aus der Echtzeit-Tool-Deklaration von element_create für die entsprechende Region ausgewählt und unverändert übergeben werden muss; übersetzen Sie Tags bei der Erstellung und Aktualisierung nicht in die Dialogsprache und codieren Sie keine Verzeichnisse einer bestimmten Region fest. Optional .mp3 --voice. Lokale Dateien werden automatisch hochgeladen.
  2. Vor der Bindung Typ und Kompatibilität prüfen: Suchen Sie zuerst mit element_list die ID, dann rufen Sie mit element_get <id> die vollständigen resource-Details ab und gleichen Sie gleichzeitig die Subjekt-Typ-Einschränkungen aus der Echtzeit-Tool-Beschreibung und die Modellparameter aus who_am_i ab. Das Zielmodell muss elements deklarieren; ein Bildsubjekt darf nicht allein aufgrund des Modellnamens (z. B. kling-image-o1) abgelehnt werden. Wenn das Modell elements deklariert, die Tool-Beschreibung diesen Subjekttyp oder die Aufrufmethode jedoch ausdrücklich verbietet, halten Sie sich dennoch an diese Einschränkung; gehen Sie nicht allein aufgrund der Existenz des Parameters von Unterstützung aus. Wenn widersprüchliche Deklarationen die Bestätigung der Kompatibilität verhindern, informieren Sie den Benutzer über den spezifischen Konflikt und setzen Sie die Bindeeinreichung aus; verwenden Sie keine kostenpflichtigen Aufgaben zum Testen. Kompatible Modelle müssen der Benutzerabsicht entsprechen; befolgen Sie vor einem Modellwechsel die Regeln für Wiederholung und Auswahl.
  3. Bindungsschreibweise: Markieren Sie das Subjekt im Prompt mit <<<id>>> und übergeben Sie gleichzeitig gemäß der who_am_i-Deklaration --elements '[{"id":"<id>","bindName":"<name>","type":"<von element_get zurückgegebener Typ>"}]'. Es ist nicht erlaubt, nur Platzhalter zu setzen, aber elements zu vergessen, noch elements an inkompatible Tools/Modelle zu übergeben.
  4. Aktualisierung nur geänderte Felder übergeben: Der Benutzer muss vorhandene Felder nicht manuell ergänzen; übergeben Sie auch kein --cover. In einer echten TTY wird bei fehlender elementId zuerst zur Eingabe aufgefordert.

Verwandte Skills