Zum Hauptinhalt springen
GET
/
kling
/
v1
/
{action}
/
{action2}
/
{task_id}
Individual queries
curl --request GET \
  --url https://api.cometapi.com/kling/v1/{action}/{action2}/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_info": {
      "parent_video": {
        "id": "<string>",
        "url": "<string>",
        "duration": "<string>"
      }
    },
    "task_result": {
      "videos": [
        {
          "id": "<string>",
          "url": "<string>",
          "duration": "<string>"
        }
      ]
    },
    "created_at": 123,
    "updated_at": 123
  }
}
Verwenden Sie diese Endpoint-Familie, nachdem Sie eine Kling-Aufgabe erstellt haben. Sie ist der übliche Polling-Schritt für asynchrone Kling-Media-Jobs.

Was Sie zuerst prüfen sollten

  • Vom Wrapper zurückgegebene Felder für Aufgabenstatus oder Aufgabenfortschritt
  • Output-Metadaten oder Asset-URLs, wenn die Aufgabe abgeschlossen ist
  • Anbieterspezifische Fehlermeldungen, wenn eine Aufgabe vorzeitig stoppt

Polling-Muster

1

Erstellen Sie die Aufgabe über den passenden Endpoint

Beginnen Sie mit der Kling-Erstellungsseite für Ihren Workflow, z. B. Text to Video oder Image to Video.
2

Führen Sie Polling durch, bis die Aufgabe einen Endstatus erreicht

Fragen Sie mit der zurückgegebenen task id weiter ab, bis der Status success oder failure erreicht.
3

Fahren Sie mit dem nächsten Workflow-Schritt fort

Verwenden Sie den fertigen Output direkt oder wechseln Sie zur nächsten anbieterspezifischen Aktionsseite, wenn Ihr Workflow verkettete Operationen unterstützt.
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Pfadparameter

action
string
erforderlich

Resource type. One of: images, videos, audio.

action2
string
erforderlich

Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

task_id
string
erforderlich

Task ID

Antwort

200 - application/json

Successful Response

code
integer
erforderlich

Return code

message
string
erforderlich

Text description of the request result

request_id
string
erforderlich

Unique identifier for this request

data
object
erforderlich

Object containing specific response data