Kling 2.6 Asynchrone Video-Generierung

API-Dokumentation

Verwenden Sie diese Endpunkte, um Kling 2.6 Jobs einzureichen und deren Status zu überprüfen. Jeder Aufruf verbraucht Kredite basierend auf Dauer und Audio.

Authentifizierung

Alle Anfragen müssen Ihren API-Schlüssel im Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Fehlende oder ungültige Schlüssel geben 401 Unauthorized.

POST

https://kling26ai.org/api/generate

Generierungsaufgabe erstellen

Reicht einen neuen Kling 2.6 Job ein. Der Aufruf gibt sofort eine task_id zurück, während das Rendern **asynchron** abgeschlossen wird.

Parameter	Typ	Erforderlich	Beschreibung
prompt	string (max 1000 chars)	Ja	Beschreibung der Hauptszene (Text oder Image-Flow).
aspect_ratio	string	Ja	Unterstützt: 16:9, 9:16, 1:1. Wird ignoriert, wenn image_urls vorhanden ist.
duration	string	Ja	Render-Länge in Sekunden ("5" oder "10").
sound	boolean	Nein	Audio in den Clip einschließen (Kosten verdoppeln sich).
image_urls	string[]	Nein	Optionale URLs von Referenzbildern (erforderlich für Image-to-Video).

Kreditverbrauch

Kredite werden bei der Erstellung der Aufgabe abgezogen. Fehlgeschlagene Jobs werden automatisch **erstattet**.

Voreinstellung	Abgezogene Kredite
5 s ohne Ton	65
10 s ohne Ton	130
5 s mit Ton	130
10 s mit Ton	260

Beispielanfrage

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n29b6d54c8f4b4c4e8kling"
  }
}

GET / POST

https://kling26ai.org/api/status

Aufgabenstatus überprüfen

Verwenden Sie diesen Endpunkt, um den neuesten Datensatz abzufragen. Wenn sich die Aufgabe noch im Status IN_PROGRESS befindet, fragen wir den Anbieter einmal zusätzlich ab, bevor wir antworten.

Parameter	Typ	Erforderlich	Beschreibung
task_id	string	Ja	ID, zurückgegeben von /generate. Senden Sie diese über Query-Parameter (?task_id=) oder den JSON-Body.

Feld	Beschreibung
task_id	Von /generate zurückgegebene ID.
status	SUCCESS (ERFOLG)
request	Bereinigte Kopie der eingereichten Payload.
response	Array von Medien-URLs, wenn der Status SUCCESS ist.
consumed_credits	Für die Aufgabe berechnete Kredite (0 bei Rückerstattung).
error_message	Anbieterfehler, wenn der Status FAILED ist.
created_at	UTC-Zeitstempel, wann der Job gespeichert wurde.

Beispielanfrage

GET https://kling26ai.org/api/status?task_id=n29b6d54c8f4b4c4e8kling
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://kling26ai.org/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n29b6d54c8f4b4c4e8kling"
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n29b6d54c8f4b4c4e8kling",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/kling26/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Fehlerbehandlung

401 Unauthorized - Fehlender oder ungültiger API-Schlüssel.
402 Payment Required - Das Kreditguthaben konnte die Abbuchung nicht decken.
429 Too Many Requests - Reduzieren Sie die Abfragefrequenz oder die Anfragerate.
500 - Vorübergehendes Problem; versuchen Sie es mit exponentiellem Backoff erneut.