Antragsprozess
Um die Kling Videos Generation API zu verwenden, rufen Sie zunächst die Ace Data Cloud-Konsole auf, um Ihren API-Token zu erhalten und ihn für später aufzubewahren.
Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie zur Registrierung und Anmeldung aufgefordert werden. Nach Abschluss kehren Sie automatisch zu dieser Seite zurück.
Ein API-Token kann alle Dienste der Plattform aufrufen, ohne dass für jeden Dienst ein separater Antrag erforderlich ist. Bei der ersten Beantragung erhalten Sie kostenlose Kontingente zur kostenlosen Nutzung; bei unzureichendem Kontingent können Sie das allgemeine Guthaben in der Konsole aufladen.
📘 Vollständige Dokumentation: Kling Videos Generation API →
Grundlegende Verwendung
Lernen wir zunächst die grundlegende Verwendung kennen: Geben Sie einfach den Promptprompt, die Generierungsaktion action, das Referenzbild des ersten Frames start_image_url sowie das Modell model ein, um das verarbeitete Ergebnis zu erhalten. Zunächst müssen Sie einfach ein Feld action übergeben, dessen Wert text2video ist. Es umfasst hauptsächlich drei Aktionen: Text-zu-Video (text2video), Bild-zu-Video (image2video) und Video-Erweiterung (extend). Anschließend müssen wir auch das Modell model eingeben. Derzeit gibt es 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; die konkreten Inhalte sind wie folgt:

accept: Welches Format des Antwortergebnisses empfangen werden soll; hier wirdapplication/jsoneingetragen, also das JSON-Format.authorization: Der Schlüssel zum Aufrufen der API, der nach der Beantragung direkt über ein Dropdown ausgewählt werden kann.
model: Das Modell zur Generierung von Videos, hauptsächlich die Modellekling-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 von Videos; optionale Werte sind Standardmodusstd, Schnellmoduspround nativer 4K-Modus4k. Dabei unterstützt4knurkling-v3undkling-v3-omniund ist nicht kompatibel mitcamera_control(Kamerabewegungssteuerung).action: Die Aktion dieser Video-Generierungsaufgabe, die hauptsächlich drei Aktionen umfasst: Text-zu-Video (text2video), Bild-zu-Video (image2video) und Video-Erweiterung (extend).start_image_url: Der Link zum Referenzbild des ersten Frames, das hochgeladen werden muss, wenn die Bild-zu-Video-Aktionimage2videoausgewählt wird.end_image_url: Optional bei Bild-zu-Video, legt den letzten Frame fest.duration: Videodauer in Sekunden.kling-v3undkling-v3-omniunterstützen ganzzahlige Dauern von 3–15 Sekunden;kling-o1unterstützt nur 5 Sekunden; andere Modelle unterstützen 5 oder 10 Sekunden.generate_audio: Ob Audio synchron generiert werden soll, optional, boolescher Wert. Unterstütztkling-v3,kling-v3-omnisowiekling-v2-6(nur im Pro-Modus). Der Standardwert istfalse.aspect_ratio: Seitenverhältnis des Videos, optional, unterstützt16:9,9:16,1:1, Standard ist16:9.cfg_scale: Stärke der Relevanz, Bereich [0,1]; je größer, desto besser passt es zum Prompt.camera_control: Optionaler Objektparameter zur Steuerung der Kamerabewegung, unterstützt die Voreinstellungen type/simple sowie Konfigurationen wie horizontal, vertical, pan, tilt, roll, zoom.negative_prompt: Optionaler negativer Prompt für Inhalte, die nicht erscheinen sollen, maximal 200 Zeichen.image_list: Omni-Referenzbildliste, geeignet für die Modellekling-o1undkling-v3-omni; zur Verwendung siehe unten „Omni-Allzweckreferenz“.video_list: Omni-Referenzvideoliste (unterstützt Videobearbeitung), geeignet für die Modellekling-o1undkling-v3-omni; zur Verwendung siehe unten „Omni-Allzweckreferenz“.prompt: Prompt.callback_url: Die URL, an die das Ergebnis zurückgerufen werden soll.async: Optional; wenn auftruegesetzt, gibt die Schnittstelle soforttask_idzurück. Es ist nicht erforderlich,callback_urlbereitzustellen; anschließend wird das Ergebnis durch Abfragen über die entsprechende Aufgabenabfrageschnittstelle abgerufen.

