Kling Videos Generation API Integrationsanleitung

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 Kling Videos Generation API zu nutzen, gehen Sie zuerst zur Ace Data Cloud Konsole, um Ihr API-Token zu erhalten und für zukünftige Verwendung aufzubewahren.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, die Sie zur Registrierung und Anmeldung einlädt. 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 nicht ausreicht, können Sie im Dashboard Ihr Guthaben aufladen.

📘 Vollständige Dokumentation: Kling Videos Generation API →

Grundlegende Nutzung

Zuerst sollten Sie die grundlegende Nutzung verstehen, indem Sie den Eingabewort 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 umfasst 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-v2-6, kling-v3, kling-v3-omni, kling-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 API, den Sie nach der Beantragung direkt auswählen können.

Außerdem 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-v2-6, kling-v3, kling-v3-omni, kling-o1.
mode: Der Modus zur Generierung des Videos, wählbare Werte sind Standardmodus std, Hochgeschwindigkeitsmodus pro und nativer 4K-Modus 4k. Der 4k-Modus unterstützt nur kling-v3 und kling-v3-omni und ist nicht mit camera_control (Kamerasteuerung) kompatibel.
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.
duration: Die Videolänge, Einheit Sekunden. kling-v3 und kling-v3-omni unterstützen eine ganzzahlige Dauer von 3-15 Sekunden; kling-o1 unterstützt nur 5 Sekunden; andere Modelle unterstützen 5 oder 10 Sekunden.
generate_audio: Ob Audio synchron generiert werden soll, optional, boolescher Wert. Unterstützt kling-v3, kling-v3-omni und kling-v2-6 (nur im Pro-Modus). Standardmäßig auf false.
aspect_ratio: Das Seitenverhältnis des Videos, optional, unterstützt 16:9, 9:16, 1:1, standardmäßig 16:9.
cfg_scale: Stärke der Relevanz, Bereich [0,1], je größer, desto mehr entspricht es dem Eingabewort.
camera_control: Optional, Parameter zur Steuerung der Kamerabewegung, unterstützt Typ/Einfach-Voreinstellungen sowie horizontal, vertikal, schwenken, neigen, rollen, zoomen usw.
negative_prompt: Optional, unerwünschte negative Eingabewörter, maximal 200 Zeichen.
image_list: Omni-Referenzbildliste, geeignet für die Modelle kling-o1 und kling-v3-omni, siehe unten „Omni-Alleskönner-Referenz“.
video_list: Omni-Referenzvideoliste (unterstützt Videobearbeitung), geeignet für die Modelle kling-o1 und kling-v3-omni, siehe unten „Omni-Alleskönner-Referenz“.
prompt: Eingabewort.
callback_url: URL, an die die Ergebnisse zurückgegeben werden sollen.
async: Optional, wenn auf true gesetzt, gibt die Schnittstelle sofort task_id zurück, ohne dass callback_url bereitgestellt werden muss, und die Ergebnisse können dann über die entsprechende Aufgabenabfrage-Schnittstelle abgefragt werden.

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, haben wir folgendes Ergebnis erhalten:

{
  "success": true,
  "video_id": "900798310464749610",
  "video_url": "https://platform2.cdn.acedata.cloud/kling/6c68c267-065b-4423-b66b-a0e4c59ee0d5.mp4",
  "duration": "5.041",
  "state": "succeed",
  "task_id": "6c68c267-065b-4423-b66b-a0e4c59ee0d5"
}

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 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 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-v3",
  "prompt": "Weißer Keramikkaffeebecher auf glänzendem Marmorarbeitsplatte mit Morgenlicht vom Fenster. Die Kamera dreht sich langsam 360 Grad um den Becher und hält kurz am Griff an."
}'

Modellfähigkeitsmatrix

Die Unterstützung der Parameter variiert stark zwischen den verschiedenen Modellen. Die folgende Matrix wurde aus der Kling offiziellen Video-Modelle-Dokumentation zusammengestellt. Bitte überprüfen Sie vor dem Aufruf, ob die aktuelle Kombination von model / mode / duration die benötigten Funktionen unterstützt, andernfalls wird ein Fehler wie model/mode/duration(...) is not supported with image_tail zurückgegeben.

