Kling 3.0 Turbo

curl --request POST \
  --url https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo

const options = {method: 'POST'};

fetch('https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

POST

kling

text-to-video

kling-3.0-turbo

Kling 3.0 Turbo

curl --request POST \
  --url https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo

const options = {method: 'POST'};

fetch('https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Parameter und Verwendung sind an die offizielle Dokumentation angeglichen; für detaillierte Parameter siehe direkt die offizielle Dokumentation.

1. Überblick

Dieses Dokument beschreibt, wie Sie über das offizielle Kling-3.0-Turbo-Protokoll die Funktionen Text-zu-Video und Bild-zu-Video verwenden. Turbo und Standard-Kling 3.0 verwenden dasselbe offizielle Protokoll; Anforderungs- und Antwortstruktur sind identisch, lediglich Funktionsumfang, Auflösungsstufen und Abrechnung unterscheiden sich. Beide Funktionen verwenden einen asynchronen Aufgabenmodus:

Rufen Sie den entsprechenden Erstellungs-Endpunkt auf.
Speichern Sie die data.id aus der Erstellungsantwort.
Fragen Sie den Aufgabenstatus mit demselben API-Schlüssel ab, der beim Erstellen der Aufgabe verwendet wurde.
Nach erfolgreicher Aufgabe rufen Sie das generierte Video aus outputs ab und speichern es.

1.1 Endpunktadressen

Funktion	Aufgabe erstellen	Aufgabe abfragen
Text-zu-Video	`POST /v3/kling/text-to-video/kling-3.0-turbo`	`GET /v3/kling/tasks`
Bild-zu-Video	`POST /v3/kling/image-to-video/kling-3.0-turbo`	`GET /v3/kling/tasks`

Die vollständige Adresse in den Beispielen dieses Dokuments ergibt sich aus https://{api_domain} plus dem in der Tabelle angegebenen Endpunktpfad, wobei {api_domain} Ihre genutzte API-Domain ist. Turbo bietet nur Text-zu-Video und Bild-zu-Video; Omni-Videos und Bewegungssteuerung werden nicht unterstützt.

1.2 Authentifizierung

Alle Anforderungen müssen einen API-Schlüssel enthalten. POST-Anforderungen müssen zusätzlich den JSON-Inhaltstyp angeben:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

1.3 Antwortstruktur

In der Erstellungsantwort ist data ein Objekt. Häufige Felder sind id (die von Kling generierte Aufgaben-ID für spätere Abfragen), external_id (die Widerspiegelung von options.external_task_id; kann ausbleiben, wenn nicht gesetzt) und status (der Status nach der Erstellung, normalerweise submitted). In der Abfrageantwort ist data ein Array. Jede Aufgabe enthält id, external_id, status (submitted, processing, succeeded oder failed), message, create_time, update_time und outputs. Häufige Felder der Videoergebnisse in outputs sind type, id, url, watermark_url und duration, wobei url das Ergebnis ohne Wasserzeichen, watermark_url das Ergebnis mit Wasserzeichen und duration die Videolänge in Sekunden ist.

2. Text-zu-Video

2.1 Aufgabe erstellen

POST https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo

Anforderungsfelder:

Feld	Typ	Erforderlich	Standardwert / Wertebereich	Beschreibung
`prompt`	string	Ja		Text-Prompt, kann positive und negative Beschreibungen enthalten; maximal 3072 Zeichen, empfohlen nicht mehr als 2500 Zeichen
`settings.resolution`	string	Nein	Standard `720p`; `720p`, `1080p`	Auflösung des generierten Videos
`settings.aspect_ratio`	string	Nein	Standard `16:9`; `16:9`, `9:16`, `1:1`	Seitenverhältnis (Breite:Höhe) des generierten Videos
`settings.duration`	int	Nein	Standard 5; Ganzzahl von 3–15	Dauer des generierten Videos in Sekunden
`options.callback_url`	string	Nein		Adresse, die bei Statusänderungen der Aufgabe Callback-Benachrichtigungen empfängt
`options.external_task_id`	string	Nein		Benutzerdefinierte Aufgaben-ID; überschreibt nicht die System-Aufgaben-ID, kann für Abfragen verwendet werden, muss unter einem Benutzer eindeutig sein
`options.watermark_info.enabled`	boolean	Nein	Standard `false`	Ob ein Ergebnis mit Wasserzeichen erzeugt werden soll

Multi-Shot-Videos werden über das feste Format im prompt umgesetzt: „镜头 n, m, words; 镜头 n, m, words;“ (mit halbbreiten Zeichen getrennt). Dabei ist n die Shot-Nummer (maximal 6, mindestens 1), m die Shot-Dauer (jede nicht kleiner als 1, die Summe aller Shot-Dauern entspricht der gesamten Videodauer), words der Shot-Prompt (maximal 512 Zeichen).

2.2 Erstellungsbeispiel

curl -X POST 'https://{api_domain}/v3/kling/text-to-video/kling-3.0-turbo' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A cinematic tracking shot of a red sports car driving along a coastal road at sunset",
    "settings": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "duration": 5
    },
    "options": {
      "external_task_id": "turbo-text-20260826-0001"
    }
  }'

