Integrering och användning av Kling Tasks API

Kling Tasks API:s huvudsakliga funktion är att fråga om körstatusen för en uppgift genom att ange uppgifts-ID:t som genererats av Kling Videos Generation API. Det här dokumentet kommer att beskriva integreringsanvisningarna för Kling Tasks API i detalj, för att hjälpa dig att enkelt integrera och fullt ut utnyttja API:ets kraftfulla funktioner. Med Kling Tasks API kan du enkelt fråga om uppgiftskörstatusen för Kling Videos Generation API.

Ansökningsprocess

För att använda Kling Videos Generation API, gå först till Ace Data Cloud-konsolen för att hämta din API Token och spara den för senare användning.

Om du ännu inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan för att registrera och logga in dig. När detta är klart återgår du automatiskt till den aktuella sidan. En API Token kan användas för att anropa alla tjänster på plattformen, utan att behöva ansöka separat för varje tjänst. Vid första ansökan får du en kostnadsfri kvot för att prova tjänsten gratis; om kvoten inte räcker till kan du fylla på det gemensamma saldot i konsolen.

📘 Fullständig dokumentation: Kling Videos Generation API →

Begäransexempel

Kling Tasks API kan användas för att fråga efter resultat från Kling Videos Generation API. För information om hur du använder Kling Videos Generation API, se dokumentationen Kling Videos Generation API . Vi använder ett uppgifts-ID som returneras av Kling Videos Generation API-tjänsten som exempel för att visa hur detta API används. Anta att vi har ett uppgifts-ID: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, nedan visas hur man genom att ange ett uppgifts-ID.

Bildexempel för uppgift

Ange begärandehuvuden och begärandetext

Request Headers omfattar:

accept: anger att JSON-formaterade svarsresultat ska tas emot, fyll i application/json här.
authorization: nyckeln för att anropa API:et, efter ansökan kan den väljas direkt från rullgardinsmenyn.

Request Body omfattar:

id: det uppladdade uppgifts-ID:t.
action: åtgärdstypen för uppgiften.

Inställningarna visas i bilden nedan:

Kodexempel

Det kan ses att kod för olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Några kodexempel är följande:

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)

Svarsexempel

Efter att begäran har lyckats returnerar API:et detaljerad information om videouppgiften här. Till exempel:

{
  "_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"
  }
}

Det returnerade resultatet har flera fält. Fältet request är request body när uppgiften startas, medan fältet response är response body som returneras efter att uppgiften har slutförts. Fälten beskrivs nedan.

id, ID:t för den genererade videouppgiften, används för att unikt identifiera denna videogenereringsuppgift.
request, information om begäran i videouppgiften som frågas efter.
response, information om svaret i videouppgiften som frågas efter.
created_at, tidpunkt då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at, tidpunkt då uppgiften började köras, Unix-tidsstämpel (sekunder, flyttal).
finished_at, tidpunkt då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte när uppgiften inte är slutförd.
elapsed, tidsåtgång för uppgiftskörningen, enheten är sekunder (flyttal, behåller 3 decimaler). Detta fält returneras inte när uppgiften inte är slutförd.

Batchfrågeåtgärd

Detta är för att fråga efter detaljer om videouppgifter för flera uppgifts-ID:n. Skillnaden från ovan är att action måste väljas som retrieve_batch Request Body omfattar:

ids: array med uppladdade uppgifts-ID:n.
action: åtgärdstypen för uppgiften.

Inställningarna visas i bilden nedan:

Kodexempel

Det kan ses att kod för olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Några kodexempel är följande:

Svarsexempel

Efter att begäran har lyckats returnerar API:et detaljerad information om alla batchvideouppgifter denna gång. Till exempel:

{
  "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": "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"
      }
    },
    {
      "_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": "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."
      },
      "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
}

Resultatet innehåller totalt flera fält, där items innehåller den specifika detaljinformationen för videouppgifter i batch. Den specifika informationen för varje videouppgift är densamma som fälten ovan, och fältinformationen är följande.

items, all specifik detaljinformation för videouppgifter i batch. Det är en array, och varje element i arrayen har samma format som returresultatet för frågan om en enskild uppgift ovan.
count, antalet videouppgifter som batchfrågas här.

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

Felhantering

Vid anrop av API:t kommer API:t, om ett fel uppstår, att returnera motsvarande felkod och information. Till exempel:

400 token_mismatched：Felaktig begäran, eventuellt på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented：Felaktig begäran, eventuellt på grund av saknade eller ogiltiga parametrar.
401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests：För många begäranden, du har överskridit hastighetsgränsen.
500 api_error：Internt serverfel, något gick fel på servern.

Exempel på felsvar

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

Slutsats

Genom detta dokument har du redan lärt dig hur du använder Kling Tasks API för att fråga efter all specifik detaljinformation för enskilda eller batchvisa videouppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera med och använda detta API. Om du har några frågor, kontakta gärna vårt tekniska supportteam när som helst.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Coding

Fler guider

Integrering och användning av Kling Tasks API

Ansökningsprocess

Begäransexempel

Bildexempel för uppgift

Ange begärandehuvuden och begärandetext

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeåtgärd

Kodexempel

Svarsexempel

CURL

Felhantering

Exempel på felsvar

Slutsats

​Ansökningsprocess

​Begäransexempel

​Bildexempel för uppgift

​Ange begärandehuvuden och begärandetext

​Kodexempel

​CURL

​Python

​Svarsexempel

​Batchfrågeåtgärd

​Kodexempel

​Svarsexempel

​CURL

​Felhantering

​Exempel på felsvar

​Slutsats

Ansökningsprocess

Begäransexempel

Bildexempel för uppgift

Ange begärandehuvuden och begärandetext

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeåtgärd

Kodexempel

Svarsexempel

CURL

Felhantering

Exempel på felsvar

Slutsats