Modell	Modus	`end_image_url` (Endbild)	`generate_audio` (Audio)	`camera_control` (Kamerasteuerung)	Anmerkungen
`kling-v1`	std / pro	✅ nur `duration=5`	❌	✅ nur `duration=5`	`extend` unterstützt kein `negative_prompt` und `cfg_scale`
`kling-v1-6`	std	❌	❌	❌	Mehrere Bilder zu Video, `extend` in allen Modi verfügbar
`kling-v1-6`	pro	✅	❌	❌
`kling-v2-master`	—	❌	❌	❌	Einzelner Modus, nur `duration=5/10`
`kling-v2-1-master`	—	❌	❌	❌	Einzelner Modus, nur `duration=5/10`
`kling-v2-5-turbo`	std	❌	❌	❌
`kling-v2-5-turbo`	pro	✅	❌	❌
`kling-v2-6`	std	❌	❌	❌
`kling-v2-6`	pro	✅	✅	❌	Das einzige nicht v3 Modell, das gleichzeitig Audio unterstützt
`kling-v3`	std / pro	✅	✅	✅	`duration` Bereich 3–15 Sekunden
`kling-v3`	4k	✅	✅	❌	4K-Modus nicht kompatibel mit Kamerasteuerung
`kling-v3-omni`	std / pro / 4k	✅	✅	❌
`kling-o1`	std / pro	✅	❌	❌	Unterstützt nur `duration=5`

Hinweise:

mode=4k wird nur von kling-v3 und kling-v3-omni unterstützt; und ist inkompatibel mit camera_control.
end_image_url kann nur in Verbindung mit start_image_url bei action=image2video verwendet werden. Nur end_image_url (ohne start_image_url) wird abgelehnt.
kling-v3 / kling-v3-omni akzeptieren beliebige ganze Zahlen für duration zwischen 3–15 Sekunden; kling-o1 akzeptiert nur 5; andere Modelle akzeptieren nur 5 oder 10.
generate_audio ist standardmäßig false. Nur kling-v3, kling-v3-omni und kling-v2-6 (pro Modus) unterstützen dies.

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 wird basierend auf der grundlegenden Nutzung wie im folgenden Bild gezeigt abgerufen:

In diesem Fall sehen Sie, dass die Video-ID lautet:

"video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c"

Hinweis: Hier ist die video_id die ID des generierten Videos. Wenn Sie nicht wissen, wie man ein Video generiert, können Sie sich auf die grundlegende Nutzung im obigen Text beziehen.

Als nächstes müssen wir die nächsten Schritte ausfüllen, um die Eingabeaufforderungen für die benutzerdefinierte Videoerstellung zu erweitern, und können die folgenden Inhalte angeben:

model: Das Modell zur Videoerstellung, hauptsächlich kling-v1, kling-v1-5 und kling-v1-6.
mode: Der Modus zur Videoerstellung, wählbare Werte sind Standardmodus std, Hochgeschwindigkeitsmodus pro und nativer 4K-Modus 4k (nur kling-v3 und kling-v3-omni unterstützt, inkompatibel mit Kamerasteuerung).
duration: Die Videolänge dieser Videoerstellungsaufgabe, hauptsächlich 5s und 10s.
start_image_url: Wenn der Bild-zu-Video-Vorgang image2video ausgewählt wird, muss ein Link zum Referenzbild des ersten Frames hochgeladen werden.
prompt: Eingabeaufforderung.

Ein Beispiel für die Eingabe sieht wie folgt aus:

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 Marmorarbeitsplatte mit Morgenlicht vom Fenster. Die Kamera dreht sich langsam 360 Grad um die Tasse 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://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.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 Erweiterungsfunktion für Videos ermöglicht.

Omni All-in-One Referenz (Video-Bearbeitung / Referenzvideo / Mehrbildreferenz)

kling-o1 und kling-v3-omni sind zwei unabhängige Modelle, die beide die Fähigkeit zur „All-in-One-Referenz“ unterstützen. Basierend auf der Text-zu-Video-Funktion (action=text2video) können zusätzlich Referenzbilder oder Referenzvideos übergeben werden, um Mehrbildreferenzen, Referenzvideos und die direkte Bearbeitung vorhandener Videos zu ermöglichen. Kernvereinbarung: Referenzmaterialien müssen im prompt in der Form <<<image_1>>>, <<<video_1>>> (Nummerierung beginnt bei 1) zitiert werden, um auf die entsprechenden Materialien in image_list / video_list zuzugreifen, damit das Modell diese Referenzen anwendet. Wenn nur Materialien übergeben werden, ohne sie in der Eingabeaufforderung zu zitieren, werden sie ignoriert.