Nach erfolgreicher Erstellung wird die Aufgaben-ID zurückgegeben:

{
  "code": 0,
  "message": "success",
  "request_id": "provider-request-id",
  "data": {
    "id": "kling-turbo-text-task-id",
    "external_id": "turbo-text-20260826-0001",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151
  }
}

Bitte speichern Sie data.id. Wenn options.external_task_id nicht übergeben wird, kann data.external_id ausbleiben.

2.3 Aufgabe abfragen

GET https://{api_domain}/v3/kling/tasks?task_ids={task_id}

Verwenden Sie denselben API-Schlüssel wie beim Erstellen der Aufgabe. Sie können external_task_ids auch zum Abfragen benutzerdefinierter Aufgaben-IDs verwenden. task_ids und external_task_ids dürfen pro Anfrage nur jeweils eines angeben; beide unterstützen 1–50 IDs, getrennt durch englische Kommas. data in der Antwort ist ein Array und behält die Reihenfolge der angeforderten IDs bei.

2.4 Abfragebeispiel

curl -X GET 'https://{api_domain}/v3/kling/tasks?task_ids=kling-turbo-text-task-id' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

Im Erfolgsfall wird Folgendes zurückgegeben:

{
  "code": 0,
  "message": "success",
  "request_id": "provider-request-id",
  "data": [
    {
      "id": "kling-turbo-text-task-id",
      "status": "succeeded",
      "outputs": [
        {
          "type": "video",
          "url": "https://your-result-cdn.example.com/turbo-text.mp4",
          "duration": 5
        }
      ]
    }
  ]
}

status=processing bedeutet, dass die Aufgabe noch ausgeführt wird; es wird empfohlen, alle 10–30 Sekunden abzufragen. status=failed bedeutet, dass die Aufgabe fehlgeschlagen ist; das Polling sollte nicht fortgesetzt werden. Bitte speichern Sie nach erfolgreicher Aufgabe umgehend die Datei unter outputs[type=video].url; die Download-URL kann ablaufen.

2.5 Hinweise zur Abrechnung

任务费用 = 对应分辨率的每秒单价 × settings.duration

Die Preisstufe wird ausschließlich durch settings.resolution (720p oder 1080p) bestimmt. Wird duration nicht übergeben, werden die Standard-5-Sekunden berechnet. Beim Erstellen der Aufgabe wird gemäß der angeforderten Dauer berechnet; schlägt die Aufgabenerstellung oder die endgültige Generierung fehl, wird der Betrag automatisch erstattet. Die genauen Einzelpreise entnehmen Sie der Preisübersicht des von Ihnen genutzten Dienstes.

3. Bild-zu-Video

3.1 Aufgabe erstellen

POST https://{api_domain}/v3/kling/image-to-video/kling-3.0-turbo

Anforderungsfelder:

