> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# Integration und Verwendung der Kling Tasks API
> Kling video generation API guide - Ace Data Cloud
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](https://platform.acedata.cloud/console/applications) 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](https://platform.acedata.cloud/console/coin) aufladen.
> 📘 Vollständige Dokumentation: [Kling Videos Generation API →](https://platform.acedata.cloud/documents/kling-videos)
## 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 ](https://platform.acedata.cloud/documents/kling-videos)。
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
```bash theme={null}
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
```python theme={null}
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:
```json theme={null}
{
"_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:
```json theme={null}
{
"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
```bash theme={null}
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
```json theme={null}
{
"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.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.