Zum Hauptinhalt springen
Dieser Artikel beschreibt eine Integrationsanleitung für die Kling Videos Generation API, die es ermöglicht, offizielle Kling-Videos durch Eingabe benutzerdefinierter Parameter zu generieren.

​
Antragsprozess

Um die API zu nutzen, müssen Sie zunächst auf die entsprechende Seite der Kling Videos Generation API gehen und den entsprechenden Dienst beantragen. Nach dem Betreten der Seite klicken Sie auf die Schaltfläche „Acquire“, wie im Bild gezeigt: Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach der Anmeldung werden Sie automatisch zur aktuellen Seite zurückgeleitet. Bei der ersten Antragstellung gibt es ein kostenloses Kontingent, das die kostenlose Nutzung der API ermöglicht.

​
Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen, indem Sie die Eingabeaufforderung prompt, die Generierungsaktion action, das Referenzbild der ersten Frame start_image_url und das Modell model eingeben, um das verarbeitete Ergebnis zu erhalten. Zuerst müssen Sie ein einfaches action-Feld übergeben, dessen Wert text2video ist. Es gibt hauptsächlich drei Aktionen: Text-zu-Video (text2video), Bild-zu-Video (image2video), Video erweitern (extend). Dann müssen wir auch das Modell model eingeben, das derzeit hauptsächlich die Modelle kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-video-o1 umfasst. Die spezifischen Inhalte sind wie folgt:

Hier sehen wir, dass wir die Request-Header festgelegt haben, 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 Nutzung der API, der nach der Beantragung direkt ausgewählt werden kann.
Zusätzlich haben wir den Request-Body festgelegt, einschließlich:
  • model: Das Modell zur Generierung des Videos, hauptsächlich kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-video-o1.
  • mode: Der Modus zur Generierung des Videos, hauptsächlich Standardmodus std und Hochgeschwindigkeitsmodus pro.
  • action: Die Aktion dieser Videoerzeugungsaufgabe, die hauptsächlich drei Aktionen umfasst: Text-zu-Video (text2video), Bild-zu-Video (image2video), Video erweitern (extend).
  • start_image_url: Wenn die Aktion Bild-zu-Video (image2video) gewählt wird, muss der Link zum Referenzbild der ersten Frame hochgeladen werden.
  • end_image_url: Optional beim Bild-zu-Video, um die letzte Frame anzugeben.
  • aspect_ratio: Das Seitenverhältnis des Videos, optional, unterstützt 16:9, 9:16, 1:1, standardmäßig 16:9.
  • cfg_scale: Die Stärke der Relevanz, Bereich [0,1], je größer, desto mehr entspricht es der Eingabeaufforderung.
  • camera_control: Optional, um die Bewegungsparameter der Kamera zu steuern, unterstützt Typ/Einfach-Voreinstellungen sowie horizontal, vertikal, schwenken, neigen, rollen, zoomen usw.
  • negative_prompt: Optional, unerwünschte negative Eingabeaufforderungen, maximal 200 Zeichen.
  • element_list: Referenzliste der Hauptobjekte, nur anwendbar auf das Modell kling-video-o1, die spezifische Verwendung dieses Parameters entnehmen Sie bitte der offiziellen Dokumentation.
  • video_list: Referenzvideo, über URL abrufbar, nur anwendbar auf das Modell kling-video-o1, die spezifische Verwendung dieses Parameters entnehmen Sie bitte der offiziellen Dokumentation.
  • prompt: Eingabeaufforderung.
  • callback_url: Die URL, an die das Ergebnis zurückgerufen werden soll.
Nach der Auswahl können Sie sehen, dass auf der rechten Seite auch 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, und wir erhalten folgendes Ergebnis: 
{
  "success": true,
  "video_id": "af9a1af0-9aa0-4638-81c1-d41d6143c508",
  "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7485378259/text2video/Cjil4mfBfs0AAAAAAKbMQQ-0_raw_video_1.mp4",
  "duration": "5.1",
  "state": "succeed",
  "task_id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0"
}
Die Rückgabe enthält mehrere Felder, die wie folgt beschrieben werden:
  • success: Der Status der Videoerzeugungsaufgabe.
  • task_id: Die ID der Videoerzeugungsaufgabe.
  • video_id: Die Video-ID der Videoerzeugungsaufgabe.
  • video_url: Der Link zum Video der Videoerzeugungsaufgabe.
  • duration: Die Dauer des Videos der Videoerzeugungsaufgabe.
  • state: Der Status der Videoerzeugungsaufgabe.