Feld	Typ	Erforderlich	Standardwert / Wertebereich	Beschreibung
`contents`	array	Ja		Sammlung von Referenzmaterial, mindestens ein Element
`contents[].type`	string	Ja	`prompt`, `first_frame`	Materialtyp: Prompt, Erstbild
`contents[].text`	string	Nein		Text-Prompt bei `type=prompt`, maximal 2500 Zeichen
`contents[].url`	string	Nein		Erstbild bei `type=first_frame`, unterstützt URL oder Base64
`settings.resolution`	string	Nein	Standard `720p`; `720p`, `1080p`	Auflösung des generierten Videos
`settings.duration`	int	Nein	Standard 5; Ganzzahl von 3–15	Dauer des generierten Videos in Sekunden
`options.external_task_id`	string	Nein		Benutzerdefinierte Aufgaben-ID; überschreibt nicht die System-Aufgaben-ID, kann für Abfragen verwendet werden, muss unter einem Benutzer eindeutig sein
`options.watermark_info.enabled`	boolean	Nein	Standard `false`	Ob ein Ergebnis mit Wasserzeichen erzeugt werden soll

Bilder werden als .jpg, .jpeg und .png unterstützt, Dateien dürfen nicht größer als 50 MB sein, Breite und Höhe nicht kleiner als 300 Pixel, und das Seitenverhältnis muss zwischen 1:2,5 und 2,5:1 liegen. Bild-zu-Video unterstützt nur das erste Bild; „erstes Bild + letztes Bild“ und „nur letztes Bild“ werden derzeit nicht unterstützt. options.callback_url kann ebenfalls übergeben werden; die Verwendung ist wie bei Text-zu-Video. Multi-Shot wird ebenfalls über das feste Format im prompt umgesetzt.

3.2 Erstellungsbeispiel

curl -X POST 'https://{api_domain}/v3/kling/image-to-video/kling-3.0-turbo' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "The subject turns toward the camera while the wind moves naturally through the scene"
      },
      {
        "type": "first_frame",
        "url": "https://your-cdn.example.com/first-frame.png"
      }
    ],
    "settings": {
      "resolution": "1080p",
      "duration": 5
    },
    "options": {
      "external_task_id": "turbo-image-20260826-0001"
    }
  }'

Im Erfolgsfall wird Folgendes zurückgegeben:

{
  "code": 0,
  "message": "success",
  "request_id": "provider-request-id",
  "data": {
    "id": "kling-turbo-image-task-id",
    "external_id": "turbo-image-20260826-0001",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151
  }
}

3.3 Aufgabe abfragen

Verwenden Sie die data.id aus der Erstellungsantwort, um die Aufgabe abzufragen:

GET https://{api_domain}/v3/kling/tasks?task_ids={task_id}

Verwenden Sie bei einer Abfrage über task_ids denselben API-Schlüssel wie beim Erstellen der Aufgabe. Sie können auch über external_task_ids die beim Erstellen übergebene options.external_task_id abfragen. Der Abfrageparameter unterstützt 1–50 durch englische Kommas getrennte IDs.

3.4 Abfragebeispiel

curl -X GET 'https://{api_domain}/v3/kling/tasks?task_ids=kling-turbo-image-task-id' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

Im Erfolgsfall befindet sich die Video-URL unter outputs[type=video].url:

{
  "code": 0,
  "message": "success",
  "request_id": "provider-request-id",
  "data": [
    {
      "id": "kling-turbo-image-task-id",
      "status": "succeeded",
      "outputs": [
        {
          "type": "video",
          "url": "https://your-result-cdn.example.com/turbo-image.mp4",
          "duration": 5
        }
      ]
    }
  ]
}

Bei status=processing wird empfohlen, alle 10–30 Sekunden weiter abzufragen; bei status=failed das Polling beenden und die Eingaben anhand der Fehlermeldung korrigieren.

3.5 Hinweise zur Abrechnung

任务费用 = 对应分辨率的每秒单价 × settings.duration

4. Häufige Fehler und Hinweise

Schnittstellenfehler verwenden die folgende Struktur:

{
  "code": 1203,
  "message": "task not found (trace_id: platform-trace-id)",
  "request_id": "",
  "data": null
}

