Integration und Verwendung der Kling Tasks API

Die Hauptfunktion der Kling Tasks API besteht darin, den Ausführungsstatus einer Aufgabe durch Eingabe der von der Kling Videos Generation API generierten Aufgaben-ID abzufragen. Dieses Dokument stellt die Integrationsanleitung der Kling Tasks API detailliert vor und hilft Ihnen, diese API einfach zu integrieren und ihre leistungsstarken Funktionen vollständig zu nutzen. Über die Kling Tasks API können Sie einfach den Ausführungsstatus von Aufgaben der Kling Videos Generation API abfragen.

Antragsprozess

Um die Kling Videos Generation API zu verwenden, rufen Sie zunächst Ihren API-Token in der Ace Data Cloud-Konsole ab und bewahren Sie ihn zur späteren Verwendung auf.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie zur Registrierung und Anmeldung eingeladen werden. Nach Abschluss kehren Sie automatisch zur aktuellen Seite zurück. Ein API-Token kann alle Dienste der Plattform aufrufen, ohne dass Sie ihn für jeden Dienst separat beantragen müssen. Bei der ersten Beantragung erhalten Sie ein kostenloses Guthaben, um den Dienst kostenlos zu testen; bei unzureichendem Guthaben können Sie Ihr allgemeines Guthaben in der Konsole 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. Wie Sie die Kling Videos Generation API verwenden, erfahren Sie in der Dokumentation Kling Videos Generation API 。 Wir verwenden eine von der Kling Videos Generation API zurückgegebene Aufgaben-ID als Beispiel, um zu demonstrieren, wie diese API verwendet wird. Angenommen, wir haben eine Aufgaben-ID: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0. Im Folgenden wird demonstriert, wie durch Übergabe einer Aufgaben-ID vorgegangen wird.

Beispielabbildung einer Aufgabe

Anfrage-Header und Anfrage-Body festlegen

Request Headers umfassen:

accept: Gibt an, dass Antwortergebnisse im JSON-Format empfangen werden sollen; hier wird application/json eingetragen.
authorization: Der Schlüssel zum Aufrufen der API, der nach der Beantragung direkt über die Auswahlliste ausgewählt werden kann.

Request Body umfasst:

id: Die hochgeladene Aufgaben-ID.
action: Die Operationsmethode für die Aufgabe.

Die Einstellungen sind in der folgenden Abbildung dargestellt:

Codebeispiel

Sie können feststellen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie in der Abbildung 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 detaillierte Informationen zur Videoaufgabe hier 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": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle.",
    "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://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
    "duration": "5.1",
    "state": "succeed",
    "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
  }
}

Das zurückgegebene Ergebnis enthält mehrere Felder. Das Feld request ist der Request Body beim Starten der Aufgabe, während das Feld response der nach Abschluss der Aufgabe zurückgegebene Response Body ist. Die Feldbeschreibungen sind wie folgt.

