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:
- Der Benutzer hat gerade die Installation/Anmeldung für dieses Skill oder CLI abgeschlossen und die Umgebung ist bereit.
- 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
availableModelsin der Sprache des Benutzers an (bevorzugen Sie den lesbarenalias, sonstmodel). 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_listab und erklären Sie die tatsächlich vom Server bereitgestellten Tools im Hinblick auf den kreativen Zweck. Modelle und Parameter basieren aufwho_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.
| Benutzerregion | Webseite (Homepage) | Bestimmungskriterium | Installationsbefehl |
|---|---|---|---|
| China-Bereich | https://klingai.com | Konto-Anmeldung auf klingai.com (Festlandchina) | npm i -g @klingai/cli-cn --registry=https://registry.npmjs.org |
| Nicht-China-Bereich | https://kling.ai | Konto-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 vonkling loginfü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.
- 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.
- Prüfen, ob eine neue CLI-Version verfügbar ist (nur wenn
klinglokal installiert ist, alsowhich klingeine 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
klingCLI-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:
| # | Befehlsname | Gruppe | Synchronität | Erreicht Backend | Kurzbeschreibung |
|---|---|---|---|---|---|
| 1 | --help (oder ohne Argumente) | Fähigkeitserkennung | Synchron | Nein | Top-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 |
| 2 | who_am_i | Fähigkeitserkennung | Synchron | Nein | Gibt die aktuelle Benutzeridentität + verfügbare Modelle und Parameterspezifikationen für jeden Generierungsbefehl zurück; zuerst in einer neuen Sitzung aufrufen |
| 3 | text_to_image <prompt> | Generierung | Asynchron | Ja | Text-zu-Bild, gibt generationId zurück; erfordert Abfrage von query_tasks (oder --poll für einstufiges Ergebnis) |
| 4 | `image_to_image --image <url | pfad> ` | Generierung | Asynchron | Ja |
| 5 | text_to_video <prompt> | Generierung | Asynchron | Ja | Text-zu-Video, gibt generationId zurück; erfordert Abfrage von query_tasks |
| 6 | `image_to_video [--image <url | pfad>] [prompt]` | Generierung | Asynchron | Ja |
| 7 | omni_ref_video <prompt> | Generierung | Asynchron | Ja | Mischt Bild-, Video-, Audio- oder Element-Referenzen; Typ gemäß Modelldeklaration, gibt generationId zurück |
| 8 | query_tasks <generationId> | Auftragsabfrage | Synchron | Ja | Fragt Generierungsstatus und endgültige Ressourcen-URLs (works[].url) nach generationId ab |
| 9 | file_upload <filePath> | Dateiupload | Synchron | Ja | Zweistufiger Upload (Ticket beantragen + Dateibytes hochladen), gibt öffentliche URL zurück |
| 10 | element_create | Subjektmaterial | Synchron | Ja | Erstellt wiederverwendbares Element aus Bildgruppe oder Video, gibt Element-ID zurück |
| 11 | element_list / element_get | Subjektmaterial | Synchron | Ja | Listet Elemente auf; ruft vollständige Typ- und Ressourcendetails nach ID ab |
| 12 | element_update / element_delete | Subjektmaterial | Synchron | Ja | Aktualisiert nach Feld oder löscht Element; primäres Bild wird vom CLI automatisch beibehalten |
| 13 | motion_library_list | Bewegungsmaterial | Synchron | Ja | Listet gespeicherte Bewegungen auf, liefert motionId und abspielbare URL |
| 14 | motion_control | Generierung | Asynchron | Ja | Generiert Video mit Subjektbild + Bewegungsvideo oder motionId, gibt generationId zurück |
| 15 | feedback | Feedback | Synchron | Ja | Meldet Hänger, obskure Fehler, Abrechnungsanomalien oder unerwartete Ergebnisse; ist nicht für Wiederholung/Rückerstattung/Reparatur zuständig |
| 16 | account | Kommerziell | Synchron | Ja | Mitgliedschaftstyp + verfügbare Credits (query_membership_and_credits, Identität aus JWT) |
| 17 | tool_list | Fähigkeitserkennung | Synchron | Nein | Listet 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) |
| 18 | login | Authentifizierung | Synchron | Nein (nur OAuth-Dienst) | Browser-OAuth-Anmeldung (DCR + PKCE), Token wird in lokale .credentials-Datei geschrieben |
| 19 | logout | Authentifizierung | Synchron | Ja | Ruft 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).
- 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. - 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. - Wie man Parameter an einen Befehl übergibt, erfahren Sie mit
kling <command> --help: Versucht bei Generierungsbefehlen, die Echtzeit-Modellparameter und Eingabeslots auswho_am_izu lesen; andere MCP-Befehle lesentools/list(Tool-Beschreibung + inputSchema); offline/nicht angemeldet Rückgriff auf lokale statische Nutzung. Vollständige Modelle und Parameter basieren dennoch aufwho_am_i. - Generierung muss explizit ein Modell auswählen:
text_to_image/image_to_image/text_to_video/image_to_video/omni_ref_video/motion_controlmüssen alle--model <Name>übergeben (aus derwho_am_i-Liste des entsprechenden Tools). Das CLI wählt nicht automatisch ein Standardmodell für den Benutzer;motion_controlzeigt 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. - 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_uploadhochgeladen; manuelles Hochladen ist nicht erforderlich. Öffentliche URLs (externes CDN / externer Link oder bereits von einer früheren Kling-Aufgabe zurückgegebeneworks[].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). - Nach dem Absenden sofort Feedback geben, dann abfragen: Entnehmen Sie
generationIdundcreditsConsumedaus der Antwort und informieren Sie den Benutzer zuerst. Fragen Sie dann mitkling query_tasks <generationId>nach, oder fügen Sie beim Absenden--poll [N]hinzu, um das Ergebnis in einem Schritt zu erhalten (rohes--pollstandardmäßig 60s,--poll 0deaktiviert die Inline-Abfrage). - 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. - Guthaben / Mitgliedschaft mit
accountanzeigen: Wenn das Guthaben nicht ausreicht, zeigen Sie den vom Server dynamisch zurückgegebenen Aufladungslink an (nicht fest codieren). - Bei Fehlern nicht automatisch Parameter ändern und erneut einreichen: Bei Parameterfehlern zeigen Sie dem Benutzer zuerst anhand von
who_am_idie 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_igibtavailableModelszurü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 versuchtkling <command> --help, bei Generierungsbefehlen die Echtzeit-Modellparameter und Eingabeslots auswho_am_izu lesen; andere MCP-Befehle lesentools/list(Tool-Beschreibung + inputSchema); offline oder nicht angemeldet Rückgriff auf lokale statische Nutzung. Die vollständige Modellliste und Parameterspezifikationen basieren dennoch aufwho_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 derwho_am_i-Liste des Befehls anhand des Namens oder Alias (alias) und übergeben Sie den zurückgegebenenmodel-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_imageoderimage_to_imagevorzugsweise Kling Image 4.0 aus, das die Anforderungen dieser Aufgabe erfüllt, und übergeben Sie explizit denmodel-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. Wennmotion_controlobligatorische 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äß
inputsundargumentsvonwho_am_idie 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
--pollden 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_ides 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
argumentsdes ausgewählten Modells Auflösung, Anzahl der Ausgabebilder und Generierungsmodus; überprüfen Sie gemäß deninputsdie 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 wieelementshinweg).image_to_video/omni_ref_videovalidiert 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)
| Nutzerabsicht | Befehl | Beschreibung |
|---|---|---|
| Fragen, was Kling kann / welche Fähigkeiten es gibt (keine spezifische Aufgabe) | who_am_i | Allgemeine 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 / Parameterspezifikationen | who_am_i | Direkt 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 ist | tool_list | Den Verwendungszweck der Tools basierend auf der tatsächlichen Serverantwort erläutern |
| Bild generieren / Bild erstellen / Text-zu-Bild | text_to_image | Nach dem Absenden query_tasks abfragen |
| Referenzbild-zu-Bild / mit Referenzbild | image_to_image | --image kann wiederholt werden; nach dem Absenden abfragen |
| Video generieren / Text-zu-Video | text_to_video | Nach dem Absenden abfragen |
| Bild-zu-Video / Bild animieren / Start-Mitte-Ende-Keyframes | image_to_video | Gemäß Modelldeklaration --image / --tailImage oder benanntes --input übergeben; Prompt-Optionalität gemäß Modelldeklaration; nach dem Absenden abfragen |
| Bild-, Video-, Audio-, Subjekt-Mischreferenz-Video generieren | omni_ref_video | Gemäß Modelldeklaration --image / --video / --audio / --elements übergeben; Prompt ist Pflicht; nach dem Absenden abfragen |
| Wiederverwendbares Subjekt erstellen / auflisten / anzeigen / aktualisieren / löschen | element_create / element_list / element_get / element_update / element_delete | Aktualisierung nur geänderte Felder übergeben; vor dem Löschen explizite Bestätigung vom Benutzer einholen |
| Bewegungssteuerung / Bewegungsübertragung | motion_control | Subjekt --image + --video oder --motionId (eines von beiden); nach dem Absenden abfragen |
| Gespeicherte Bewegungen anzeigen | motion_library_list | Nach Erhalt der motionId kann diese an motion_control übergeben werden |
| Hänger, obskure Fehler, Abrechnungsanomalien, unerwartete Ergebnisse melden | feedback | Nur Feedback; es wird nicht wiederholt, erstattet oder der ursprüngliche Auftrag repariert |
| Bestimmtes Modell oder Serie angeben | Befehl entsprechend der kreativen Absicht wählen, dann vollständiges --model übergeben | Mit der Echtzeit-Modellliste des entsprechenden Befehls den Namen oder Alias auflösen |
| Lokales Material hochladen | file_upload | Nur 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 abfragen | account | Gibt userId + membership + verfügbare Credits zurück (direkt anzeigen) |
| Persönlichen / Team-Arbeitsbereich abfragen oder auswählen | who_am_i → tool_list | Echtzeit-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ßen | account | Vom Server zurückgegebenen Aufladungs-/Mitgliedschaftslink anzeigen (dynamisch vom MCP bezogen, nicht fest codieren, siehe „Nicht ausreichendes Guthaben und Aufladen") |
| Abmelden / Aktuelles Konto verlassen | logout | Nach erfolgreichem MCP-Logout den lokalen Anmeldestatus löschen; bei Erfolg beenden, nicht automatisch erneut anmelden |
| Konto wechseln / Mit einem anderen Konto anmelden | logout → login → who_am_i | Muss 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 logoutaus. 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_iausführen. Nur nach erfolgreichemlogoutkann mitloginfortgefahren werden; bei der Browser-Autorisierung wählt der Benutzer das Zielkonto aus; nach erfolgreichem Login zeigen Sie mitwho_am_idie aktuelle Identität an und bestätigen sie. - Ein fehlgeschlagener
logoutmuss 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 mitloginfort. - Ein fehlgeschlagener
loginmuss sofort abgebrochen werden: Melden Sie den Anmeldefehler, fahren Sie nicht mitwho_am_ifort und verwenden Sie keine Cookies, Token-Einfüge- oder andere Autorisierungsmethoden. - Verwenden Sie nicht
loginals Ersatz für den Wechselvorgang:loginist 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 zuerstlogoutausgefü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
- 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 vonelement_createfü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. - Vor der Bindung Typ und Kompatibilität prüfen: Suchen Sie zuerst mit
element_listdie ID, dann rufen Sie mitelement_get <id>die vollständigenresource-Details ab und gleichen Sie gleichzeitig die Subjekt-Typ-Einschränkungen aus der Echtzeit-Tool-Beschreibung und die Modellparameter auswho_am_iab. Das Zielmodell musselementsdeklarieren; ein Bildsubjekt darf nicht allein aufgrund des Modellnamens (z. B.kling-image-o1) abgelehnt werden. Wenn das Modellelementsdeklariert, 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. - Bindungsschreibweise: Markieren Sie das Subjekt im Prompt mit
<<<id>>>und übergeben Sie gleichzeitig gemäß derwho_am_i-Deklaration--elements '[{"id":"<id>","bindName":"<name>","type":"<von element_get zurückgegebener Typ>"}]'. Es ist nicht erlaubt, nur Platzhalter zu setzen, aberelementszu vergessen, nochelementsan inkompatible Tools/Modelle zu übergeben. - 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 fehlenderelementIdzuerst zur Eingabe aufgefordert.