success: Der Status der Video-Generierungsaufgabe zu diesem Zeitpunkt.task_id: Die ID der Video-Generierungsaufgabe zu diesem Zeitpunkt.video_id: Die Video-ID der Video-Generierungsaufgabe zu diesem Zeitpunkt.video_url: Der Videolink der Video-Generierungsaufgabe zu diesem Zeitpunkt.duration: Die Dauer des Videolinks der Video-Generierungsaufgabe zu diesem Zeitpunkt.state: Der Status der Video-Generierungsaufgabe zu diesem Zeitpunkt.
data im Ergebnis abrufen.
Wenn Sie außerdem den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren. Der CURL-Code lautet beispielsweise wie folgt:
Modellfähigkeitsmatrix
Die Unterstützung von Parametern unterscheidet sich je nach Modell erheblich. Die folgende Matrix wurde aus der offiziellen Kling-Dokumentation zu Video-Modellen zusammengestellt. Bitte überprüfen Sie vor dem Aufruf, ob die aktuelle Kombination ausmodel / mode / duration die von Ihnen benötigte Funktion unterstützt, andernfalls werden Fehler wie model/mode/duration(...) is not supported with image_tail zurückgegeben.
Hinweise:
mode=4kwird nur vonkling-v3undkling-v3-omniunterstützt; außerdem schließt es sich mitcamera_control(Kameraführung) gegenseitig aus.end_image_urlkann nur beiaction=image2videozusammen mitstart_image_urlverwendet werden. Das alleinige Übergeben vonend_image_url(ohnestart_image_url) wird abgelehnt.kling-v3/kling-v3-omniakzeptieren jede ganzzahligedurationvon 3–15 Sekunden;kling-o1akzeptiert nur 5; die übrigen Modelle akzeptieren nur 5 oder 10.generate_audioist standardmäßigfalse. Es wird nur vonkling-v3,kling-v3-omniundkling-v2-6(Pro-Modus) unterstützt.
Funktion zur Videoerweiterung
Wenn Sie ein bereits generiertes Kling-Video weiter generieren möchten, können Sie den Parameteraction auf extend setzen und die ID des Videos eingeben, das weiter generiert werden soll. Die Video-ID wird anhand der grundlegenden Verwendung abgerufen, wie in der folgenden Abbildung dargestellt:

Beachten Sie, dass video_id im Video hier die ID des generierten Videos ist. Wenn Sie nicht wissen, wie man ein Video generiert, können Sie sich auf die grundlegende Verwendung oben beziehen, um ein Video zu generieren.
Als Nächstes müssen wir unbedingt den Hinweistext ausfüllen, der im nächsten Schritt erweitert werden soll, um die Videogenerierung anzupassen. Dann können die folgenden Inhalte angegeben werden:
model: Das Modell zur Videogenerierung, hauptsächlich die Modellekling-v1,kling-v1-5undkling-v1-6.mode: Der Modus zur Videogenerierung; mögliche Werte sind der Standardmodusstd, der Schnellmoduspround der native 4K-Modus4k(nur vonkling-v3undkling-v3-omniunterstützt, nicht kompatibel mit Kameraführungssteuerung).duration: Die Videodauer dieser Videogenerierungsaufgabe, hauptsächlich 5 s und 10 s.start_image_url: Beim Auswählen der Bild-zu-Video-Aktionimage2videoist der Link zum hochzuladenden Referenzbild des Anfangsbildes erforderlich.prompt: Hinweistext.


