Kling Tasks API Integration and Usage

Die Hauptfunktion der Kling Tasks API besteht darin, den Status der Ausführung eines Auftrags abzufragen, indem die Auftrags-ID eingegeben wird, die über die Kling Videos Generation API generiert wurde. Dieses Dokument wird die Integrationsanleitung der Kling Tasks API detailliert beschreiben, um Ihnen zu helfen, diese API einfach zu integrieren und ihre leistungsstarken Funktionen voll auszuschöpfen. Mit der Kling Tasks API können Sie den Status der Ausführung von Aufträgen der Kling Videos Generation API problemlos abfragen.

Antragsprozess

Um die Kling Videos Generation API zu nutzen, müssen Sie zunächst Ihr API-Token im Ace Data Cloud Dashboard abrufen und für zukünftige Verwendung aufbewahren.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie zur Registrierung und Anmeldung eingeladen werden. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, ohne dass für jeden Dienst separat ein Antrag gestellt werden muss. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um die Dienste kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.

📘 Vollständige Dokumentation: Kling Videos Generation API →

Anfragebeispiel

Die Kling Tasks API kann verwendet werden, um die Ergebnisse der Kling Videos Generation API abzufragen. Informationen zur Verwendung der Kling Videos Generation API finden Sie in der Dokumentation Kling Videos Generation API. Wir nehmen als Beispiel eine von der Kling Videos Generation API zurückgegebene Auftrags-ID und demonstrieren, wie man diese API verwendet. Angenommen, wir haben eine Auftrags-ID: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, im Folgenden zeigen wir, wie man durch Eingabe einer Auftrags-ID vorgeht.

Beispielbild des Auftrags

Anfrageheader und Anfragekörper festlegen

Request Headers umfassen:

accept: Gibt an, dass die Antwort im JSON-Format empfangen werden soll, hier eingetragen als application/json.
authorization: Der Schlüssel zum Aufrufen der API, nach der Beantragung kann dieser direkt ausgewählt werden.

Request Body umfasst:

id: Die hochgeladene Auftrags-ID.
action: Die Art der Operation auf dem Auftrag.

Einstellung wie im folgenden Bild gezeigt:

Codebeispiel

Es ist zu erkennen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie im Bild gezeigt:

Einige Codebeispiele sind wie folgt:

CURL

curl -X POST 'https://api.acedata.cloud/kling/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/kling/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die Detailinformationen zu diesem Videoauftrag zurück. Zum Beispiel:

{
  "_id": "67c5163f550a4144a5b68698",
  "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
  "api_id": "29187cb2-1acb-43b8-baf5-3f3f709292eb",
  "application_id": "f35762fe-e8a4-4613-bb70-e5c1be4f9fc2",
  "created_at": 1740969535.333,
  "started_at": 1740969535.393,
  "finished_at": 1740969852.463,
  "elapsed": 317.07,
  "credential_id": "ce81345f-7e2a-4871-b539-aefb5f725220",
  "request": {
    "action": "text2video",
    "model": "kling-v1",
    "prompt": "Weißer Keramikkaffeebecher auf glänzendem Marmorarbeitsplatz mit Morgenlicht durch das Fenster. Die Kamera dreht sich langsam 360 Grad um den Becher und hält kurz am Griff an.",
    "callback_url": "https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3"
  },
  "trace_id": "0a907f69-4ae2-4a08-b34c-ee15c1c47077",
  "type": "videos",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "job_id": "CjJzzGfBfqcAAAAAAKdVMQ",
  "response": {
    "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"
  }
}

Die Rückgabe enthält mehrere Felder, das Feld request ist der request body, der beim Starten des Auftrags gesendet wurde, während das Feld response die Antwort des Auftrags nach dessen Abschluss darstellt. Die Feldbeschreibung ist wie folgt.

