Skip to main content
Dieser Artikel beschreibt eine Integrationsanleitung für die Kling Motion Generation API, die es ermöglicht, offizielle Kling-Videos durch Eingabe benutzerdefinierter Parameter zu generieren.

​
Antragsprozess

Um die Kling Motion Generation API zu nutzen, müssen Sie zunächst Ihr API-Token im Ace Data Cloud Dashboard abrufen und für zukünftige Verwendung aufbewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie sich registrieren und anmelden können. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um es kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.
📘 Vollständige Dokumentation: Kling Motion Generation API →

​
Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen, indem Sie die Eingabeaufforderung prompt, die Referenzbild-URL image_url und den Referenzvideolink video_url eingeben, um das verarbeitete Ergebnis zu erhalten. Außerdem müssen wir das Modell mode eingeben, das derzeit hauptsächlich die Modelle std und pro umfasst, die spezifischen Inhalte sind wie folgt:

Hier haben wir die Request-Header festgelegt, einschließlich:
  • accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen als application/json, also im JSON-Format.
  • authorization: Der Schlüssel zur API, den Sie nach der Beantragung direkt auswählen können.
Zusätzlich haben wir den Request-Body festgelegt, einschließlich:
  • image_url: URL des Referenzbildes für das Aussehen der Person. Unterstützt JPG/JPEG/PNG, Datei ≤50MB, Breite und Höhe jeweils ≥300px, Seitenverhältnis 1:2.5 bis 2.5:1; die Person sollte klar im Oberkörper oder ganzkörperlich sowie im Kopfbereich sichtbar sein.
  • video_url: URL des Referenzvideos für die Bewegung. Unterstützt MP4/MOV, Datei ≤100MB, Breite und Höhe jeweils 340–3850px, mindestens 3 Sekunden; bei character_orientation=image maximal 10 Sekunden, bei character_orientation=video maximal 30 Sekunden. Es wird empfohlen, ein kontinuierliches Einzelbildvideo zu verwenden, in dem die Person immer im Bild ist.
  • mode: Der Modus zur Videoerstellung, hauptsächlich gibt es den Standardmodus std und den Hochgeschwindigkeitsmodus pro.
  • keep_original_sound: Wählen Sie, ob der Originalton des Videos beibehalten werden soll, Enumerationswerte: yes, no.
  • character_orientation: Die Ausrichtung der Person im generierten Video, wählbar zwischen Bild oder Video, Enumerationswerte: image, video.
  • prompt: Eingabeaufforderung.
  • callback_url: Die URL, an die das Ergebnis zurückgerufen werden soll.
  • async: Optional, wenn auf true gesetzt, gibt die Schnittstelle sofort task_id zurück, ohne dass callback_url bereitgestellt werden muss, und anschließend kann das Ergebnis über die entsprechende Task-Abfrage-Schnittstelle abgefragt werden.
Nach der Auswahl können Sie sehen, dass auf der rechten Seite der entsprechende Code generiert wurde, wie im Bild gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen. Wie im obigen Bild gezeigt, haben wir folgendes Ergebnis erhalten:
Die Rückgabe hat mehrere Felder, die wie folgt beschrieben werden:
  • success, der Status des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • task_id, die ID des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • video_id, die Video-ID des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • video_url, der Video-Link des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • duration, die Dauer des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • state, der Status des Videoerstellungsauftrags zu diesem Zeitpunkt.
Wir können sehen, dass wir die gewünschten Videoinformationen erhalten haben. Wir müssen nur die Video-URL aus dem Ergebnis data abrufen, um das generierte Kling-Video zu erhalten. Wenn Sie den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren, zum Beispiel sieht der CURL-Code wie folgt aus:

​
Asynchrone Rückrufe

Da die Generierung durch die Kling Motion Generation API relativ lange dauert, etwa 1-2 Minuten, bleibt die HTTP-Anfrage bei langer Nichtantwort verbunden, was zu einem zusätzlichen Verbrauch von Systemressourcen führt. Daher bietet diese API auch Unterstützung für asynchrone Rückrufe. Der gesamte Prozess ist: Wenn der Client die Anfrage initiiert, gibt er zusätzlich ein Feld callback_url an. Nach der Initiierung der API-Anfrage gibt die API sofort ein Ergebnis zurück, das ein Feld task_id enthält, das die aktuelle Aufgaben-ID darstellt. Wenn die Aufgabe abgeschlossen ist, wird das Ergebnis des generierten Videos in Form eines POST-JSON an die vom Client angegebene callback_url gesendet, wobei auch das Feld task_id enthalten ist, sodass die Aufgabenergebnisse über die ID miteinander verknüpft werden können. Lassen Sie uns anhand eines Beispiels verstehen, wie dies konkret funktioniert. Zunächst ist der Webhook-Rückruf ein Dienst, der HTTP-Anfragen empfangen kann. Entwickler sollten die URL ihres eigenen HTTP-Servers ersetzen. Zur Vereinfachung der Demonstration verwenden wir eine öffentliche Webhook-Beispielwebsite https://webhook.site/, auf der Sie eine Webhook-URL erhalten können, wie im Bild gezeigt: Kopieren Sie diese URL, um sie als Webhook zu verwenden. Das Beispiel hier lautet https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3. Als Nächstes können wir das Feld callback_url auf die oben genannte Webhook-URL setzen und die entsprechenden Parameter eingeben, die spezifischen Inhalte sind wie im Bild gezeigt:

Klicken Sie auf Ausführen, und Sie werden sofort ein Ergebnis erhalten, wie folgt:
Warten Sie einen Moment, und Sie können das Ergebnis des generierten Videos unter https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3 beobachten, wie im Bild gezeigt: Inhalt wie folgt:
Man kann sehen, dass im Ergebnis ein task_id-Feld vorhanden ist, die anderen Felder sind ähnlich wie oben beschrieben. Über dieses Feld kann die Aufgabe verknüpft werden.

​
Fehlerbehandlung

Beim Aufrufen der API, wenn ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Information zurück. Zum Beispiel:
  • 400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
  • 400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
  • 401 invalid_token: Nicht autorisiert, ungültiges oder fehlendes Autorisierungstoken.
  • 429 too_many_requests: Zu viele Anfragen, Sie haben das Ratenlimit überschritten.
  • 500 api_error: Interner Serverfehler, auf dem Server ist etwas schiefgelaufen.

​
Beispiel für eine Fehlerantwort

​
Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die Kling Motion Generation API verwenden, um die offizielle Bewegungssteuerungsfunktion von Kling zu realisieren. Wir hoffen, dass dieses Dokument Ihnen hilft, die API besser zu integrieren und zu nutzen. Bei Fragen wenden Sie sich bitte jederzeit an unser technisches Support-Team.