Häufige Statuscodes: 400/1200 (Parameter oder Inhaltstyp ungültig, laut message korrigieren), 401/1000 (API-Schlüssel fehlt oder ungültig), 403/1103 (keine Berechtigung zur Ausführung), 404/1203 (Aufgabe nicht vorhanden oder keine Berechtigung zur Abfrage), 429/1302 (zu viele Anfragen, Frequenz reduzieren und exponentiellen Backoff anwenden), 500/5000, 503/5001, 504/5002 (Dienstfehler oder Zeitüberschreitung, später erneut versuchen und unkontrollierte Wiederholungen vermeiden). Wenn message eine trace_id enthält, geben Sie diese bei der Kontaktaufnahme mit dem Support mit an. Weitere Hinweise:

Der Anforderungstext muss kein model oder model_name enthalten; die Modellversion ist bereits in der URL enthalten.
Nach dem Erstellen der Aufgabe müssen Sie data.id persistieren; verwenden Sie nicht request_id als Aufgaben-ID.
Der Anforderungstext ist auf maximal 64 MB begrenzt; für größere Bilder wird empfohlen, eine öffentlich zugängliche Internet-URL zu verwenden, auf die Kling zugreifen kann.
Eingabe-Medien-URLs müssen für Kling öffentlich zugänglich sein; sie dürfen nicht von internen Netzwerken, Cookies oder temporären Login-Zuständen abhängen.
Verwenden Sie für Abfragen ein Polling-Intervall von 10–30 Sekunden und legen Sie ein Gesamt-Timeout sowie exponentiellen Backoff fest.
Ein POST-Timeout bedeutet nicht zwangsläufig, dass die Aufgabe nicht erstellt wurde; fragen Sie zuerst über external_task_id ab, bevor Sie entscheiden, ob Sie erneut versuchen.
Nach Erhalt des Erfolgsstatus speichern Sie bitte sofort die Datei unter outputs[type=video].url; die Ergebnis-URL kann ablaufen.

5. Python-Aufrufbeispiel

Das folgende Beispiel verwendet die Standardbibliothek requests und zeigt Erstellung und Polling für Text-zu-Video. Für Bild-zu-Video müssen nur der Erstellungs-Endpunkt und der Anforderungstext ersetzt werden.

import os
import time

import requests


api_domain = os.environ["API_DOMAIN"]
api_key = os.environ["PLATFORM_API_KEY"]
headers = {
    "

Zuletzt geändert am 15. Oktober 2026

API-Grundlagen

Große Sprachmodelle

Bilder

Video

Audio

Kling 3.0 Turbo

1. Überblick

1.1 Endpunktadressen

1.2 Authentifizierung

1.3 Antwortstruktur

2. Text-zu-Video

2.1 Aufgabe erstellen

2.2 Erstellungsbeispiel

2.3 Aufgabe abfragen

2.4 Abfragebeispiel

2.5 Hinweise zur Abrechnung

3. Bild-zu-Video

3.1 Aufgabe erstellen

3.2 Erstellungsbeispiel

3.3 Aufgabe abfragen

3.4 Abfragebeispiel

3.5 Hinweise zur Abrechnung

4. Häufige Fehler und Hinweise

5. Python-Aufrufbeispiel

​1. Überblick

​1.1 Endpunktadressen

​1.2 Authentifizierung

​1.3 Antwortstruktur

​2. Text-zu-Video

​2.1 Aufgabe erstellen

​2.2 Erstellungsbeispiel

​2.3 Aufgabe abfragen

​2.4 Abfragebeispiel

​2.5 Hinweise zur Abrechnung

​3. Bild-zu-Video

​3.1 Aufgabe erstellen

​3.2 Erstellungsbeispiel

​3.3 Aufgabe abfragen

​3.4 Abfragebeispiel

​3.5 Hinweise zur Abrechnung

​4. Häufige Fehler und Hinweise

​5. Python-Aufrufbeispiel

1. Überblick

1.1 Endpunktadressen

1.2 Authentifizierung

1.3 Antwortstruktur

2. Text-zu-Video

2.1 Aufgabe erstellen

2.2 Erstellungsbeispiel

2.3 Aufgabe abfragen

2.4 Abfragebeispiel

2.5 Hinweise zur Abrechnung

3. Bild-zu-Video

3.1 Aufgabe erstellen

3.2 Erstellungsbeispiel

3.3 Aufgabe abfragen

3.4 Abfragebeispiel

3.5 Hinweise zur Abrechnung

4. Häufige Fehler und Hinweise

5. Python-Aufrufbeispiel