Sicherheitshinweis: Derzeit ist die API für element_list nicht geöffnet. Die IDs der Kling Element Library sind nicht mandantenspezifisch. Bitte verwenden Sie image_list, um Hauptreferenzbilder zu übergeben, bis eine mandantenspezifische Element Management API bereitgestellt wird.

Omni-Anfragen unterstützen kein negative_prompt, cfg_scale oder camera_control und können mode=4k nicht verwenden. Wenn Referenzvideos enthalten sind, muss generate_audio auf false gesetzt sein. video_list wird verwendet, um Referenzvideos zu übergeben, und ist das am häufigsten verwendete Szenario dieser Funktion. Die Felder der Array-Elemente sind wie folgt:

video_url: Referenzvideolink, darf nicht leer sein. Maximal 1 MP4/MOV-Video, Dateigröße ≤200MB, Bildrate 24–60fps. kling-o1 erfordert eine Dauer von 3–10 Sekunden, Breite und Höhe jeweils 700–2160px; kling-v3-omni erfordert eine Dauer von 3–15,5 Sekunden, Breite und Höhe jeweils 700–4553px, Gesamtpixel ≤8.294.400, Seitenverhältnis 0,4–2.
refer_type: Referenztyp, optional base (Standard, Basisvideo zum Bearbeiten, d.h. “direkte Bearbeitung des Videos”, Elemente können hinzugefügt, entfernt oder geändert werden, Komposition, Stil, Farbe, Wetter usw. geändert werden) oder feature (Merkmalsreferenz, Bezug auf Stil / Kameraführung / Fortsetzung der nächsten Aufnahme).
keep_original_sound: Ob der Originalton des Videos beibehalten werden soll, optional yes (beibehalten) oder no (entfernen).

Hinweis: Wenn ein Referenzvideo vorhanden ist, muss generate_audio auf false gesetzt werden. Videos mit refer_type=base dürfen keine Start- / Endbilder mehr spezifizieren.

Beispiel für CURL zur Bearbeitung eines vorhandenen Videos (Ändern des Videos in einen Anime-Stil):

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-o1",
  "mode": "std",
  "duration": 5,
  "prompt": "Ändere <<<video_1>>> in einen filmreifen Anime-Stil, behalte die vorhandene Bewegung und Komposition bei",
  "video_list": [
    {
      "video_url": "https://cdn.acedata.cloud/your-reference-video.mp4",
      "refer_type": "base",
      "keep_original_sound": "no"
    }
  ]
}'

Mehrfachbildreferenz (`image_list`)

image_list wird verwendet, um Referenzbilder (Elemente / Szenen / Stile usw.) zu übergeben, die Felder der Array-Elemente sind wie folgt:

image_url: Referenzbildlink, darf nicht leer sein. Anforderungen: Format .jpg/.jpeg/.png; Dateigröße ≤10MB; kürzeste Seite ≥300px; Seitenverhältnis 1:2,5 ~ 2,5:1.
type: Optional. Wenn nicht übergeben, wird es als reines Referenzbild betrachtet; bei Angabe von first_frame / end_frame wird es jeweils als Start- / Endbild verwendet (entspricht start_image_url / end_image_url).

Bei der Verwendung muss im prompt auf <<<image_1>>>, <<<image_2>>> verwiesen werden. Mengenbeschränkung: Wenn kein Referenzvideo vorhanden ist, sind Referenzbilder ≤ 7; wenn ein Referenzvideo vorhanden ist, sind Referenzbilder ≤ 4. Wenn nur Start- / Endbilder übergeben werden, können auch direkt start_image_url / end_image_url verwendet werden, aber das Endbild muss zusammen mit dem Startbild verwendet werden.

Hinweis: Wenn sowohl start_image_url / end_image_url als auch image_list übergeben werden, werden Start- / Endbilder vor image_list angeordnet, was die Zuordnung von <<<image_N>>> beeinflussen kann. Es wird empfohlen, sich für eines zu entscheiden: Wenn Start- / Endbilder benötigt werden, sollten diese direkt in image_list mit type angegeben werden, nicht in Kombination mit start_image_url / end_image_url.