id, die ID des generierten Videoauftrags, die zur eindeutigen Identifizierung dieses Videoerstellungsauftrags dient.
request, Informationen zur Anfrage im Videoauftrag.
response, Informationen zur Antwort im Videoauftrag.
created_at, Erstellungszeit des Auftrags, Unix-Zeitstempel (Sekunden, Fließkomma).
started_at, Beginn der Ausführung des Auftrags, Unix-Zeitstempel (Sekunden, Fließkomma).
finished_at, Abschlusszeit des Auftrags, Unix-Zeitstempel (Sekunden, Fließkomma). Dieses Feld wird nicht zurückgegeben, wenn der Auftrag nicht abgeschlossen ist.
elapsed, die für die Ausführung des Auftrags benötigte Zeit, gemessen in Sekunden (Fließkomma, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn der Auftrag nicht abgeschlossen ist.

Batch-Abfrageoperation

Dies ist eine Abfrage von Videoauftragsdetails für mehrere Auftrags-IDs. Im Gegensatz zu oben muss die Aktion auf retrieve_batch gesetzt werden. Request Body umfasst:

ids: Array der hochgeladenen Auftrags-IDs.
action: Die Art der Operation auf dem Auftrag.

Einstellung wie im folgenden Bild gezeigt:

Codebeispiel

Es ist zu erkennen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie im Bild gezeigt:

Einige Codebeispiele sind wie folgt:

Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die spezifischen Detailinformationen zu allen Batch-Videoaufträgen zurück. Zum Beispiel:

{
  "items": [
    {
      "_id": "67c5163f550a4144a5b68698",
      "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
      "api_id": "29187cb2-1acb-43b8-baf5-3f3f709292eb",
      "application_id": "f35762fe-e8a4-4613-bb70-e5c1be4f9fc2",
      "created_at": 1740969535.333,
      "started_at": 1740969535.393,
      "finished_at": 1740969852.463,
      "elapsed": 317.07,
      "credential_id": "ce81345f-7e2a-4871-b539-aefb5f725220",
      "request": {
        "action": "text2video",
        "model": "kling-v1",
        "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.",
        "callback_url": "https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3"
      },
      "trace_id": "0a907f69-4ae2-4a08-b34c-ee15c1c47077",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "CjJzzGfBfqcAAAAAAKdVMQ",
      "response": {
        "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"
      }
    },
    {
      "_id": "67c51415550a4144a5b442a5",
      "id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0",
      "api_id": "29187cb2-1acb-43b8-baf5-3f3f709292eb",
      "application_id": "f35762fe-e8a4-4613-bb70-e5c1be4f9fc2",
      "created_at": 1740968981.619,
      "started_at": 1740968981.679,
      "finished_at": 1740969297.937,
      "elapsed": 316.258,
      "credential_id": "ce81345f-7e2a-4871-b539-aefb5f725220",
      "request": {
        "action": "text2video",
        "model": "kling-v1",
        "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."
      },
      "trace_id": "4f32ba2d-8846-4ea9-9253-997ec0b2e052",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "Cjil4mfBfs0AAAAAAKbMQQ",
      "response": {
        "success": true,
        "video_id": "af9a1af0-9aa0-4638-81c1-d41d6143c508",
        "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
        "duration": "5.1",
        "state": "succeed",
        "task_id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0"
      }
    }
  ],
  "count": 2
}

返回结果一共有多个字段，其中items是包含了批量视频任务的具体详情信息，每个视频任务的具体信息与上文的字段一样，字段信息如下。

items，批量视频任务 der alle spezifischen Detailinformationen. Es ist ein Array, wobei jedes Element des Arrays das gleiche Format wie das oben angegebene Ergebnis für eine einzelne Abfrage hat.
count，此处批量查询视频任务的个数。

CURL

curl -X POST 'https://api.acedata.cloud/kling/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["e3a575aa-a4bd-49c8-9b12-cde38d5462e0","20068983-0cc9-4c6a-aeb6-9c6a3c668be0"],
  "action": "retrieve_batch"
}'

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

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：Nicht autorisiert, ungültiger oder fehlender Autorisierungstoken.
429 too_many_requests：Zu viele Anfragen, Sie haben das Rate-Limit überschritten.
500 api_error：Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

错误响应示例

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

结论

通过本文档，您已经了解了如何使用 Kling Tasks API 进行查询单个或批量视频任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Proxy

Erweitert

Coding

Kling Tasks API Integration and Usage

Antragsprozess

Anfragebeispiel

Beispielbild des Auftrags

Anfrageheader und Anfragekörper festlegen

Codebeispiel

CURL

Python

Antwortbeispiel

Batch-Abfrageoperation

Codebeispiel

Antwortbeispiel

CURL

错误处理

错误响应示例

结论

​Antragsprozess

​Anfragebeispiel

​Beispielbild des Auftrags

​Anfrageheader und Anfragekörper festlegen

​Codebeispiel

​CURL

​Python

​Antwortbeispiel

​Batch-Abfrageoperation

​Codebeispiel

​Antwortbeispiel

​CURL

​错误处理

​错误响应示例

​结论

Antragsprozess

Anfragebeispiel

Beispielbild des Auftrags

Anfrageheader und Anfragekörper festlegen

Codebeispiel

CURL

Python

Antwortbeispiel

Batch-Abfrageoperation

Codebeispiel

Antwortbeispiel

CURL

错误处理

错误响应示例

结论