id: Die ID zur Generierung dieser Videoaufgabe, die zur eindeutigen Kennzeichnung dieser Videogenerierungsaufgabe verwendet wird.
request: Die Anfrageinformationen in der Abfrage der Videoaufgabe.
response: Die Rückgabeinformationen in der Abfrage der Videoaufgabe.
created_at: Zeitpunkt der Aufgabenerstellung, Unix-Zeitstempel (Sekunden, Gleitkommazahl).
started_at: Zeitpunkt des Ausführungsbeginns der Aufgabe, Unix-Zeitstempel (Sekunden, Gleitkommazahl).
finished_at: Zeitpunkt des Aufgabenabschlusses, Unix-Zeitstempel (Sekunden, Gleitkommazahl). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist.
elapsed: Ausführungsdauer der Aufgabe, in Sekunden (Gleitkommazahl, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist.

Batch-Abfrageoperation

Dies dient zur Abfrage von Details zu Videoaufgaben für mehrere Aufgaben-IDs. Im Unterschied zu oben muss action auf retrieve_batch ausgewählt werden. Request Body umfasst:

ids: Das Array der hochgeladenen Aufgaben-IDs.
action: Die Operationsmethode für die Aufgabe.

Die Einstellungen sind in der folgenden Abbildung dargestellt:

Codebeispiel

Sie können feststellen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie in der Abbildung gezeigt:

Einige Codebeispiele sind wie folgt:

Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API detaillierte Informationen zu allen Videoaufgaben dieses Batchs 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ße Kaffeetasse aus Keramik auf glänzender Marmorarbeitsplatte mit morgendlichem Fensterlicht. Die Kamera dreht sich langsam um 360 Grad um die Tasse und hält kurz am Henkel 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://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.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ße Kaffeetasse aus Keramik auf glänzender Marmorarbeitsplatte mit morgendlichem Fensterlicht. Die Kamera dreht sich langsam um 360 Grad um die Tasse und hält kurz am Henkel 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://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
        "duration": "5.1",
        "state": "succeed",
        "task_id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0"
      }
    }
  ],
  "count": 2
}

Das Rückgabeergebnis enthält mehrere Felder, wobei items die detaillierten Informationen zu den Videoaufgaben im Stapel enthält. Die detaillierten Informationen zu jeder Videoaufgabe entsprechen den oben genannten Feldern. Die Feldinformationen lauten wie folgt.

items, alle detaillierten Informationen zu den Videoaufgaben im Stapel. Es ist ein Array, und die Elemente jedes Arrays haben dasselbe Format wie das Rückgabeergebnis der obigen Abfrage einer einzelnen Aufgabe.
count, die Anzahl der hier abgefragten Videoaufgaben im Stapel.

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

Fehlerbehandlung

Wenn beim Aufrufen der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die entsprechende Information zurück. Zum Beispiel:

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ültiges oder fehlendes Autorisierungstoken.
429 too_many_requests: Zu viele Anfragen, Sie haben das Ratenlimit überschritten.
500 api_error: Interner Serverfehler, auf dem Server ist etwas schiefgelaufen.

Beispiel für eine Fehlerantwort

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

Fazit

Durch dieses Dokument haben Sie bereits erfahren, wie Sie die Kling Tasks API verwenden, um alle detaillierten Informationen zu einzelnen oder stapelweisen Videoaufgaben abzufragen. Wir hoffen, dass dieses Dokument Ihnen dabei helfen kann, diese API besser anzubinden und zu verwenden. Wenn Sie Fragen haben, kontaktieren Sie bitte jederzeit unser technisches Supportteam.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Coding

Weitere Anleitungen

Integration und Verwendung der Kling Tasks API

Antragsprozess

Anfragebeispiel

Beispielabbildung einer Aufgabe

Anfrage-Header und Anfrage-Body festlegen

Codebeispiel

CURL

Python

Antwortbeispiel

Batch-Abfrageoperation

Codebeispiel

Antwortbeispiel

CURL

Fehlerbehandlung

Beispiel für eine Fehlerantwort

Fazit

​Antragsprozess

​Anfragebeispiel

​Beispielabbildung einer Aufgabe

​Anfrage-Header und Anfrage-Body festlegen

​Codebeispiel

​CURL

​Python

​Antwortbeispiel

​Batch-Abfrageoperation

​Codebeispiel

​Antwortbeispiel

​CURL

​Fehlerbehandlung

​Beispiel für eine Fehlerantwort

​Fazit

Antragsprozess

Anfragebeispiel

Beispielabbildung einer Aufgabe

Anfrage-Header und Anfrage-Body festlegen

Codebeispiel

CURL

Python

Antwortbeispiel

Batch-Abfrageoperation

Codebeispiel

Antwortbeispiel

CURL

Fehlerbehandlung

Beispiel für eine Fehlerantwort

Fazit