Beispiel für CURL zur Videoerzeugung mit Mehrfachbildreferenz:

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-o1",
  "mode": "std",
  "duration": 5,
  "prompt": "Lass die Figur in <<<image_1>>> in der Szene von <<<image_2>>> stehen, filmische Lichtstimmung",
  "image_list": [
    { "image_url": "https://cdn.acedata.cloud/subject.png" },
    { "image_url": "https://cdn.acedata.cloud/scene.png" }
  ]
}'

Asynchrone Rückrufe

Da die von der Kling Videos Generation API erzeugte Zeit relativ lang ist, etwa 1-2 Minuten, wird die HTTP-Anfrage bei längerer Nichtreaktion der API die Verbindung aufrechterhalten, was zu einem zusätzlichen Systemressourcenverbrauch führt. Daher bietet diese API auch Unterstützung für asynchrone Rückrufe. Der gesamte Ablauf ist: Der Client initiiert die Anfrage und gibt zusätzlich ein callback_url-Feld an. Nach der Initiierung der API-Anfrage gibt die API sofort ein Ergebnis zurück, das ein task_id-Feld enthält, das die aktuelle Aufgaben-ID darstellt. Wenn die Aufgabe abgeschlossen ist, werden die Ergebnisse des generierten Videos in Form von POST JSON an die vom Client angegebene callback_url gesendet, wobei auch das task_id-Feld enthalten ist, sodass die Aufgabenergebnisse über die ID verknüpft werden können. Hier ist ein Beispiel, um zu verstehen, wie man konkret vorgeht. Zunächst ist der Webhook-Rückruf ein Dienst, der HTTP-Anfragen empfangen kann. Entwickler sollten ihn durch die URL ihres eigenen HTTP-Servers ersetzen. Hier wird zur Demonstration eine öffentliche Webhook-Beispielwebsite https://webhook.site/ verwendet. Wenn Sie diese Website öffnen, erhalten Sie eine Webhook-URL, wie im Bild gezeigt:

Kopieren Sie diese URL, um sie als Webhook zu verwenden. In diesem Beispiel lautet die URL 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 ausfüllen, wie im Bild gezeigt:

Klicken Sie auf Ausführen, und Sie werden sofort ein Ergebnis erhalten, wie folgt:

{
  "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}

Warten Sie einen Moment, und Sie können die Ergebnisse des generierten Videos unter https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3 beobachten, wie im Bild gezeigt:

Der Inhalt lautet:

{
    "success": true,
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
    "duration": "5.1",
    "state": "succeed",
    "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}

Es ist zu sehen, dass im Ergebnis ein task_id-Feld vorhanden ist, und die anderen Felder sind ähnlich wie oben beschrieben. Ü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: Unbefugt, ungültiger oder fehlender Autorisierungstoken.
429 too_many_requests: Zu viele Anfragen, Sie haben das Kontingent überschritten.
500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

Beispiel für eine Fehlerantwort

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

Schlussfolgerung

Durch dieses Dokument haben Sie gelernt, wie Sie die Kling Videos Generation API nutzen können, um Videos durch Eingabe von Stichwörtern und einem Referenzbild 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.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Proxy

Erweitert

Coding

Kling Videos Generation API Integrationsanleitung

Antragsprozess

Grundlegende Nutzung

Modellfähigkeitsmatrix

Erweiterte Video-Funktionalität

Omni All-in-One Referenz (Video-Bearbeitung / Referenzvideo / Mehrbildreferenz)

Mehrfachbildreferenz (`image_list`)

Asynchrone Rückrufe

Fehlerbehandlung

Beispiel für eine Fehlerantwort

Schlussfolgerung

​Antragsprozess

​Grundlegende Nutzung

​Modellfähigkeitsmatrix

​Erweiterte Video-Funktionalität

​Omni All-in-One Referenz (Video-Bearbeitung / Referenzvideo / Mehrbildreferenz)

​Referenzvideo und Video-Bearbeitung (video_list)

​Mehrfachbildreferenz (image_list)

​Asynchrone Rückrufe

​Fehlerbehandlung

​Beispiel für eine Fehlerantwort

​Schlussfolgerung

Antragsprozess

Grundlegende Nutzung

Modellfähigkeitsmatrix

Erweiterte Video-Funktionalität

Omni All-in-One Referenz (Video-Bearbeitung / Referenzvideo / Mehrbildreferenz)

Referenzvideo und Video-Bearbeitung (`video_list`)

Mehrfachbildreferenz (`image_list`)

Asynchrone Rückrufe

Fehlerbehandlung

Beispiel für eine Fehlerantwort

Schlussfolgerung