Wir sehen, dass wir die gewünschten Videoinformationen erhalten haben. Wir müssen nur die Video-URL aus dem data-Ergebnis abrufen, um das generierte Kling-Video zu erhalten. Wenn Sie den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren, zum Beispiel der CURL-Code ist wie folgt: 
curl -X POST 'https://api.acedata.cloud/kling/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "kling-v1",
  "prompt": "Weißer Keramikkaffeebecher auf glänzendem Marmorarbeitsplatz mit Morgenlicht durch das Fenster. Die Kamera dreht sich langsam 360 Grad um den Becher und hält kurz am Griff an."
}'

​
Erweiterte Video-Funktionalität

Wenn Sie ein bereits generiertes Kling-Video weiter generieren möchten, können Sie den Parameter action auf extend setzen und die ID des Videos eingeben, das Sie weiter generieren möchten. Die Video-ID kann gemäß der grundlegenden Nutzung abgerufen werden, wie im folgenden Bild gezeigt:

In diesem Fall sehen Sie, dass die Video-ID lautet: 
"video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c"
Hinweis: Hier ist die video_id im Video die ID des nach der Generierung erstellten Videos. Wenn Sie nicht wissen, wie man ein Video generiert, können Sie sich auf die grundlegende Nutzung im obigen Text beziehen, um ein Video zu generieren.
Als nächstes müssen wir die nächste Eingabeaufforderung ausfüllen, um das Video anzupassen, das wir weiter generieren möchten, und können die folgenden Inhalte angeben:
  • model：Das Modell zur Videoerstellung, hauptsächlich die Modelle kling-v1, kling-v1-5 und kling-v1-6.
  • mode：Der Modus zur Videoerstellung, hauptsächlich die Standardmodi std und der Hochgeschwindigkeitsmodus pro.
  • duration：Die Videolänge dieser Videoerstellungsaufgabe, hauptsächlich 5s und 10s.
  • start_image_url：Wenn die Bild-zu-Video-Aktion image2video ausgewählt wird, muss der Link zum Referenzbild des ersten Frames hochgeladen werden.
  • prompt：Eingabeaufforderung.
Beispiel zur Ausfüllung:

Nach dem Ausfüllen wird automatisch der folgende Code generiert:

Entsprechender Python-Code: 
import requests

url = "https://api.acedata.cloud/kling/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "extend",
    "model": "kling-v1",
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "prompt": "Weißer Keramikkaffeebecher auf glänzendem Marmorarbeitsplatz mit Morgenlicht durch das Fenster. Die Kamera dreht sich langsam 360 Grad um den Becher und hält kurz am Henkel an.",
    "duration": 10
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
Wenn Sie auf Ausführen klicken, können Sie ein Ergebnis wie folgt sehen: 
{
  "success": true,
  "video_id": "bbc3b105-ac72-4de2-8390-0cb37dc7d41e",
  "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/extendVideo/Cjil4mfBfs0AAAAAAKhr6A-0_raw_video_1.mp4",
  "duration": "9.6",
  "state": "succeed",
  "task_id": "3ece87e6-3ee3-4f5e-bd70-5ae5eca89a23"
}
Es ist zu erkennen, dass der Inhalt des Ergebnisses mit dem oben genannten übereinstimmt, was die Funktion zur Erweiterung des Videos ermöglicht.

​
Asynchrone Rückrufe

Da die Kling Videos Generation API relativ lange für die Erstellung benötigt, etwa 1-2 Minuten, bleibt die HTTP-Anfrage bei langer Nichtreaktion 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 Ablauf ist: Wenn der Client die Anfrage stellt, gibt er zusätzlich ein Feld callback_url an. Nach 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 von POST JSON an die vom Client angegebene callback_url gesendet, wobei auch das Feld task_id enthalten ist, sodass die Aufgabenresultate über die ID 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, 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, wie im Bild gezeigt:

Wenn Sie auf Ausführen klicken, erhalten Sie sofort ein Ergebnis wie folgt: 
{
  "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}
Nach kurzer Wartezeit können wir auf https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3 das Ergebnis des generierten Videos beobachten, wie im Bild gezeigt: Der Inhalt lautet: 
{
    "success": true,
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/text2video/CjJzzGfBfqcAAAAAAKdVMQ-0_raw_video_1.mp4",
    "duration": "5.1",
    "state": "succeed",
    "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}
Es ist zu sehen, dass das Ergebnis ein Feld task_id enthält, während die anderen Felder ähnlich wie oben sind. Über dieses Feld kann die Aufgabe verknüpft werden.

​
Fehlerbehandlung

Wenn beim Aufruf der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Informationen 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ültiger oder fehlender Autorisierungstoken.
  • 429 too_many_requests：Zu viele Anfragen, Sie haben das Rate-Limit überschritten.
  • 500 api_error：Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

​
Beispiel für eine Fehlerantwort

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die Kling Videos Generation API verwenden können, um Videos durch Eingabe von Eingabeaufforderungen und Referenzbildern des ersten Frames zu generieren. 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.