Omni-Universalreferenz (Videobearbeitung / Referenzvideo / Mehrbildreferenz)
kling-o1 und kling-v3-omni sind zwei unabhängige Modelle, die beide die Fähigkeit der „Universalreferenz“ unterstützen. Auf Grundlage von Text-zu-Video (action=text2video) können zusätzlich Referenzbilder oder Referenzvideos übergeben werden, um Mehrbildreferenzen, Referenzvideos sowie die direkte Bearbeitung vorhandener Videos zu ermöglichen.
Kernvereinbarung: Referenzmaterial muss im prompt in der Form <<<image_1>>>, <<<video_1>>> (die Nummerierung beginnt bei 1) referenziert werden, um das Material an der entsprechenden Position in image_list / video_list zu verwenden; nur dann wendet das Modell diese Referenzen an. Wenn nur Material übergeben wird, ohne es im Hinweistext zu referenzieren, wird das Material ignoriert.
Sicherheitshinweis: Die aktuelle API stelltOmni-Anfragen unterstützen wederelement_listnicht bereit. Die IDs der Kling Element Library sind nicht mandantenisoliert; verwenden Sie vor der Bereitstellung einer mandantenisolierten Element-Management-API bitteimage_list, um Referenzbilder des Subjekts zu übergeben.
negative_prompt, cfg_scale noch camera_control und können auch nicht mode=4k verwenden. Wenn Referenzvideos enthalten sind, muss generate_audio auf false gesetzt sein.
Referenzvideo und Videobearbeitung (video_list)
video_list wird zur Übergabe von Referenzvideos verwendet und ist das häufigste Anwendungsszenario dieser Funktion. Die Felder der Array-Elemente sind wie folgt:
video_url: Link zum Referenzvideo, darf nicht leer sein. Maximal 1 MP4/MOV-Video, Dateigröße ≤200MB, Bildrate 24–60fps.kling-o1erfordert eine Dauer von 3–10 Sekunden sowie Breite und Höhe jeweils von 700–2160px;kling-v3-omnierfordert eine Dauer von 3–15,5 Sekunden, Breite und Höhe jeweils von 700–4553px, Gesamtpixel ≤8.294.400 und ein Seitenverhältnis von 0,4–2.refer_type: Referenztyp, optionalbase(Standard, zu bearbeitendes Basisvideo, d. h. „das Video direkt bearbeiten“, Elemente können hinzugefügt/entfernt/geändert, die Komposition, der Stil, die Farben, das Wetter usw. geändert werden) oderfeature(Merkmalsreferenz, deren Stil / Kameraführung / Fortsetzung der nächsten Aufnahme referenziert wird).keep_original_sound: Ob das Originalaudio des Videos beibehalten werden soll, optionalyes(beibehalten) oderno(entfernen).
Hinweis: Wenn ein Referenzvideo vorhanden ist, mussEin CURL-Beispiel für die Bearbeitung eines vorhandenen Videos (Ändern des Videos in einen Anime-Stil) lautet wie folgt:generate_audioauffalsegesetzt sein. Für Videos mitrefer_type=basedürfen keine Start- / Endframes angegeben werden.
Mehrbildreferenz (image_list)
image_list wird zur Übergabe von Referenzbildern (Elemente / Szenen / Stile usw.) verwendet. Die Felder der Array-Elemente sind wie folgt:
image_url: Link zum Referenzbild, 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. Ohne Übergabe wird es als reines Referenzbild verwendet; bei Übergabe vonfirst_frame/end_framewird es jeweils als Startframe / Endframe verwendet (entsprichtstart_image_url/end_image_url).
prompt mit <<<image_1>>>, <<<image_2>>> darauf verwiesen werden. Mengenbegrenzung: Ohne Referenzvideo sind ≤ 7 Referenzbilder möglich; mit Referenzvideo sind ≤ 4 Referenzbilder möglich. Wenn nur Start- / Endframes übergeben werden, können auch direkt start_image_url / end_image_url verwendet werden, aber der Endframe muss zusammen mit dem Startframe verwendet werden.
Hinweis: Wenn gleichzeitigCURL-Beispiel für die Generierung eines Videos mit Mehrbildreferenz:start_image_url/end_image_urlundimage_listübergeben werden, werden die Start- / Endframes vorimage_listangeordnet, was die Zuordnung der Nummerierung von<<<image_N>>>beeinflussen kann. Es wird empfohlen, eine der beiden Optionen zu wählen: Wenn Start- / Endframes benötigt werden, geben Sie sie direkt übertypeinimage_listan und mischen Sie dies nicht mitstart_image_url/end_image_url.
Asynchroner Callback
Da die Generierungszeit der Kling Videos Generation API relativ lang ist und etwa 1–2 Minuten dauert, würde die HTTP-Anfrage bei einer längeren Nichtreaktion der API die Verbindung dauerhaft offen halten, was zu zusätzlichem Verbrauch von Systemressourcen führt. Daher unterstützt diese API auch asynchrone Callbacks. Der gesamte Ablauf ist: Wenn der Client eine Anfrage startet, gibt er zusätzlich ein Feldcallback_url an. Nachdem der Client die API-Anfrage gestartet hat, gibt die API sofort ein Ergebnis zurück, das ein Feld task_id enthält, welches die ID der aktuellen Aufgabe darstellt. Nachdem die Aufgabe abgeschlossen ist, wird das Ergebnis des generierten Videos in Form von POST JSON an die vom Client angegebene callback_url gesendet, die ebenfalls das Feld task_id enthält, sodass die Aufgabenergebnisse über die ID zugeordnet werden können.
Im Folgenden erfahren wir anhand eines Beispiels, wie dies konkret funktioniert.
Zunächst ist der Webhook-Callback ein Dienst, der HTTP-Anfragen empfangen kann. Entwickler sollten ihn durch die URL eines selbst eingerichteten HTTP-Servers ersetzen. Zur einfachen Demonstration wird hier die öffentliche Webhook-Beispielwebsite https://webhook.site/ verwendet. Beim Öffnen dieser Website erhalten Sie eine Webhook-URL, wie in der Abbildung gezeigt:
Kopieren Sie diese URL, dann kann sie als Webhook verwendet werden. Das Beispiel hier ist https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3.
Als Nächstes können wir das Feld callback_url auf die obige Webhook-URL setzen und gleichzeitig die entsprechenden Parameter ausfüllen. Der konkrete Inhalt ist in der Abbildung dargestellt:

