Kling Videos Generation API Integrationsanleitung

​

Antragsprozess

📘 Vollständige Dokumentation: Kling Videos Generation API →

​

Grundlegende Nutzung

• 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-Nutzung, den Sie nach der Beantragung direkt auswählen können.

• model: Das Modell zur Videoerzeugung, 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 Videoerzeugung, wählbare Werte sind Standardmodus std, Hochgeschwindigkeitsmodus pro und nativer 4K-Modus 4k. Dabei unterstützt 4k 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 das Endbild anzugeben.
• duration: Die Videolänge in Sekunden. kling-v3 und kling-v3-omni unterstützen eine Ganzzahl 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 Gegenworte, 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 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 die Ergebnisse können dann über die entsprechende Aufgabenabfrage-Schnittstelle abgerufen werden.

{
  "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"
}

• 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.

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 Marmorarbeitsplatz mit Morgenlicht vom Fenster. Die Kamera dreht sich langsam 360 Grad um den Becher und hält kurz am Griff an."
}'

​

Modellfähigkeitsmatrix

• 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

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

Hinweis: Die video_id hier ist 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.

• 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 Sie die Bild-zu-Video-Aktion image2video auswählen, müssen Sie den Link zum Referenzbild des ersten Frames hochladen.
• prompt: Eingabeaufforderung.

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)

{
  "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"
}

​

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

Sicherheitshinweis: Die aktuelle API öffnet element_list nicht. Die IDs der Kling Element Library gehören dem Namensraum des Anbieterkontos. Vor der Bereitstellung einer isolierten Element Management API sollten Kunden image_list verwenden, um Hauptreferenzbilder zu übergeben.

​

Referenzvideo und Video-Editing (video_list)

• video_url: Referenzvideolink, darf nicht leer sein. Anforderungen: Format MP4/MOV; Auflösung 720px–2160px; Dauer 3–10 Sekunden; Bildrate 24–60fps; Dateigröße ≤200MB; maximal 1 Video.
• 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. können geändert werden) oder feature (Merkmalsreferenz, Bezug auf Stil / Kameraführung / Fortsetzung der nächsten Szene).
• 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.

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"
    }
  ]
}'

​

Mehrere Bildreferenzen (image_list)

• 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).

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 &lt;&lt;<image_N>>> beeinflussen kann. Es wird empfohlen, sich für eines zu entscheiden: Wenn Start- / Endbilder benötigt werden, direkt in image_list mit type angeben, nicht mit start_image_url / end_image_url mischen.

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 Figuren in <<<image_1>>> in der Szene von <<<image_2>>> stehen, filmreifes Licht",
  "image_list": [
    { "image_url": "https://cdn.acedata.cloud/subject.png" },
    { "image_url": "https://cdn.acedata.cloud/scene.png" }
  ]
}'

​

Asynchrone Rückrufe

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

{
    "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"
}

​

Fehlerbehandlung

• 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 Fehlerantworten

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

​

Schlussfolgerung