https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3 das Ergebnis des generierten Videos beobachten, wie in der Abbildung gezeigt:
Der Inhalt lautet wie folgt:
task_id enthält. Die anderen Felder ähneln denen oben, und über dieses Feld kann die Zuordnung der Aufgaben realisiert werden.
Fehlerbehandlung
Wenn beim Aufruf der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die entsprechende Information zurück. Zum Beispiel:400 token_mismatched: Bad request, possibly due to missing or invalid parameters.400 api_not_implemented: Bad request, possibly due to missing or invalid parameters.401 invalid_token: Unauthorized, invalid or missing authorization token.429 too_many_requests: Too many requests, you have exceeded the rate limit.500 api_error: Internal server error, something went wrong on the server.
Beispiel für Fehlerantworten
Fazit
Durch dieses Dokument haben Sie bereits verstanden, wie Sie die Kling Videos Generation API verwenden können, um durch die Eingabe von Prompt-Wörtern sowie einem Referenzbild des ersten Frames Videos zu generieren. Wir hoffen, dass dieses Dokument Ihnen helfen kann, diese API besser anzubinden und zu verwenden. Falls Sie Fragen haben, kontaktieren Sie jederzeit unser technisches Support-Team.Kling 3.0 Turbo
model="kling-v3-turbo" unterstützt Text-zu-Video und Bild-zu-Video mit erstem Frame, mit einer Dauer von ganzzahligen 3–15 Sekunden. mode="std" gibt 720p aus, mode="pro" gibt 1080p aus. Dieses Modell verfügt über natives Audio und bietet keinen Schalter zum Deaktivieren; lassen Sie generate_audio weg oder setzen Sie es auf true. Dieses Modell unterstützt keinen Endframe, keine Kamerafahrtsobjekte, keine eigenständigen negativen Prompts oder cfg_scale. Beschreiben Sie im prompt direkt die Inhalte, die benötigt werden oder deren Auftreten vermieden werden soll.
Videos mit mehreren Szenen
kling-v3 und kling-v3-omni unterstützen multi_shot=true. shot_type="intelligence" erstellt basierend auf dem prompt automatisch ein Storyboard; shot_type="customize" stellt über multi_prompt 1–6 Storyboards bereit, wobei jeder Eintrag einen bei 1 fortlaufend ansteigenden index, einen prompt mit maximal 512 Zeichen und eine ganzzahlige duration von mindestens 1 Sekunde enthält. Die Summe der Dauer aller Storyboards muss der gesamten duration entsprechen. Benutzerdefinierte Storyboards verwenden keinen globalen prompt. Mehrszenenvideos werden entsprechend dem ausgewählten Modell, der Bildqualität, der Audiokonfiguration und der Gesamtdauer abgerechnet.
